splitrb / split-analytics

:bar_chart: An extension to Split to push test data to Google Analytics.
http://libraries.io/rubygems/split-analytics
MIT License
50 stars 14 forks source link

Split Analytics

📊 An extension to Split to push test data to Google Analytics

Build Status Gem Version Dependency Status

Install

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')

Contributing

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

Please follow the Code of Conduct.

Note on Patches/Pull Requests

Testing

Tests can be ran with rake spec.

License

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