rack-tracker 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0e83bc3662d5297183050ac1210f0707773bcc3c
-  data.tar.gz: b1dc4f2fee0a5965559641a347562ccdb07c9da3
+  metadata.gz: 82d324245976135563761ec9eee0703f7557d0a2
+  data.tar.gz: dc0b22a2e177d364b14f9b2a178d97270aee2552
 SHA512:
-  metadata.gz: 3d0fe52d68d0e7109d2b2bd420179f2ce9973661c2159d15cf302e63b3e008f807a4a6fbb1da23cf1c4e4009e3a1b6be8a37fb9293cb35999444fec4b7182aa1
-  data.tar.gz: 0f6e8f2d08eab9e53716bb19813e40120cc3b6d34f7b621c9f2bb27d004ad6b3b97c9920b0424ea4a9abbc4f7fa0d78933dc3b91a13c4a25ff7948d2de4f01ba
+  metadata.gz: 80ff2c12422960b315df641d81ed22ec2e48276942535f87f450c1cbf68b26be6dfd5a37d43d06e3464e9b4f295e570ad1ab09d48d9ff093439910d2f23cd1ec
+  data.tar.gz: 1453d60608ee4fa30e010489eef22c1704bb1bbe6a40c0289c6bafb897e7b16245c06cef80ad2fda0dada817ea9f92314d34be1f398a61963a6d03feeef62a91

data/CHANGELOG.md

@@ -1,6 +1,11 @@
+# 0.2.1
+
+  * [BUGFIX] sending the ecommerce cart was misspelled
+
 # 0.2.0
 
   * added support for GoSquared
+  * added support for Visual Website Optimizer
 
 # 0.1.3
 

data/README.md

@@ -17,8 +17,14 @@ an easy interface to drop in new services. This is why we created `rack-tracker`
 rack middleware that can be hooked up to multiple services and exposing them in a unified
 fashion. It comes in two parts, the first one is the actual middleware that you can add
 to the middleware stack the second part are the service-handlers that you're going to use
-in your application. We're shipping support for Google and Facebook, to add your own please
-read about [custom handlers](#custom-handlers).
+in your application. It's easy to add your own [custom handlers](#custom-handlers),
+but to get you startet we're shipping support for the following services out of the box:
+
+* [Google Analytics](#google-analytics)
+* [Facebook](#facebook)
+* [Visual Website Optimizer (VWO)](#visual-website-optimizer-vwo)
+* [GoSquared](#gosquared)
+
 
 ## Installation
 
@@ -44,9 +50,7 @@ config.middleware.use(Rack::Tracker) do
 end
 ````
 
-This will add Google Analytics as a tracking handler. `Rack::Tracker` some with
-support for Google Analytics and Facebook. Others might be added in the future
-but you can easily write your own handlers.
+This will add Google Analytics as a tracking handler.
 
 ### Google Analytics
 
@@ -218,10 +222,10 @@ It will render the following to the site source:
 
 ### Custom Handlers
 
-Tough we give you Google Analytics and Facebook right out of the box, you might
+Tough we give you handlers for a few tracking services right out of the box, you might
 be interested adding support for your custom tracking/analytics service.
 
-Writing a handler is straight forward ;) There are just a couple of methods that
+Writing a handler is straight forward ;) and there are just a couple of methods that
 your class needs to implement.
 
 Start with a plain ruby class that inherits from `Rack::Tracker::Handler`
@@ -242,7 +246,7 @@ end
 ```
 
 This will render the `template/my_handler.erb` and inject the result into the source. You
-can be creative about where the template is stored, we tend to have them around
+can be creative about where the template is stored, but we tend to have them around
 our actual handler code.
 
 ```erb
@@ -275,9 +279,27 @@ end
 
 The snippit will then be rendered right before `</body>`.
 
+To enable the *tracker dsl* functionality in your controllers
+you need to implement the `track` class method on your handler:
+
+```ruby
+def self.track(name, *event)
+  # do something with the event(s) to prepare them for your template
+  # and return a hash with a signature like { name => event }
+end
+```
+
+Checkout the existing handlers in `lib/rack/tracker` for some inspiration. :)
+
 
 ## Contributing
 
+First of all, **thank** you for your help! :green_heart:
+
+If you want a feature implemented, the best way to get it done
+is to submit a pull request that implements it.
+Tests, readme and changelog entries would be nice.
+
 1. Fork it ( http://github.com/railslove/rack-tracker/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)

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

@@ -37,7 +37,7 @@
 <% end %>
 
 <% if options[:ecommerce] && ecommerce_events.any? %>
-  ga('send:ecommerce');
+  ga('ecommerce:send');
 <% end %>
 
 <% if tracker %>

data/lib/rack/tracker/version.rb

@@ -1,5 +1,5 @@
 module Rack
   class Tracker
-    VERSION = "0.2.0"
+    VERSION = "0.2.1"
   end
 end

data/spec/handler/google_analytics_spec.rb

@@ -64,17 +64,21 @@ RSpec.describe Rack::Tracker::GoogleAnalytics do
       def env
         {'tracker' => {
           'google_analytics' => [
-            Rack::Tracker::GoogleAnalytics::Ecommerce.new({type: 'addItem', id: '1234', affiliation: 'Acme Clothing', revenue: 11.99, shipping: '5', tax: '1.29', currency: 'EUR'})
+            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'})
           ]
         }}
       end
 
       subject { described_class.new(env, tracker: 'somebody', ecommerce: true).render }
       it "will add items" do
-        expect(subject).to match(%r{ga\(\"ecommerce:addItem\",#{{id: '1234', affiliation: 'Acme Clothing', revenue: 11.99, shipping: '5', tax: '1.29', currency: 'EUR'}.to_json}})
+        expect(subject).to match(%r{ga\(\"ecommerce:addItem\",#{{id: '1234', name: 'Fluffy Pink Bunnies', sku: 'DD23444', category: 'Party Toys', price: '11.99', quantity: '1'}.to_json}})
+      end
+      it "will add transaction" do
+        expect(subject).to match(%r{ga\(\"ecommerce:addTransaction\",#{{id: '1234', affiliation: 'Acme Clothing', revenue: 11.99, shipping: '5', tax: '1.29', currency: 'EUR'}.to_json}})
       end
       it "will submit cart" do
-        expect(subject).to match(%r{ga\('send:ecommerce'\);})
+        expect(subject).to match(%r{ga\('ecommerce:send'\);})
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rack-tracker
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Lars Brillert
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-11 00:00:00.000000000 Z
+date: 2014-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack