ahoy_matey 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3ef1f6ecc94ec7e579782279c9187ec29be12393
-  data.tar.gz: 0515d97b0c1916bd94e057de85fb1a1ccb11f8d2
+  metadata.gz: c1ddf7a214c83d60f35b1d7a39653ef65d5ab3ee
+  data.tar.gz: e3c9af288c825faffda2cb7bf97cd8aa248c41a6
 SHA512:
-  metadata.gz: 7fb051cdca6fa1fe250094b03acf393e28c93c93df0a4ca9379fd6aa468478668be22f4cce72316ea5d9db20824d7ea700e627c5f2787f0b9ce24878d2736346
-  data.tar.gz: 00435c1bb0c2f83fec2eef2bf73d45c908269d793a5c18ebc3de39dd3286c13f33e390a8c83e3d3c05581602836c905be0740a21d381ec695a3bcc968dc584dd
+  metadata.gz: e3c068287e17bc73b51ce57af242a91013720b64dceefb00330a85ac2c586ba9b11b3fdd6395b9d8adf3d952b9dee1a73557d16a6a8792a49fa62d9c1893ba3c
+  data.tar.gz: 137594a001bb62a37274b94fe7776074b0880e74ddfdd0d48cc305d67847d13ca056de3f6fe38161d180d13cf22f79d6d363888a949d2d3abbdea8eed056d7cd

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+## 0.2.0
+
+- Added event tracking (merged ahoy_events)
+- Added ahoy.js
+
+## 0.1.8
+
+- Fixed bug with `user_type` set to `false` instead of `nil`
+
+## 0.1.7
+
+- Made cookie functions public for ahoy_events
+
+## 0.1.6
+
+- Better user agent parser
+
+## 0.1.5
+
+- Added support for Doorkeeper
+- Added options to `visitable`
+- Added `landing_params` method
+
 ## 0.1.4
 
 - Added `ahoy.ready()` and `ahoy.log()` for events

data/README.md

@@ -1,6 +1,6 @@
 # Ahoy
 
-:fire: Simple, powerful visit tracking for Rails
+:fire: Simple, powerful analytics for Rails
 
 Visits are stored in **your database** so you can easily combine them with other data.
 
@@ -11,13 +11,17 @@ You get:
 - **technology** - browser, OS, and device type
 - **utm parameters** - source, medium, term, content, campaign
 
-See which campaigns generate the most revenue effortlessly.
+Track events in:
 
-```ruby
-Order.joins(:visit).group("utm_campaign").sum(:revenue)
-```
+- JavaScript
+- Ruby
+- Native apps
+
+And store them wherever you’d like - your database, logs, external services, or all of them.
 
