rack-tracker 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0f0a68c680e45358ffb42303ad9556ef64d3b788
-  data.tar.gz: 33478c535dcdebd32ce278c763384e5b41fc5a65
+  metadata.gz: 06a5db11fbd86405523dbc25c7be6f8b81f2149d
+  data.tar.gz: 900ce6c698fe6db41c3cf073bf3c523e3056a366
 SHA512:
-  metadata.gz: 799632382d7f8c85cfe51f0e4f74784eb1a37089cd99af4bf6ad586366fd4e21f4488c90843464819d0827fd8c7adf89dd3fe615fdd3a218016d1453e29a9e6d
-  data.tar.gz: a1488e39161fb2e081de609947e36fab6cf7f61645aa7a0e0054948ef0bf29a360e43b16b1c021869b505b37c4d92de37c6f0f55a9cccf04905ec6782dc83fb2
+  metadata.gz: 300d2b933c171c031439480702b5e64cf824d25fc8d4e2007d6eb2d09d9852447306b5a56621b520367b20bcbafeafc967cd0ac61f04a28faa24b0e02a680202
+  data.tar.gz: 4f2e384af4d3a3da6fd48f2210f11a92c37b31adb156f47cea6f104743720717f8df2a05965c2935cd5456ba59820dd8c4049f4d985b78caa572e06210d8e87d

data/.travis.yml

@@ -3,4 +3,5 @@ rvm:
   - 1.9.3
   - 2.0.0
   - 2.1.2
+  - 2.2.1
   - jruby

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+# master
+
+# 0.4.0
+
+  * [BUGFIX] store event objects as hashes so they can be safely serialized using JSON (default since rails 4.1) #13
+  * added support for Google Analytics User ID feature #15
+  * added support for Google adwords conversion #24
+  * added support for Google Tag Manager feature #29
+  * added support for Google Analytics custom metrics and parameters #31 (thx @mnin)
+  * added support for Google Enhanced Ecommerce #32 (thx @mnin)
+
 # 0.3.0
 
   * [ENHANCEMENT] google analytics cookieDomain renamed to cookie_domain

data/README.md

