admob 1.0.2

data/History.txt

@@ -0,0 +1,3 @@
+=== 1.0.0 / 2008-05-08
+
+* AdMob gem created

data/Manifest.txt

@@ -0,0 +1,5 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/admob.rb

data/README.txt

@@ -0,0 +1,71 @@
+= AdMob Ruby on Rails integration code
+
+* http://www.admob.com
+
+== DESCRIPTION:
+
+Enables easy integration of AdMob services (ads and/or analytics) into a RoR mobile site.
+
+== SYNOPSIS:
+
+=== Setting up
+
+* Get a publisher_id and/or analytics_id from http://www.admob.com/ and/or http://analytics.admob.com/ .
+* Add <tt>require "admob"</tt> to app/controllers/application.rb, or to any specific controller as needed.
+* Provide some or all default settings in your environment.rb . e.g. :
+ require 'admob'
+ AdMob::config do |c|
+   c.publisher_id = 'YOUR_PUBLISHER_ID'
+   c.analytics_id = 'YOUR_ANALYTICS_ID'
+   c.timeout = 1
+   c.encoding = 'UTF-8'
+   c.raise_exceptions = false
+ end
+* In a view, where you want an ad, place an ad request.
+* Note: You must provide your publisher_id and/or analytics_id in the default setting, or when you make the ad request (see below).
+
+=== Sample requests
+
+==== If you've configured a default publisher and/or analytics id
+
+ <%= AdMob::request(request, session.session_id) %>
+
+==== If you didn't configure a default publisher_id or want to override the configured default publisher_id
+
+ <%= AdMob::request(request, session.session_id, :publisher_id => "YOUR_PUBLISHER_ID") %>
+
+==== Request a test ad (happens by default when in test or development mode)
+
+ <%= AdMob::request(request, session.session_id, :test => true) %>
+
+==== Request an ad, providing demographic info and keywords
+
+ <%= AdMob::request(request, session.session_id, :publisher_id => "YOUR_PUBLISHER_ID", :dob => "19800229", :gender => "male", :postal_code => "90210", :keywords => 'ruby gem admob') %>
+
+==== Make an analytics request only
+
+ <%= AdMob::request(request, session.session_id, :ad_request => false) %>
+
+See the documentation for #AdMob::request for a list of all params that can be set for a request.
+
+== REQUIREMENTS:
+
+* An AdMob publisher_id and/or analytics_id (get them at http://www.admob.com)
+
+== INSTALL:
+
+<tt>sudo gem install admob</tt>
+
+== LICENSE:
+
+(The BSD License)
+
+Copyright (c) 2008, AdMob, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'hoe'
+require './lib/admob.rb'
+
+Hoe.new('admob', AdMob::GEM_VERSION) do |p|
+  p.rubyforge_name = 'admob'
+  p.summary = 'Enables easy integration of AdMob ads into a RoR mobile site.'
+  p.author = 'AdMob'
+  p.email = 'support@admob.com'
+  p.url = 'http://www.admob.com/'
+  p.description = 'Enables easy integration of AdMob ads into a RoR mobile site.'
+  p.developer('AdMob', 'support@admob.com')
+end

data/lib/admob.rb

@@ -0,0 +1,173 @@
+require 'net/http'
+require 'uri'
+require 'md5'  
+
+# Set up include path correctly
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+# This module encapsulates functionality (ad requests, analytics requests) provided by AdMob. See README.txt for usage.
+module AdMob
+  
+  GEM_VERSION = '1.0.2'
+
+  ENDPOINT = URI.parse('http://r.admob.com/ad_source.php')
+  PUBCODE_VERSION = '20080630-RUBY-924f7dd99e8828c2'
+  DEFAULT_TIMEOUT = 1.0
+
+  # Make an AdMob ad/analytics request. The first param is the request variable from Rails; the second is a unique session
+  # identifier. In general, requests should always be of the form <tt><%= AdMob::request(request, session.session_id, ...) %></tt>.
+  # Regardless of how many times AdMob::request is called, only one analytics call will be made per page load.
+  # The remaining params set optional features of the request. Params that can be set are:
+  #
+  # [<tt>:publisher_id</tt>] your admob publisher_id, a default can be set using <tt>AdMob::config {|c| c.publisher_id = "YOUR_PUBLISHER_ID"}</tt>
+  # [<tt>:analytics_id</tt>] your admob analytics_id, a default can be set using <tt>AdMob::config {|c| c.analytics_id = "YOUR_ANALYTICS_ID"}</tt>
+  # [<tt>:ad_request</tt>] whether to make an ad request, defaults to true
+  # [<tt>:analytics_request</tt>] whether to make an analytics request, defaults to true
+  # [<tt>:encoding</tt>] char encoding of the response, either "UTF-8" or "SJIS", defaults to UTF-8
+  # [<tt>:markup</tt>] your site's markup, e.g. "xhtml", "wml", "chtml"
+  # [<tt>:postal_code</tt>] postal code of the current user, e.g. "94401"
+  # [<tt>:area_code</tt>] area code of the current user, e.g. "415"
+  # [<tt>:coordinates</tt>] lat/long of the current user, comma separated, e.g. "37.563657,-122.324807"
+  # [<tt>:dob</tt>] date of birth of the current user, e.g. "19800229"
+  # [<tt>:gender</tt>] gender of the current user, e.g. "m" or "f"
+  # [<tt>:keywords</tt>] keywords, e.g. "ruby gem admob"
+  # [<tt>:search</tt>] searchwords (much more restrictive than keywords), e.g. "ruby gem admob"
+  # [<tt>:title</tt>] title of the page, e.g. "Home Page"
+  # [<tt>:event</tt>] the event you want to report to analytics, e.g. "reg_success"
+  # [<tt>:text_only</tt>] if set to true, don't return a banner ad for this request
+  # [<tt>:test</tt>] whether this should issue a test ad request, not a real one
+  # [<tt>:timeout</tt>] override the default timeout value for this ad request in seconds, e.g. 2
+  # [<tt>:raise_exceptions</tt>] whether to raise exceptions when something goes wrong (defaults to false); exceptions will all be instances of AdMob::Error; a default can be set using <tt>AdMob::config {|c| c.raise_exceptions = true}</tt>
+  def self.request(request, session_id, params = {})
+    # Guarantee that only one analytics call gets made per request
+    if request.env['admob_analytics_request_issued'] == true
+      params[:analytics_request] = false
+    end
+    
+    raise_exceptions = params[:raise_exceptions].nil? ? AdMob::Defaults.raise_exceptions : params[:raise_exceptions]
+    
+    # Build the post request
+    post_data = self.build_post_data(request, session_id, params)
+    if post_data.nil?
+      raise AdMob::Error.new("AdMob::request called as neither an ad nor an analytics request") if raise_exceptions
+      return ''
+    end
+    
+    # Send request
+    req = Net::HTTP::Post.new(ENDPOINT.path)
+    req.set_form_data(post_data)
+    conn = Net::HTTP.new(ENDPOINT.host, ENDPOINT.port)
+    timeout = params[:timeout] || AdMob::Defaults.timeout || DEFAULT_TIMEOUT
+    conn.read_timeout = timeout
+    conn.open_timeout = timeout
+    begin
+      response = conn.start {|http| http.request(req)}
+      contents = response.body     
+    rescue Timeout::Error => te
+      contents = %Q|<img src="http://t.admob.com/li.php/c.gif/#{post_data['s']}/1/#{timeout}/#{MD5.hexdigest(post_data['p'])}" alt="" width="1" height="1" />|
+      raise AdMob::Error.new("AdMob::request timed out; timeout was #{timeout}, elapsed time was #{Time.now.to_f - post_data['z']}") if raise_exceptions
+    rescue
+      raise AdMob::Error.new("AdMob::request encountered unexpected exception #{$!}") if raise_exceptions
+    ensure
+      contents ||= ''
+    end
+
+    # If appropriate, add the analytics pixel
+    if post_data['rt'] > 0
+      contents << %Q|<img src="http://a.admob.com/e0?a=#{post_data['a']}&amp;s=#{post_data['s']}&amp;z=#{post_data['z']}&amp;lt=#{Time.now.to_f - post_data['z']}&amp;rt=#{post_data['rt']}" alt="" width="1" height="1"/>|
+    end
+    
+    contents
+  end
+
+  # Provides access to AdMob config, used for setting default request info.
+  # Currently, can be used to set defaults for: publisher_id, analytics_id, ad encoding, request timeout,
+  # and whether exceptions are raised when something goes wrong.
+  # For example, in environment.rb:
+  #  require 'admob'
+  #  AdMob::config do |c|
+  #    c.publisher_id = 'YOUR_DEFAULT_PUBLISHER_ID'
+  #    c.analytics_id = 'YOUR_DEFAULT_ANALYTICS_ID'
+  #    c.encoding = 'SJIS'
+  #    c.timeout = 3
+  #    c.raise_exceptions = true
+  #  end
+  def self.config
+    yield AdMob::Defaults
+  end
+
+  # Simple exception class used for all AdMob exceptions. By default, exceptions are never raised.
+  # To enable raising of exceptions, set parameter :raise_exceptions => true for a request, or
+  # set a default using AdMob::config (see AdMob::config documentation).
+  class Error < StandardError
+  end
+
+private
+
+  # Stores default values for AdMob requests. Set these defaults via AdMob::config.
+  class Defaults
+    class << self
+      attr_accessor :publisher_id, :analytics_id, :encoding, :timeout, :raise_exceptions
+    end
+  end
+
+  def self.build_post_data(request, session_id, params)
+    # Gather basic data
+    publisher_id = params[:publisher_id] || AdMob::Defaults.publisher_id
+    analytics_id = params[:analytics_id] || AdMob::Defaults.analytics_id
+    test = params[:test].nil? ? (RAILS_ENV == 'test') : params[:test]
+    encoding = params[:encoding] || AdMob::Defaults.encoding
+
+    # Determine the type of request
+    analytics_request = (params[:analytics_request] != false) && (!analytics_id.nil?) && (!analytics_id.strip.empty?)
+    ad_request = (params[:ad_request] != false) && (!publisher_id.nil?) && (!publisher_id.strip.empty?)
+
+    case [ad_request, analytics_request]
+    when [false, false] then return nil
+    when [true, false] then request_type = 0
+    when [false, true] then request_type = 1
+    when [true, true] then request_type = 2
+    end
+
+    # mark for this request so we don't make analytics calls again
+    request.env['admob_analytics_request_issued'] = true if analytics_request
+
+    # Build the basic request
+    post_data = {
+      's'         => publisher_id,
+      'a'         => analytics_id,
+      'u'         => request.user_agent,
+      'i'         => request.remote_ip,
+      'p'         => request.request_uri,
+      't'         => MD5.hexdigest(session_id),
+      'ma'        => params[:markup],
+      'rt'        => request_type,
+      'v'         => PUBCODE_VERSION,
+      'd[pc]'     => params[:postal_code],
+      'd[ac]'     => params[:area_code],
+      'd[coord]'  => params[:coordinates],
+      'd[dob]'    => params[:dob],
+      'd[gender]' => params[:gender],
+      'z'         => Time.now.to_f,
+      'k'         => params[:keywords],
+      'search'    => params[:search],
+      'f'         => 'html',
+      'title'     => params[:title],
+      'event'     => params[:event]
+    }
+
+    # Add in headers
+    ignore_headers = Set['HTTP_PRAGMA', 'HTTP_CACHE_CONTROL', 'HTTP_CONNECTION',
+        'HTTP_USER_AGENT', 'HTTP_COOKIE', 'ADMOB_ANALYTICS_REQUEST_ISSUED']
+    request.env.each {|k,v| post_data["h[#{k}]"] = v unless ignore_headers.include?(k.upcase.gsub(/-/,'_'))}
+
+    # Add in optional data
+    post_data['e'] = encoding if encoding
+    post_data['y'] = 'text' if params[:text_only]
+    post_data['m'] = 'test' if test
+    
+    # Don't send anything that's nil (but send if empty string)
+    post_data.delete_if {|k,v| v.nil?}
+  end
+
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: admob
+version: !ruby/object:Gem::Version 
+  version: 1.0.2
+platform: ruby
+authors: 
+- AdMobAdMob
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-29 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.6.0
+    version: 
+description: Enables easy integration of AdMob ads into a RoR mobile site.
+email: support@admob.comsupport@admob.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/admob.rb
+has_rdoc: true
+homepage: http://www.admob.com/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: admob
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Enables easy integration of AdMob ads into a RoR mobile site.
+test_files: []
+