Skip to content

Latest commit

 

History

History
114 lines (76 loc) · 2.88 KB

Readme.md

File metadata and controls

114 lines (76 loc) · 2.88 KB

An extension to Split to push test data to google analytics.

Build Status Gem Version Dependency Status

Requirements

The split gem and its dependencies.

Setup

If you are using bundler add split to your Gemfile:

gem 'split-analytics', :require => 'split/analytics'

Then run:

bundle install

Otherwise install the gem:

gem install split-analytics

and require it in your project:

require 'split/analytics'

Usage

Use in your application layout template

erb example:

<%= tracking_code(:account => 'UA-12345-6') %>

haml example:

= tracking_code(:account => 'UA-12345-6')

With Tracking Methods

See Google Analytics Tracking Methods for available options.

tracker_methods = {
  :setDomainName => "example.com", # String argument
  :setAllowLinker => true, # Boolean argument
  :require => ['inpage_linkid', '//www.google-analytics.com/plugins/ga/inpage_linkid.js'] # Array argument (will be splattered)
  :clearOrganic => "" # No argument
}

erb example:

<%= tracking_code(:account => 'UA-12345-6', :tracker_methods => tracker_methods) %>

haml example:

= tracking_code(:account => 'UA-12345-6', :tracker_methods => tracker_methods)

Other Tracking URLs

You can use other Tracking URLs with the option tracker_url and ssl_tracker_url.

erb example:

<%= tracking_code(:account => 'UA-12345-6', :tracker_url => 'stats.g.doubleclick.net/dc.js', :ssl_tracker_url => 'stats.g.doubleclick.net/dc.js') %>

haml example:

= tracking_code(:account => 'UA-12345-6', :tracker_url => 'stats.g.doubleclick.net/dc.js', :ssl_tracker_url => 'stats.g.doubleclick.net/dc.js')

Development

Source hosted at GitHub. Report Issues/Feature requests on GitHub Issues.

Tests can be ran with rake spec

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Copyright

Copyright (c) 2015 Andrew Nesbitt. See LICENSE for details.