-:seedling: To track events like page views, check out [Ahoy Events](https://github.com/ankane/ahoy_events).
+:postbox: To track emails, check out [Ahoy Email](https://github.com/ankane/ahoy_email).
+
+No Ruby? Check out [Ahoy.js](https://github.com/ankane/ahoy.js).
 
 ## Installation
 
@@ -91,8 +95,6 @@ Order.joins(:visit).group("device_type").count
 
 Ahoy automatically attaches the `current_user` to the `current_visit`.
 
-If you define your own `current_user` method, be sure to add it to `ActionController::Base`, not `ApplicationController`.
-
 With [Devise](https://github.com/plataformatec/devise), it will attach the user even if he / she signs in after the visit starts.
 
 With other authentication frameworks, add this to the end of your sign in method:
@@ -133,19 +135,104 @@ or
 http://datakick.org/?utm_medium=twitter&utm_campaign=social&utm_source=tweet123
 ```
 
-### Location
+### Native Apps
 
-Ahoy uses [Geocoder](https://github.com/alexreisner/geocoder) for IP-based geocoding.
+When a user launches the app, create a visit.  Send a `POST` request to `/ahoy/visits` with:
+
+- platform - `iOS`, `Android`, etc.
+- app_version - `1.0.0`
+- os_version - `7.0.6`
+- visitor_token - if you have one
 
-### Multiple Subdomains
+The endpoint will return a JSON response like:
 
-To track visits across multiple subdomains, add this **before** the javascript files.
+```json
+{
+  "visit_token": "8tx2ziymkwa1WlppnkqxyaBaRlXrEQ3K",
+  "visitor_token": "hYBIV0rBfrIUAiArWweiECt4N9pyiygN"
+}
+```
+
+Send the visit token in the `Ahoy-Visit` header for all requests.
+
+After 4 hours, create another visit and use the updated visit token.
+
+## Events
+
+Each event has a `name` and `properties`.
+
+There are three ways to track events.
+
+#### JavaScript
 
 ```javascript
-var ahoy = {"domain": "yourdomain.com"};
+ahoy.track("Viewed book", {title: "The World is Flat"});
+```
+
+or track all views and clicks with:
+
+```javascript
+ahoy.trackAll();
+```
+
+#### Ruby
+
+```ruby
+ahoy.track "Viewed book", title: "Hot, Flat, and Crowded"
 ```
 
-### Development
+#### Native Apps
+
+Send a `POST` request to `/ahoy/events` with:
+
+- name
+- properties
+- user token (depends on your authentication framework)
+- `Ahoy-Visit` header
+
+Requests should have `Content-Type: application/json`.
+
+### Storing Events
+
+You choose how to store events.
+
+#### ActiveRecord
+
+Create an `Ahoy::Event` model to store events.
+
+```sh
+rails generate ahoy:events:active_record
+rake db:migrate
+```
+
+#### Custom
+
+Create your own subscribers in `config/initializers/ahoy.rb`.
+
+```ruby
+class LogSubscriber
+
+  def track(name, properties, options = {})
+    data = {
+      name: name,
+      properties: properties,
+      time: options[:time].to_i,
+      visit_id: options[:visit].try(:id),
+      user_id: options[:user].try(:id),
+      ip: options[:controller].try(:request).try(:remote_ip)
+    }
+    Rails.logger.info data.to_json
+  end
+
+end
+
+# and add it
+Ahoy.subscribers << LogSubscriber.new
+```
+
+Add as many subscribers as you’d like.
+
+## Development
 
 Ahoy is built with developers in mind.  You can run the following code in your browser’s console.
 
@@ -167,41 +254,35 @@ Turn off logging
 ahoy.debug(false);
 ```
 
-### Native Apps [experimental]
-
-When a user launches the app, create a visit.  Send a `POST` request to `/ahoy/visits` with:
+### More
 
-- platform - `iOS`, `Android`, etc.
-- app_version - `1.0.0`
-- os_version - `7.0.6`
-- visitor_token - if you have one
+- Excludes bots
+- Degrades gracefully when cookies are disabled
+- Don’t need a field? Just remove it from the migration
+- Visits are 4 hours by default
 
-The endpoint will return a JSON response like:
+### Doorkeeper
 
-```json
-{
-  "visit_token": "8tx2ziymkwa1WlppnkqxyaBaRlXrEQ3K",
-  "visitor_token": "hYBIV0rBfrIUAiArWweiECt4N9pyiygN"
-}
-```
+To attach the user with [Doorkeeper](https://github.com/doorkeeper-gem/doorkeeper), be sure you have a `current_resource_owner` method in `ApplicationController`.
 
-Send the visit token in the `Ahoy-Visit` header for all requests.
+```ruby
+class ApplicationController < ActionController::Base
 
-After 4 hours, create another visit and use the updated visit token.
+  private
 
-### More
+  def current_resource_owner
+    User.find(doorkeeper_token.resource_owner_id) if doorkeeper_token
+  end
 
-- Excludes bots
-- Degrades gracefully when cookies are disabled
-- Don’t need a field? Just remove it from the migration
-- Visits are 4 hours by default
+end
+```
 
 ## Reference
 
-Use a different model
+To track visits across multiple subdomains, add this **before** the javascript files.
 
-```ruby
-Ahoy.visit_model = UserVisit
+```javascript
+var ahoy = {"domain": "yourdomain.com"};
 ```
 
 Change the platform on the web
@@ -210,11 +291,97 @@ Change the platform on the web
 var ahoy = {"platform": "Mobile Web"}
 ```
 
+Track additional values
+
+```ruby
+class Visit < ActiveRecord::Base
+  ahoy_visit
+
+  before_create :set_gclid
+
+  def set_gclid
+    self.gclid = landing_params["gclid"]
+  end
+
+end
+```
+
+Use a method besides `current_user`
+
+```ruby
+Ahoy.user_method = :true_user
+```
+
+or use a Proc
+
+```ruby
+Ahoy.user_method = proc {|controller| controller.current_user }
+```
+
+Customize visitable
+
+```ruby
+visitable :sign_up_visit, class_name: "Visit"
+```
+
+Track view
+
+```javascript
+ahoy.trackView();
+```
+
+Track clicks
+
+```javascript
+ahoy.trackClicks();
+```
+
+Track all Rails actions
+
+```ruby
+class ApplicationController < ActionController::Base
+  after_filter :track_action
+
+  protected
+
+  def track_action
+    ahoy.track "Hit action", request.filtered_parameters
+  end
+end
+```
+
+Use a different model for visits
+
+```ruby
+Ahoy.visit_model = UserVisit
+
+# fix for Rails reloader in development
+ActionDispatch::Reloader.to_prepare do
+  Ahoy.visit_model = UserVisit
+end
+```
+
+Use a different model for events
+
+```ruby
+Ahoy.subscribers << Ahoy::Subscribers::ActiveRecord.new(model: Event)
+```
+
+## Upgrading
+
+In `0.1.6`, a big improvement was made to `browser` and `os`. Update existing visits with:
+
+```ruby
+Visit.find_each do |visit|
+  visit.set_technology
+  visit.save! if visit.changed?
+end
+```
+
 ## TODO
 
-- track emails
+- better readme
 - simple dashboard
-- hook to store additional fields
 - turn off modules
 
 ## History

data/ahoy_matey.gemspec

@@ -22,6 +22,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "browser", ">= 0.4.0"
   spec.add_dependency "geocoder"
   spec.add_dependency "referer-parser"
+  spec.add_dependency "user_agent_parser"
   spec.add_dependency "request_store"
 
   spec.add_development_dependency "bundler", "~> 1.5"

data/app/controllers/ahoy/events_controller.rb

@@ -0,0 +1,14 @@
+module Ahoy
+  class EventsController < Ahoy::BaseController
+
+    def create
+      options = {}
+      if params[:time] and (time = Time.at(params[:time].to_f) rescue nil) and (1.minute.ago..Time.now).cover?(time)
+        options[:time] = time
+      end
+      ahoy.track params[:name], params[:properties], options
+      render json: {}
+    end
+
+  end
+end

data/app/controllers/ahoy/visits_controller.rb

@@ -2,7 +2,7 @@ module Ahoy
   class VisitsController < BaseController
 
     def create
-      visit_token = generate_token
+      visit_token = params[:visit_token] || generate_token
       visitor_token = params[:visitor_token] || generate_token
 
       visit =
@@ -13,7 +13,7 @@ module Ahoy
           v.user_agent = request.user_agent if v.respond_to?(:user_agent=)
           v.referrer = params[:referrer] if v.respond_to?(:referrer=)
           v.landing_page = params[:landing_page] if v.respond_to?(:landing_page=)
-          v.user = current_user if respond_to?(:current_user) and v.respond_to?(:user=)
+          v.user = Ahoy.fetch_user(self) if v.respond_to?(:user=)
           v.platform = params[:platform] if v.respond_to?(:platform=)
           v.app_version = params[:app_version] if v.respond_to?(:app_version=)
           v.os_version = params[:os_version] if v.respond_to?(:os_version=)

data/app/models/ahoy/event.rb

@@ -0,0 +1,10 @@
+module Ahoy
+  class Event < ActiveRecord::Base
+    self.table_name = "ahoy_events"
+
+    belongs_to :visit
+    belongs_to :user, polymorphic: true
+
+    serialize :properties, JSON
+  end
+end

data/config/routes.rb

@@ -5,5 +5,6 @@ end
 Ahoy::Engine.routes.draw do
   scope module: "ahoy" do
     resources :visits, only: [:create]
+    resources :events, only: [:create]
   end
 end

data/lib/ahoy/controller.rb

@@ -3,6 +3,7 @@ module Ahoy
 
     def self.included(base)
       base.helper_method :current_visit
+      base.helper_method :ahoy
       base.before_filter do
         RequestStore.store[:ahoy_controller] ||= self
       end
@@ -15,5 +16,9 @@ module Ahoy
       end
     end
 
+    def ahoy
+      @ahoy ||= Ahoy::Tracker.new(controller: self)
+    end
+
   end
 end

data/lib/ahoy/model.rb

@@ -21,42 +21,20 @@ module Ahoy
         end
 
         def set_utm_parameters
-          landing_uri = Addressable::URI.parse(landing_page) rescue nil
-          if landing_uri
-            query_values = landing_uri.query_values || {}
-            %w[utm_source utm_medium utm_term utm_content utm_campaign].each do |name|
-              self[name] = query_values[name] if respond_to?(:"#{name}=")
-            end
+          %w[utm_source utm_medium utm_term utm_content utm_campaign].each do |name|
+            self[name] = landing_params[name] if respond_to?(:"#{name}=")
           end
           true
         end
 
         def set_technology
           if respond_to?(:user_agent)
-            browser = Browser.new(ua: user_agent)
+            agent = Ahoy.user_agent_parser.parse(user_agent)
 
-            self.browser = browser.name if respond_to?(:browser=)
-
-            # TODO add more
-            self.os =
-              if browser.android?
-                "Android"
-              elsif browser.ios?
-                "iOS"
-              elsif browser.windows_phone?
-                "Windows Phone"
-              elsif browser.blackberry?
-                "Blackberry"
-              elsif browser.chrome_os?
-                "Chrome OS"
-              elsif browser.mac?
-                "Mac"
-              elsif browser.windows?
-                "Windows"
-              elsif browser.linux?
-                "Linux"
-              end if respond_to?(:os=)
+            self.browser = agent.name if respond_to?(:browser=)
+            self.os = agent.os.name if respond_to?(:os=)
 
+            browser = Browser.new(ua: user_agent)
             self.device_type =
               if browser.tv?
                 "TV"
@@ -92,23 +70,31 @@ module Ahoy
           true
         end
 
+        def landing_params
+          @landing_params ||= begin
+            landing_uri = Addressable::URI.parse(landing_page) rescue nil
+            ActiveSupport::HashWithIndifferentAccess.new((landing_uri && landing_uri.query_values) || {})
+          end
+        end
+
       end # end class_eval
     end
 
-    def visitable
+    def visitable(name = nil, options = {})
+      if name.is_a?(Hash)
+        name = nil
+        options = name
+      end
+      name ||= :visit
       class_eval do
-        belongs_to :visit
-
+        belongs_to name, options
         before_create :set_visit
-
+      end
+      class_eval %Q{
         def set_visit
-          if !self.class.column_names.include?("visit_id")
-            raise "Add a visit_id column to this table to use visitable"
-          else
-            self.visit ||= RequestStore.store[:ahoy_controller].try(:send, :current_visit)
-          end
+          self.#{name} ||= RequestStore.store[:ahoy_controller].try(:send, :current_visit)
         end
-      end
+      }
     end
 
   end

data/lib/ahoy/subscribers/active_record.rb

@@ -0,0 +1,21 @@
+module Ahoy
+  module Subscribers
+    class ActiveRecord
+
+      def initialize(options = {})
+        @model = options[:model] || Ahoy::Event
+      end
+
+      def track(name, properties, options = {})
+        @model.create! do |e|
+          e.visit = options[:visit]
+          e.user = options[:user]
+          e.name = name
+          e.properties = properties
+          e.time = options[:time]
+        end
+      end
+
+    end
+  end
+end

data/lib/ahoy/tracker.rb

@@ -0,0 +1,30 @@
+module Ahoy
+  class Tracker
+
+    def initialize(options = {})
+      @controller = options[:controller]
+    end
+
+    def track(name, properties, options = {})
+      # publish to each subscriber
+      if @controller
+        options[:controller] ||= @controller
+        options[:user] ||= Ahoy.fetch_user(@controller)
+        if @controller.respond_to?(:current_visit)
+          options[:visit] ||= @controller.current_visit
+        end
+      end
+      options[:time] ||= Time.zone.now
+
+      subscribers = Ahoy.subscribers
+      if subscribers.any?
+        subscribers.each do |subscriber|
+          subscriber.track(name, properties, options)
+        end
+      else
+        $stderr.puts "No subscribers"
+      end
+    end
+
+  end
+end

data/lib/ahoy/version.rb

@@ -1,3 +1,3 @@
 module Ahoy
-  VERSION = "0.1.4"
+  VERSION = "0.2.0"
 end

data/lib/ahoy_matey.rb

@@ -2,10 +2,13 @@ require "addressable/uri"
 require "browser"
 require "geocoder"
 require "referer-parser"
+require "user_agent_parser"
 require "request_store"
 require "ahoy/version"
+require "ahoy/tracker"
 require "ahoy/controller"
 require "ahoy/model"
+require "ahoy/subscribers/active_record"
 require "ahoy/engine"
 
 module Ahoy
@@ -24,6 +27,26 @@ module Ahoy
     @referrer_parser ||= RefererParser::Referer.new("https://github.com/ankane/ahoy")
   end
 
+  # performance
+  def self.user_agent_parser
+    @user_agent_parser ||= UserAgentParser::Parser.new
+  end
+
+  def self.fetch_user(controller)
+    if user_method.respond_to?(:call)
+      user_method.call(controller)
+    else
+      controller.send(user_method)
+    end
+  end
+
+  mattr_accessor :user_method
+  self.user_method = proc do |controller|
+    (controller.respond_to?(:current_user) && controller.current_user) || (controller.respond_to?(:current_resource_owner, true) && controller.send(:current_resource_owner)) || nil
+  end
+
+  mattr_accessor :subscribers
+  self.subscribers = []
 end
 
 ActionController::Base.send :include, Ahoy::Controller

data/lib/generators/ahoy/events/active_record_generator.rb

@@ -0,0 +1,36 @@
+# taken from https://github.com/collectiveidea/audited/blob/master/lib/generators/audited/install_generator.rb
+require "rails/generators"
+require "rails/generators/migration"
+require "active_record"
+require "rails/generators/active_record"
+
+module Ahoy
+  module Events
+    module Generators
+      class ActiveRecordGenerator < Rails::Generators::Base
+        include Rails::Generators::Migration
+
+        source_root File.expand_path("../templates", __FILE__)
+
+        # Implement the required interface for Rails::Generators::Migration.
+        def self.next_migration_number(dirname) #:nodoc:
+          next_migration_number = current_migration_number(dirname) + 1
+          if ActiveRecord::Base.timestamped_migrations
+            [Time.now.utc.strftime("%Y%m%d%H%M%S"), "%.14d" % next_migration_number].max
+          else
+            "%.3d" % next_migration_number
+          end
+        end
+
+        def copy_migration
+          migration_template "create_events.rb", "db/migrate/create_ahoy_events.rb"
+        end
+
+        def create_initializer
+          template "initializer.rb", "config/initializers/ahoy.rb"
+        end
+
+      end
+    end
+  end
+end

data/lib/generators/ahoy/events/templates/create_events.rb

@@ -0,0 +1,20 @@
+class <%= migration_class_name %> < ActiveRecord::Migration
+  def change
+    create_table :ahoy_events do |t|
+      # visit
+      t.references :visit
+
+      # user
+      t.integer :user_id
+      t.string :user_type
+
+      t.string :name
+      t.text :properties
+      t.timestamp :time
+    end
+
+    add_index :ahoy_events, [:visit_id]
+    add_index :ahoy_events, [:user_id, :user_type]
+    add_index :ahoy_events, [:time]
+  end
+end

data/lib/generators/ahoy/events/templates/initializer.rb

@@ -0,0 +1 @@
+Ahoy.subscribers << Ahoy::Subscribers::ActiveRecord.new

data/vendor/assets/javascripts/ahoy.js

@@ -10,6 +10,8 @@
   var visitorTtl = 2 * 365 * 24 * 60; // 2 years
   var isReady = false;
   var queue = [];
+  var canStringify = typeof(JSON) !== "undefined" && typeof(JSON.stringify) !== "undefined";
+  var eventQueue = [];
 
   // cookies
 
@@ -62,25 +64,98 @@
     isReady = true;
   }
 
+  function ready(callback) {
+    if (isReady) {
+      callback();
+    } else {
+      queue.push(callback);
+    }
+  }
+
+  // https://github.com/klughammer/node-randomstring
+  function generateId() {
+    var chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghiklmnopqrstuvwxyz';
+    var length = 32;
+    var string = '';
+
+    for (var i = 0; i < length; i++) {
+      var randomNumber = Math.floor(Math.random() * chars.length);
+      string += chars.substring(randomNumber, randomNumber + 1);
+    }
+
+    return string;
+  }
+
+  function saveEventQueue() {
+    // TODO add stringify method for IE 7 and under
+    if (canStringify) {
+      setCookie("ahoy_events", JSON.stringify(eventQueue), 1);
+    }
+  }
+
+  function trackEvent(event) {
+    ready( function () {
+      // ensure JSON is defined
+      if (canStringify) {
+        $.ajax({
+          type: "POST",
+          url: "/ahoy/events",
+          data: JSON.stringify(event),
+          contentType: "application/json; charset=utf-8",
+          dataType: "json",
+          success: function() {
+            // remove from queue
+            for (var i = 0; i < eventQueue.length; i++) {
+              if (eventQueue[i].id == event.id) {
+                eventQueue.splice(i, 1);
+                break;
+              }
+            }
+            saveEventQueue();
+          }
+        });
+      }
+    });
+  }
+
+  function eventProperties(e) {
+    var $target = $(e.currentTarget);
+    return {
+      tag: $target.get(0).tagName.toLowerCase(),
+      id: $target.attr("id"),
+      class: $target.attr("class")
+    };
+  }
+
   // main
 
   visitToken = getCookie("ahoy_visit");
   visitorToken = getCookie("ahoy_visitor");
 
-  if (visitToken && visitorToken && visitToken != "test") {
+  if (visitToken && visitorToken) {
     // TODO keep visit alive?
     log("Active visit");
     setReady();
   } else {
-    setCookie("ahoy_visit", "test", 1);
+    visitToken = generateId();
+    setCookie("ahoy_visit", visitToken, visitTtl);
 
     // make sure cookies are enabled
     if (getCookie("ahoy_visit")) {
       log("Visit started");
 
+      if (!visitorToken) {
+        visitorToken = generateId();
+        setCookie("ahoy_visitor", visitorToken, visitorTtl);
+      }
+
       var data = {
+        visit_token: visitToken,
+        visitor_token: visitorToken,
         platform: ahoy.platform || "Web",
-        landing_page: window.location.href
+        landing_page: window.location.href,
+        screen_width: window.screen.width,
+        screen_height: window.screen.height
       };
 
       // referrer
@@ -88,17 +163,9 @@
         data.referrer = document.referrer;
       }
 
-      if (visitorToken) {
-        data.visitor_token = visitorToken;
-      }
-
       log(data);
 
-      $.post("/ahoy/visits", data, function(response) {
-        setCookie("ahoy_visit", response.visit_token, visitTtl);
-        setCookie("ahoy_visitor", response.visitor_token, visitorTtl);
-        setReady();
-      }, "json");
+      $.post("/ahoy/visits", data, setReady, "json");
     } else {
       log("Cookies disabled");
       setReady();
@@ -120,15 +187,74 @@
     return true;
   };
 
-  ahoy.log = log;
+  ahoy.track = function (name, properties) {
+    // generate unique id
+    var event = {
+      id: generateId(),
+      name: name,
+      properties: properties,
+      time: (new Date()).getTime() / 1000.0
+    };
+    log(event);
 
-  ahoy.ready = function (callback) {
-    if (isReady) {
-      callback();
-    } else {
-      queue.push(callback);
-    }
+    eventQueue.push(event);
+    saveEventQueue();
+
+    // wait in case navigating to reduce duplicate events
+    setTimeout( function () {
+      trackEvent(event);
+    }, 1000);
+  };
+
+  ahoy.trackView = function () {
+    var properties = {
+      url: window.location.href,
+      title: document.title
+    };
+    ahoy.track("$view", properties);
+  };
+
+  ahoy.trackClicks = function () {
+    $(document).on("click", "a, button, input[type=submit]", function (e) {
+      var $target = $(e.currentTarget);
+      var properties = eventProperties(e);
+      properties.text = properties.tag == "input" ? $target.val() : $.trim($target.text());
+      properties.href = $target.attr("href");
+      ahoy.track("$click", properties);
+    });
+  };
+
+  ahoy.trackSubmits = function () {
+    $(document).on("submit", "form", function (e) {
+      var properties = eventProperties(e);
+      ahoy.track("$submit", properties);
+    });
   };
 
+  ahoy.trackChanges = function () {
+    $(document).on("change", "input, textarea, select", function (e) {
+      var properties = eventProperties(e);
+      ahoy.track("$change", properties);
+    });
+  };
+
+  ahoy.trackAll = function() {
+    ahoy.trackView();
+    ahoy.trackClicks();
+    ahoy.trackSubmits();
+    ahoy.trackChanges();
+  };
+
+  // push events from queue
+  try {
+    eventQueue = JSON.parse(getCookie("ahoy_events") || "[]");
+  } catch (e) {
+    // do nothing
+  }
+
+  for (var i = 0; i < eventQueue.length; i++) {
+    trackEvent(eventQueue[i]);
+  }
+
   window.ahoy = ahoy;
 }(window));

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ahoy_matey
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Andrew Kane
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-28 00:00:00.000000000 Z
+date: 2014-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -66,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: user_agent_parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: request_store
   requirement: !ruby/object:Gem::Requirement
@@ -123,13 +137,20 @@ files:
 - Rakefile
 - ahoy_matey.gemspec
 - app/controllers/ahoy/base_controller.rb
+- app/controllers/ahoy/events_controller.rb
 - app/controllers/ahoy/visits_controller.rb
+- app/models/ahoy/event.rb
 - config/routes.rb
 - lib/ahoy/controller.rb
 - lib/ahoy/engine.rb
 - lib/ahoy/model.rb
+- lib/ahoy/subscribers/active_record.rb
+- lib/ahoy/tracker.rb
 - lib/ahoy/version.rb
 - lib/ahoy_matey.rb
+- lib/generators/ahoy/events/active_record_generator.rb
+- lib/generators/ahoy/events/templates/create_events.rb
+- lib/generators/ahoy/events/templates/initializer.rb
 - lib/generators/ahoy/install_generator.rb
 - lib/generators/ahoy/templates/install.rb
 - vendor/assets/javascripts/ahoy.js