splitrb/split-analytics

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 87 Commits
.github		.github
lib/split		lib/split
spec		spec
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Gemfile		Gemfile
LICENSE		LICENSE
Rakefile		Rakefile
Readme.md		Readme.md
split-analytics.gemspec		split-analytics.gemspec

Repository files navigation

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

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.