📊 An extension to Split to push test data to Google Analytics
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
- 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.
Testing
Tests can be ran with rake spec
.
License
Copyright (c) 2015-2018 Andrew Nesbitt. See LICENSE for details.