@@ -21,6 +21,7 @@ in your application. It's easy to add your own [custom handlers](#custom-handler
 but to get you started we're shipping support for the following services out of the box:
 
 * [Google Analytics](#google-analytics)
+* [Google Tag Manager](#google-tag-manager)
 * [Facebook](#facebook)
 * [Visual Website Optimizer (VWO)](#visual-website-optimizer-vwo)
 * [GoSquared](#gosquared)
@@ -75,7 +76,7 @@ to inject arbitrary events into the request environment.
 ```ruby
 request.env['tracker'] = {
   'google_analytics' => [
-    Rack::Tracker::GoogleAnalytics::Send.new(category: "Users", action: "Login", label: "Standard")
+    { 'class_name' => 'Send', 'category' => 'Users', 'action' => 'Login', 'label' => 'Standard' }
   ]
 }
 ```
@@ -83,12 +84,14 @@ request.env['tracker'] = {
 ### Google Analytics
 
 * `:anonymize_ip` -  sets the tracker to remove the last octet from all IP addresses, see https://developers.google.com/analytics/devguides/collection/gajs/methods/gaJSApi_gat?hl=de#_gat._anonymizeIp for details.
-* `:cookie_domain` -  sets the domain name for the GATC cookies. Defaults to `auto`.
+* `:cookie_domain` -  sets the domain name for the [GATC cookies](https://developers.google.com/analytics/devguides/collection/analyticsjs/domains#implementation). If not set its the website domain, with the www. prefix removed.
+* `:user_id` -  defines a proc to set the [userId](https://developers.google.com/analytics/devguides/collection/analyticsjs/user-id). Ex: `user_id: lambda { |env| env['rack.session']['user_id'] }` would return the user_id from the session.
 * `:site_speed_sample_rate` - Defines a new sample set size for Site Speed data collection, see https://developers.google.com/analytics/devguides/collection/gajs/methods/gaJSApiBasicConfiguration?hl=de#_gat.GA_Tracker_._setSiteSpeedSampleRate
 * `:adjusted_bounce_rate_timeouts` - An array of times in seconds that the tracker will use to set timeouts for adjusted bounce rate tracking. See http://analytics.blogspot.ca/2012/07/tracking-adjusted-bounce-rate-in-google.html for details.
 * `:enhanced_link_attribution` - Enables [Enhanced Link Attribution](https://developers.google.com/analytics/devguides/collection/analyticsjs/advanced#enhancedlink).
 * `:advertising` - Enables [Display Features](https://developers.google.com/analytics/devguides/collection/analyticsjs/display-features).
 * `:ecommerce` - Enables [Ecommerce Tracking](https://developers.google.com/analytics/devguides/collection/analyticsjs/ecommerce).
+* `:enhanced_ecommerce` - Enables [Enhanced Ecommerce Tracking](https://developers.google.com/analytics/devguides/collection/analyticsjs/enhanced-ecommerce)
 
 #### Events
 
@@ -108,6 +111,54 @@ It will render the following to the site source:
   ga('send', { 'hitType': 'event', 'eventCategory': 'button', 'eventAction': 'click', 'eventLabel': 'nav-buttons', 'value': 'X' })
 ```
 
+#### Parameters
+
+You can set parameters in your controller too:
+
+```ruby
+  def show
+    tracker do |t|
+      t.google_analytics :parameter, { dimension1: 'pink' }
+    end
+  end
+```
+
+Will render this:
+
+```javascript
+  ga('set', 'dimension1', 'pink');
+```
+
+
+
+#### Enhanced Ecommerce
+
+You can set parameters in your controller:
+
+```ruby
+  def show
+    tracker do |t|
+      t.google_analytics :enhanced_ecommerce, {
+        type: 'addItem',
+        id: '1234',
+        name: 'Fluffy Pink Bunnies',
+        sku: 'DD23444',
+        category: 'Party Toys',
+        price: '11.99',
+        quantity: '1'
+      }
+    end
+  end
+```
+
+Will render this:
+
+```javascript
+  ga("ec:addItem", {"id": "1234", "name": "Fluffy Pink Bunnies", "sku": "DD23444", "category": "Party Toys", "price": "11.99", "quantity": "1"});
+```
+
+
+
 #### Ecommerce
 
 You can even trigger ecommerce directly from within your controller:
@@ -132,11 +183,36 @@ take care of the plugin on your own.
 
 ```ruby
   config.middleware.use(Rack::Tracker) do
-    handler :google_analytics, { tracker: 'U-XXXXX-Y', ecommerce: true}
+    handler :google_analytics, { tracker: 'U-XXXXX-Y', ecommerce: true }
   end
 ````
 
 
+### Google Tag Manager
+
+Google Tag manager code snippet doesn't support any option other than the container id
+
+```ruby
+  config.middleware.use(Rack::Tracker) do
+    handler :google_tag_manager, { container: 'GTM-XXXXXX' }
+  end
+````
+
+#### Data Layer
+
+GTM supports a [dataLayer](https://developers.google.com/tag-manager/devguide#datalayer) for pushing events as well as variables.
+
+To add events or variables to the dataLayer from the server side, just call the `tracker` method in your controller.
+
+```ruby
+  def show
+    tracker do |t|
+      t.google_tag_manager :push, { name: 'price', value: 'X' }
+    end
+  end
+```
+
+
 ### Facebook
 
 * `custom_audience` - adds the [Custom audience](https://developers.facebook.com/docs/reference/ads-api/custom-audience-website-faq) segmentation pixel
@@ -248,6 +324,28 @@ It will render the following to the site source:
   _gs("set", "visitor", { "age": 35, "favorite_food": "pizza" });
 ```
 
+### Criteo
+
+[Criteo](http://www.criteo.com/) retargeting service.
+
+```
+config.middleware.use(Rack::Tracker) do
+  handler :criteo, { set_account: '1234' }
+end
+```
+
+Other global criteo handler options are:
+* `setCustomerId` (value can be a static or a dynamic, e.g. `lambda { |env| env['rack.session']['user_id'] }`)
+* `setSiteType` (`m`, `t`, `d`)
+
+```
+def show
+  tracker do |t|
+    t.criteo :track, { event: 'viewItem', item: 'P0001' }
+  end
+end
+```
+
 ### Custom Handlers
 
 Tough we give you handlers for a few tracking services right out of the box, you might

data/lib/rack/tracker.rb

@@ -12,6 +12,8 @@ require "rack/tracker/handler"
 require "rack/tracker/handler_delegator"
 require "rack/tracker/controller"
 require "rack/tracker/google_analytics/google_analytics"
+require "rack/tracker/google_tag_manager/google_tag_manager"
+require "rack/tracker/google_adwords_conversion/google_adwords_conversion"
 require "rack/tracker/facebook/facebook"
 require "rack/tracker/vwo/vwo"
 require "rack/tracker/go_squared/go_squared"

data/lib/rack/tracker/facebook/facebook.rb

@@ -12,7 +12,7 @@ class Rack::Tracker::Facebook < Rack::Tracker::Handler
   end
 
   def self.track(name, *event)
-    { name.to_s => [Event.new(event.last)] }
+    { name.to_s => [event.last.merge('class_name' => 'Event')] }
   end
 
 end

data/lib/rack/tracker/go_squared/go_squared.rb

@@ -32,6 +32,6 @@ class Rack::Tracker::GoSquared < Rack::Tracker::Handler
   end
 
   def self.track(name, *event)
-    { name.to_s => [const_get(event.first.to_s.classify).new(event.last)] }
+    { name.to_s => [event.last.merge('class_name' => event.first.to_s.classify)] }
   end
 end

data/lib/rack/tracker/google_adwords_conversion/google_adwords_conversion.rb

@@ -0,0 +1,15 @@
+class Rack::Tracker::GoogleAdwordsConversion < Rack::Tracker::Handler
+
+  class Conversion < OpenStruct
+  end
+
+  self.position = :body
+
+  def render
+    Tilt.new( File.join( File.dirname(__FILE__), 'template', 'google_adwords_conversion.erb') ).render(self)
+  end
+
+  def self.track(name, *event)
+    { name.to_s => [event.last.merge('class_name' => event.first.to_s.capitalize)] }
+  end
+end

data/lib/rack/tracker/google_adwords_conversion/template/google_adwords_conversion.erb

@@ -0,0 +1,18 @@
+<% events.each do |ev| %>
+
+  <script type="text/javascript">
+  /* <![CDATA[ */
+  <% ev.to_h.each do |attr_name, attr_value| %>
+    var google_conversion_<%= attr_name %> = <%= attr_name == :id ? attr_value : "'#{attr_value}'" %>;
+  <% end %>
+  var google_remarketing_only = false;
+  /* ]]> */
+  </script>
+  <script type="text/javascript" src="//www.googleadservices.com/pagead/conversion.js"></script>
+  <noscript>
+    <div style="display:inline;">
+      <img height="1" width="1" style="border-style:none;" alt="" src="//www.googleadservices.com/pagead/conversion/<%= ev.id %>/?label=<%= URI.escape(ev.label) %>&amp;guid=ON&amp;script=0"/>
+    </div>
+  </noscript>
+
+<% end %>

data/lib/rack/tracker/google_analytics/google_analytics.rb

@@ -1,4 +1,7 @@
 class Rack::Tracker::GoogleAnalytics < Rack::Tracker::Handler
+
+  ALLOWED_TRACKER_OPTIONS = [:cookie_domain, :user_id]
+
   class Send < OpenStruct
     def initialize(attrs = {})
       attrs.reverse_merge!(type: 'event')
@@ -18,25 +21,51 @@ class Rack::Tracker::GoogleAnalytics < Rack::Tracker::Handler
     end
   end
 
+  class EnhancedEcommerce < OpenStruct
+    def write
+      ["ec:#{self.type}", self.to_h.except(:type).compact.stringify_values].to_json.gsub(/\[|\]/, '')
+    end
+  end
+
   class Ecommerce < OpenStruct
     def write
       ["ecommerce:#{self.type}", self.to_h.except(:type).compact.stringify_values].to_json.gsub(/\[|\]/, '')
     end
   end
 
+  class Parameter < OpenStruct
+    def write
+      ["set", self.to_h.to_a].flatten.map {|s| "'#{s}'" }.join(', ')
+    end
+  end
+
   def tracker
     options[:tracker].respond_to?(:call) ? options[:tracker].call(env) : options[:tracker]
   end
 
+  def tracker_options
+    @tracker_options ||= {}.tap do |tracker_options|
+      options.slice(*ALLOWED_TRACKER_OPTIONS).each do |key, value|
+        if option_value = value.respond_to?(:call) ? value.call(env) : value
+          tracker_options[key.to_s.camelize(:lower).to_sym] = option_value.to_s
+        end
+      end
+    end
+  end
+
   def render
     Tilt.new( File.join( File.dirname(__FILE__), 'template', 'google_analytics.erb') ).render(self)
   end
 
   def ecommerce_events
-    events.select{|e| e.kind_of?(Ecommerce) }
+    events.select {|e| e.kind_of?(Ecommerce) }
+  end
+
+  def enhanced_ecommerce_events
+    events.select {|e| e.kind_of?(EnhancedEcommerce) }
   end
 
   def self.track(name, *event)
-    { name.to_s => [const_get(event.first.to_s.capitalize).new(event.last)] }
+    { name.to_s => [event.last.merge('class_name' => event.first.to_s.classify)] }
   end
 end

data/lib/rack/tracker/google_analytics/template/google_analytics.erb

@@ -1,47 +1,41 @@
 <script type="text/javascript">
-
 <% if tracker %>
-  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-
-  ga('create', '<%= tracker %>', <%= (options[:cookie_domain] ? {cookieDomain: options[:cookie_domain]} : {}).to_json %>);
-
+  if(typeof ga === 'undefined') {
+    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+    })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+    ga('create', '<%= tracker %>', <%= tracker_options.to_json %>);
+  }
 <% if options[:enhanced_link_attribution] %>
   ga('require', 'linkid', 'linkid.js');
 <% end %>
-
 <% if options[:advertising] %>
   ga('require', 'displayfeatures');
 <% end %>
-
+<% if options[:enhanced_ecommerce] && enhanced_ecommerce_events.any? %>
+  ga('require', 'ec');
+<% end %>
 <% if options[:ecommerce] %>
   ga('require', 'ecommerce', 'ecommerce.js');
 <% end %>
-
 <% if options[:anonymize_ip] %>
   ga('set', 'anonymizeIp', true);
 <% end %>
-
 <% if options[:adjusted_bounce_rate_timeouts] %>
   <% options[:adjusted_bounce_rate_timeouts].each do |timeout| %>
       setTimeout(ga('send', 'event', '<%= "#{timeout.to_s}_seconds" %>', 'read'),<%= timeout*1000 %>);
   <% end %>
 <% end %>
-
 <% end %>
-
 <% events.each do |var| %>
   ga(<%= var.write() %>);
 <% end %>
-
 <% if options[:ecommerce] && ecommerce_events.any? %>
   ga('ecommerce:send');
 <% end %>
-
 <% if tracker %>
   ga('send', 'pageview');
 <% end %>
-
 </script>

data/lib/rack/tracker/google_tag_manager/google_tag_manager.rb

@@ -0,0 +1,33 @@
+class Rack::Tracker::GoogleTagManager < Rack::Tracker::Handler
+
+  class Push < OpenStruct
+
+    def write
+      "'#{event[:name]}': '#{event[:value]}'"
+    end
+
+    def event
+      attributes.stringify_values.compact
+    end
+
+    def attributes
+      to_h.slice(:name, :value)
+    end
+  end
+
+  # It is strongly recommended to put the google_tag_manager snippet only in the body tag
+  # https://developers.google.com/tag-manager/quickstart
+  self.position = :body
+
+  def container
+    options[:container].respond_to?(:call) ? options[:container].call(env) : options[:container]
+  end
+
+  def render
+    Tilt.new( File.join( File.dirname(__FILE__), 'template', 'google_tag_manager.erb') ).render(self)
+  end
+
+  def self.track(name, *event)
+    { name.to_s => [event.last.merge('class_name' => event.first.to_s.capitalize)] }
+  end
+end

data/lib/rack/tracker/google_tag_manager/template/google_tag_manager.erb

@@ -0,0 +1,19 @@
+<% if container %>
+<script>
+  dataLayer = [];
+</script>
+
+<noscript><iframe src="//www.googletagmanager.com/ns.html?id=<%= container %>"
+height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
+<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
+new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
+j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
+'//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
+})(window,document,'script','dataLayer','<%= container %>');</script>
+
+<script>
+dataLayer.push({
+  <%= events.map(&:write).join(', ') %>
+});
+</script>
+<% end %>

data/lib/rack/tracker/handler.rb

@@ -7,11 +7,13 @@ class Rack::Tracker::Handler
 
   def initialize(env, options = {})
     self.env = env
-    self.options = options
+    self.options  = options
+    self.position = options[:position] if options.has_key?(:position)
   end
 
   def events
-    env.fetch('tracker', {})[self.class.to_s.demodulize.underscore] || []
+    events = env.fetch('tracker', {})[self.class.to_s.demodulize.underscore] || []
+    events.map{ |ev| "#{self.class}::#{ev['class_name']}".constantize.new(ev.except('class_name')) }
   end
 
   def render

data/lib/rack/tracker/handler_delegator.rb

@@ -20,6 +20,7 @@ class Rack::Tracker::HandlerDelegator
   end
 
   def write_event(event)
+    event.deep_stringify_keys! # for consistent hash access use strings (keys from the session are always strings anyway)
     if env.key?('tracker')
       self.env['tracker'].deep_merge!(event) { |key, old, new| Array.wrap(old) + Array.wrap(new) }
     else

data/lib/rack/tracker/version.rb

@@ -1,5 +1,5 @@
 module Rack
   class Tracker
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

data/spec/fixtures/track_all_the_things.erb

@@ -1,3 +1,3 @@
 <script type="text/javascript">
-  myAwesomeFunction("tracks", "like", "<%= track_me[:like] %>", "<%= options[:custom_key] %>");
+  myAwesomeFunction("tracks", "like", "<%= track_me['like'] %>", "<%= options[:custom_key] %>");
 </script>

data/spec/handler/facebook_spec.rb

@@ -36,11 +36,12 @@ RSpec.describe Rack::Tracker::Facebook do
         'tracker' => {
         'facebook' =>
           [
-            Rack::Tracker::Facebook::Event.new(
-              'id'=> '123456789',
-             'value' => '23',
-             'currency' => 'EUR'
-            )
+            {
+              'id' => '123456789',
+              'value' => '23',
+              'currency' => 'EUR',
+              'class_name' => 'Event'
+            }
           ]
         }
       }

data/spec/handler/go_squared_spec.rb

@@ -14,7 +14,7 @@ RSpec.describe Rack::Tracker::GoSquared do
       def env
         {'tracker' => {
           'go_squared' => [
-            Rack::Tracker::GoSquared::VisitorName.new(name: "John Doe")
+            { 'class_name' => 'VisitorName', 'name' => 'John Doe' }
           ]
         }}
       end
@@ -30,7 +30,7 @@ RSpec.describe Rack::Tracker::GoSquared do
       def env
         {'tracker' => {
           'go_squared' => [
-            Rack::Tracker::GoSquared::VisitorInfo.new(age: 35, favorite_food: 'pizza')
+            { 'class_name' => 'VisitorInfo', 'age' => 35, 'favorite_food' => 'pizza' }
           ]
         }}
       end

data/spec/handler/google_adwords_conversion_spec.rb

@@ -0,0 +1,38 @@
+RSpec.describe Rack::Tracker::GoogleAdwordsConversion do
+
+  def env
+    {
+      misc: 'foobar',
+      user_id: '123'
+    }
+  end
+
+  it 'will be placed in the body' do
+    expect(described_class.position).to eq(:body)
+    expect(described_class.new(env).position).to eq(:body)
+    expect(described_class.new(env, position: :body).position).to eq(:body)
+  end
+
+  describe "with events" do
+    describe "default" do
+      def env
+        {'tracker' => {
+          'google_adwords_conversion' => [
+            { 'class_name' => 'Conversion', 'id' => 123456, 'language' => 'en', 'format' => '3', 'color' => 'ffffff', 'label' => 'Conversion Label' }
+          ]
+        }}
+      end
+
+      subject { described_class.new(env).render }
+      it 'will show events' do
+        expect(subject).to match(%r{var google_conversion_id = 123456;})
+        expect(subject).to match(%r{var google_conversion_language = 'en';})
+        expect(subject).to match(%r{var google_conversion_format = '3';})
+        expect(subject).to match(%r{var google_conversion_color = 'ffffff';})
+        expect(subject).to match(%r{var google_conversion_label = 'Conversion Label';})
+        expect(subject).to match(%r{<img.*src=\"\/\/www.googleadservices.com\/pagead\/conversion\/123456\/\?label=Conversion%20Label&amp;guid=ON&amp;script=0\"/>})
+      end
+    end
+  end
+
+end

data/spec/handler/google_analytics_spec.rb

@@ -1,12 +1,15 @@
 RSpec.describe Rack::Tracker::GoogleAnalytics do
-
   def env
-    {misc: 'foobar'}
+    {
+      misc: 'foobar',
+      user_id: '123'
+    }
   end
 
   it 'will be placed in the head' do
     expect(described_class.position).to eq(:head)
     expect(described_class.new(env).position).to eq(:head)
+    expect(described_class.new(env, position: :body).position).to eq(:body)
   end
 
   describe '#ecommerce_events' do
@@ -29,12 +32,70 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
     end
   end
 
+  describe '#enhanced_ecommerce_events' do
+    subject { described_class.new(env) }
+
+    describe 'with stored enhanced ecommerce events' do
+      before { allow(subject).to receive(:events).and_return([Rack::Tracker::GoogleAnalytics::Send.new, Rack::Tracker::GoogleAnalytics::EnhancedEcommerce.new]) }
+
+      it 'will just return the enhanced ecommerce events' do
+        expect(subject.enhanced_ecommerce_events).to match_array(Rack::Tracker::GoogleAnalytics::EnhancedEcommerce)
+      end
+    end
+
+    describe 'without stored enhanced ecommerce events' do
+      before { allow(subject).to receive(:events).and_return([Rack::Tracker::GoogleAnalytics::Send.new]) }
+
+      it 'will be empty' do
+        expect(subject.enhanced_ecommerce_events).to be_empty
+      end
+    end
+  end
+
+  describe '#tracker_options' do
+    before do
+      stub_const("#{described_class}::ALLOWED_TRACKER_OPTIONS", [:some_option])
+    end
+
+    context 'with an allowed option configured with a static value' do
+      subject { described_class.new(env, { some_option: 'value' }) }
+
+      it 'returns hash with option set' do
+        expect(subject.tracker_options).to eql ({ someOption: 'value' })
+      end
+    end
+
+    context 'with an allowed option configured with a block' do
+      subject { described_class.new(env, { some_option: lambda { |env| return env[:misc] } }) }
+
+      it 'returns hash with option set' do
+        expect(subject.tracker_options).to eql ({ someOption: 'foobar' })
+      end
+    end
+
+    context 'with an allowed option configured with a block returning nil' do
+      subject { described_class.new(env, { some_option: lambda { |env| return env[:non_existing_key] } }) }
+
+      it 'returns an empty hash' do
+        expect(subject.tracker_options).to eql ({})
+      end
+    end
+
+    context 'with a non allowed option' do
+      subject { described_class.new(env, { new_option: 'value' }) }
+
+      it 'returns an empty hash' do
+        expect(subject.tracker_options).to eql ({})
+      end
+    end
+  end
+
   describe "with events" do
     describe "default" do
       def env
         {'tracker' => {
           'google_analytics' => [
-            Rack::Tracker::GoogleAnalytics::Send.new(category: "Users", action: "Login", label: "Standard")
+            { 'class_name' => 'Send', 'category' => 'Users', 'action' => 'Login', 'label' => 'Standard' }
           ]
         }}
       end
@@ -48,7 +109,7 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
     describe "with a event value" do
       def env
         {'tracker' => { 'google_analytics' => [
-          Rack::Tracker::GoogleAnalytics::Send.new(category: "Users", action: "Login", label: "Standard", value: "5")
+          { 'class_name' => 'Send', category: "Users", action: "Login", label: "Standard", value: "5" }
         ]}}
       end
 
@@ -59,13 +120,13 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
     end
   end
 
-  describe 'with e-commerce events' do
+  describe 'with ecommerce events' do
     describe "default" do
       def env
         {'tracker' => {
           'google_analytics' => [
-            Rack::Tracker::GoogleAnalytics::Ecommerce.new({type: 'addItem', id: '1234', name: 'Fluffy Pink Bunnies', sku: 'DD23444', category: 'Party Toys', price: '11.99', quantity: '1'}),
-            Rack::Tracker::GoogleAnalytics::Ecommerce.new({type: 'addTransaction', id: '1234', affiliation: 'Acme Clothing', revenue: 11.99, shipping: '5', tax: '1.29', currency: 'EUR'})
+            { 'class_name' => 'Ecommerce', 'type' => 'addItem', 'id' => '1234', 'name' => 'Fluffy Pink Bunnies', 'sku' => 'DD23444', 'category' => 'Party Toys', 'price' => '11.99', 'quantity' => '1' },
+            { 'class_name' => 'Ecommerce', 'type' => 'addTransaction', 'id' => '1234', 'affiliation' => 'Acme Clothing', 'revenue' => 11.99, 'shipping' => '5', 'tax' => '1.29', 'currency' => 'EUR' }
           ]
         }}
       end
@@ -83,6 +144,44 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
     end
   end
 
+  describe 'with enhanced ecommerce events' do
+    describe "default" do
+      def env
+        {'tracker' => {
+          'google_analytics' => [
+            { 'class_name' => 'EnhancedEcommerce', 'type' => 'addProduct', 'id' => 'P12345', 'name' => 'Android Warhol T-Shirt', 'category' => 'Apparel', 'brand' => 'Google', 'variant' => 'black', 'price' => '29.20', 'coupon' => 'APPARELSALE', 'quantity' => 1 },
+            { 'class_name' => 'EnhancedEcommerce', 'type' => 'setAction', 'id' => 'T12345', 'affiliation' => 'Google Store - Online', 'revenue' => '37.39', 'tax' => '2.85', 'shipping' => '5.34', 'coupon' => 'SUMMER2013' }
+          ]
+        }}
+      end
+
+      subject { described_class.new(env, tracker: 'somebody', enhanced_ecommerce: true).render }
+      it "will add product" do
+        expect(subject).to match(%r{ga\(\"ec:addProduct\",#{{id: 'P12345', name: 'Android Warhol T-Shirt', category: 'Apparel', brand: 'Google', variant: 'black', price: '29.20', coupon: 'APPARELSALE', quantity: '1'}.to_json}})
+      end
+
+      it "will add action" do
+        expect(subject).to match(%r{ga\(\"ec:setAction\",#{{id: 'T12345', affiliation: 'Google Store - Online', revenue: '37.39', tax: '2.85', shipping: '5.34', coupon: 'SUMMER2013'}.to_json}})
+      end
+    end
+  end
+
+  describe 'with parameters events' do
+    def env
+      {'tracker' => {
+        'google_analytics' => [
+          { 'class_name' => 'Parameter', 'dimension1' => 'pink' },
+        ]
+      }}
+    end
+
+    subject { described_class.new(env, tracker: 'somebody').render }
+
+    it "will render dimension parameter" do
+      expect(subject).to match(%r{ga\('set', 'dimension1', 'pink'})
+    end
+  end
+
   describe "with custom domain" do
     subject { described_class.new(env, tracker: 'somebody', cookie_domain: "railslabs.com").render }
 
@@ -92,6 +191,15 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
     end
   end
 
+  describe "with user_id tracking" do
+    subject { described_class.new(env, tracker: 'somebody', user_id: lambda { |env| return env[:user_id] } ).render }
+
+    it "will show asyncronous tracker with userId" do
+      expect(subject).to match(%r{ga\('create', 'somebody', {\"userId\":\"123\"}\)})
+      expect(subject).to match(%r{ga\('send', 'pageview'\)})
+    end
+  end
+
   describe "with enhanced_link_attribution" do
     subject { described_class.new(env, tracker: 'happy', enhanced_link_attribution: true).render }
 
@@ -108,7 +216,33 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
     end
   end
 
-  describe "with e-commerce" do
+  describe "with enhanced ecommerce" do
+    describe "without events" do
+      subject { described_class.new(env, tracker: 'happy', enhanced_ecommerce: true).render }
+
+      it "will require the enhanced ecommerce plugin" do
+        expect(subject).to_not match(%r{ga\('require', 'ec'\)})
+      end
+    end
+
+    describe "with events" do
+      def env
+        {'tracker' => {
+          'google_analytics' => [
+            { 'class_name' => 'EnhancedEcommerce', 'type' => 'addProduct', 'id' => 'P12345', 'name' => 'Android Warhol T-Shirt', 'category' => 'Apparel', 'brand' => 'Google', 'variant' => 'black', 'price' => '29.20', 'coupon' => 'APPARELSALE', 'quantity' => 1 },
+          ]
+        }}
+      end
+
+      subject { described_class.new(env, tracker: 'happy', enhanced_ecommerce: true).render }
+
+      it "will require the enhanced ecommerce plugin" do
+        expect(subject).to match(%r{ga\('require', 'ec'\)})
+      end
+    end
+  end
+
+  describe "with ecommerce" do
     subject { described_class.new(env, tracker: 'happy', ecommerce: true).render }
 
     it "will require the ecommerce plugin" do
@@ -140,5 +274,4 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
       expect(subject).to match(%r{ga\('send', 'event', '30_seconds', 'read'\)})
     end
   end
-
 end

data/spec/handler/google_tag_manager_spec.rb

@@ -0,0 +1,42 @@
+RSpec.describe Rack::Tracker::GoogleTagManager do
+
+  def env
+    {
+      misc: 'foobar',
+      user_id: '123'
+    }
+  end
+
+  it 'will be placed in the body by default' do
+    expect(described_class.position).to eq(:body)
+    expect(described_class.new(env).position).to eq(:body)
+    expect(described_class.new(env, position: :head).position).to eq(:head)
+  end
+
+  describe "with events" do
+    describe "default" do
+      def env
+        {'tracker' => {
+          'google_tag_manager' => [
+            { 'class_name' => 'Push', 'name' => 'page', 'value' => 'Cart' },
+            { 'class_name' => 'Push', 'name' => 'price', 'value' => 50 }
+          ]
+        }}
+      end
+
+      subject { described_class.new(env, container: 'somebody').render }
+      it "will show events" do
+        expect(subject).to match(%r{'page': 'Cart', 'price': '50'})
+      end
+    end
+  end
+
+  describe "with dynamic tracker" do
+    subject { described_class.new(env, { container: lambda { |env| return env[:misc] }}).render }
+
+    it 'will call tracker lambdas to obtain tracking codes' do
+      expect(subject).to match(%r{\(window,document,'script','dataLayer','foobar'\)})
+    end
+  end
+
+end

data/spec/integration/google_adwords_conversion_integration_spec.rb

@@ -0,0 +1,18 @@
+require 'support/capybara_app_helper'
+
+RSpec.describe "Google Adwords Conversion Integration" do
+  before do
+    setup_app(action: :google_adwords_conversion) do |tracker|
+      tracker.handler :google_adwords_conversion
+    end
+    visit '/'
+  end
+
+  subject { page }
+
+  it "embeds the script tag with tracking event from the controller action" do
+    expect(page.find("body")).to have_content("var google_conversion_id = 123456;\nvar google_conversion_language = 'en';\nvar google_conversion_format = '3';\nvar google_conversion_color = 'ffffff';\nvar google_conversion_label = 'Conversion Label';")
+    expect(page.find("body")).to have_xpath("//img[@src=\"//www.googleadservices.com/pagead/conversion/123456/?label=Conversion%20Label&guid=ON&script=0\"]")
+  end
+
+end

data/spec/integration/google_analytics_integration_spec.rb

@@ -1,6 +1,6 @@
 require 'support/capybara_app_helper'
 
-RSpec.describe "Facebook Integration" do
+RSpec.describe "Google Analytics Integration" do
   before do
     setup_app(action: :google_analytics) do |tracker|
       tracker.handler :google_analytics, { tracker: 'U-XXX-Y' }
@@ -11,8 +11,23 @@ RSpec.describe "Facebook Integration" do
   subject { page }
 
   it "embeds the script tag with tracking event from the controller action" do
-    expect(page).to have_content('ga("ecommerce:addItem",{"id":"1234","name":"Fluffy Pink Bunnies","sku":"DD23444","category":"Party Toys","price":"11.99","quantity":"1"})')
-    expect(page).to have_content('ga("ecommerce:addTransaction",{"id":"1234","affiliation":"Acme Clothing","revenue":"11.99","shipping":"5","tax":"1.29"})')
-    expect(page).to have_content('ga("send",{"hitType":"event","eventCategory":"button","eventAction":"click","eventLabel":"nav-buttons","eventValue":"X"})')
+    expect(page.find("head")).to have_content('ga("ecommerce:addItem",{"id":"1234","name":"Fluffy Pink Bunnies","sku":"DD23444","category":"Party Toys","price":"11.99","quantity":"1"})')
+    expect(page.find("head")).to have_content('ga("ecommerce:addTransaction",{"id":"1234","affiliation":"Acme Clothing","revenue":"11.99","shipping":"5","tax":"1.29"})')
+    expect(page.find("head")).to have_content('ga("send",{"hitType":"event","eventCategory":"button","eventAction":"click","eventLabel":"nav-buttons","eventValue":"X"})')
+  end
+
+  describe 'adjust tracker position via options' do
+    before do
+      setup_app(action: :google_analytics) do |tracker|
+        tracker.handler :google_analytics, { tracker: 'U-XXX-Y', position: :body }
+      end
+      visit '/'
+    end
+
+    it "will be placed in the specified tag" do
+     expect(page.find("head")).to_not have_content('U-XXX-Y')
+     expect(page.find("body")).to have_content('ga("ecommerce:addItem",{"id":"1234","name":"Fluffy Pink Bunnies","sku":"DD23444","category":"Party Toys","price":"11.99","quantity":"1"})')
+    end
+
   end
 end

data/spec/integration/google_tag_manager_integration_spec.rb

@@ -0,0 +1,18 @@
+require 'support/capybara_app_helper'
+
+RSpec.describe "Google Tag Manager Integration" do
+  before do
+    setup_app(action: :google_tag_manager) do |tracker|
+      tracker.handler :google_tag_manager, { container: 'GTM-ABCDEF' }
+    end
+    visit '/'
+  end
+
+  subject { page }
+
+  it "embeds the script tag with tracking event from the controller action" do
+    expect(page.find("body")).to have_content('GTM-ABCDEF')
+    expect(page.find("body")).to have_content('\'click\': \'X\', \'price\': \'10\'')
+  end
+
+end

data/spec/spec_helper.rb

@@ -5,6 +5,7 @@ require 'rspec'
 require 'rack/test'
 require 'capybara/rspec'
 require 'rack/tracker'
+require 'pry'
 
 # Requires supporting files with custom matchers and macros, etc,
 # in ./support/ and its subdirectories.

data/spec/support/metal_controller.rb

@@ -38,6 +38,21 @@ class MetalController < ActionController::Metal
     render "metal/index"
   end
 
+  def google_tag_manager
+    tracker do |t|
+      t.google_tag_manager :push, { name: 'click', value: 'X' }
+      t.google_tag_manager :push, { name: 'price', value: '10' }
+    end
+    render "metal/index"
+  end
+
+  def google_adwords_conversion
+    tracker do |t|
+      t.google_adwords_conversion :conversion, { id: 123456, language: 'en', format: '3', color: 'ffffff', label: 'Conversion Label' }
+    end
+    render "metal/index"
+  end
+
   def vwo
     render "metal/index"
   end

data/spec/tracker/controller_spec.rb

@@ -22,11 +22,11 @@ end
 
 RSpec.describe Rack::Tracker::Controller do
   describe '#tracker' do
-    let(:send)       { Rack::Tracker::GoogleAnalytics::Send.new(category: 'foo') }
-    let(:trx)        { Rack::Tracker::GoogleAnalytics::Ecommerce.new(type: 'addTransaction', some: 'thing') }
-    let(:item_foo)   { Rack::Tracker::GoogleAnalytics::Ecommerce.new(type: 'addItem', name: 'foo') }
-    let(:item_bar)   { Rack::Tracker::GoogleAnalytics::Ecommerce.new(type: 'addItem', name: 'bar') }
-    let(:fb_event)   { Rack::Tracker::Facebook::Event.new(id: '1', value: 1, currency: 'USD') }
+    let(:send)       { { 'category' => 'foo', 'class_name' => 'Send' } }
+    let(:trx)        { { 'type' => 'addTransaction', 'some' => 'thing', 'class_name' => 'Ecommerce' } }
+    let(:item_foo)   { { 'type' => 'addItem', 'name' => 'foo', 'class_name' => 'Ecommerce' } }
+    let(:item_bar)   { { 'type' => 'addItem', 'name' => 'bar', 'class_name' => 'Ecommerce' } }
+    let(:fb_event)   { { 'id' => '1', 'value' => 1, 'currency' => 'USD', 'class_name' => 'Event' } }
     let(:controller) { TestController.new({}) }
 
     context 'controller' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rack-tracker
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Lars Brillert
@@ -9,132 +9,132 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-19 00:00:00.000000000 Z
+date: 2015-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.4.0
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.4.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.4.1
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: capybara
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.4.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.4.1
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: Don’t fool around with adding tracking partials to your app and concentrate
@@ -146,9 +146,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
-- .travis.yml
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -161,8 +161,12 @@ files:
 - lib/rack/tracker/facebook/template/facebook.erb
 - lib/rack/tracker/go_squared/go_squared.rb
 - lib/rack/tracker/go_squared/template/go_squared.erb
+- lib/rack/tracker/google_adwords_conversion/google_adwords_conversion.rb
+- lib/rack/tracker/google_adwords_conversion/template/google_adwords_conversion.erb
 - lib/rack/tracker/google_analytics/google_analytics.rb
 - lib/rack/tracker/google_analytics/template/google_analytics.erb
+- lib/rack/tracker/google_tag_manager/google_tag_manager.rb
+- lib/rack/tracker/google_tag_manager/template/google_tag_manager.erb
 - lib/rack/tracker/handler.rb
 - lib/rack/tracker/handler_delegator.rb
 - lib/rack/tracker/railtie.rb
@@ -177,11 +181,15 @@ files:
 - spec/fixtures/views/metal/index.html.erb
 - spec/handler/facebook_spec.rb
 - spec/handler/go_squared_spec.rb
+- spec/handler/google_adwords_conversion_spec.rb
 - spec/handler/google_analytics_spec.rb
+- spec/handler/google_tag_manager_spec.rb
 - spec/handler/vwo_spec.rb
 - spec/integration/facebook_integration_spec.rb
 - spec/integration/go_squared_integration_spec.rb
+- spec/integration/google_adwords_conversion_integration_spec.rb
 - spec/integration/google_analytics_integration_spec.rb
+- spec/integration/google_tag_manager_integration_spec.rb
 - spec/integration/rails_integration_spec.rb
 - spec/integration/vwo_integration_spec.rb
 - spec/spec_helper.rb
@@ -202,17 +210,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.3
 signing_key: 
 specification_version: 4
 summary: Tracking made easy
@@ -224,11 +232,15 @@ test_files:
 - spec/fixtures/views/metal/index.html.erb
 - spec/handler/facebook_spec.rb
 - spec/handler/go_squared_spec.rb
+- spec/handler/google_adwords_conversion_spec.rb
 - spec/handler/google_analytics_spec.rb
+- spec/handler/google_tag_manager_spec.rb
 - spec/handler/vwo_spec.rb
 - spec/integration/facebook_integration_spec.rb
 - spec/integration/go_squared_integration_spec.rb
+- spec/integration/google_adwords_conversion_integration_spec.rb
 - spec/integration/google_analytics_integration_spec.rb
+- spec/integration/google_tag_manager_integration_spec.rb
 - spec/integration/rails_integration_spec.rb
 - spec/integration/vwo_integration_spec.rb
 - spec/spec_helper.rb