channel_grouping

ChannelGrouping

Groups traffic into channels, similar to the groupings in Google Analytics

Given a source_url and destination_url, this gem will determine the traffic's channel (eg Social, Direct, Organic Search, Paid Search).

The categorizations are based on Google Analytics' default channel definitions

Limitations

• Display and Paid Search groupings do not take into account the Ad Distribution Network
• The list of Social Networks and Search Engines may differ from Google's lists.

• See sources.yml and https://support.google.com/analytics/answer/2795821

Usage

ChannelGrouping.identify(source_url: 'https://www.google.com?s=some-query', destination_url: 'https://your-site.com')
#=> 'Organic Search'

ChannelGrouping.identify(source_url: 'https://www.some-site.com', destination_url: 'https://your-site.com?utm_medium=cpc')
#=> 'Paid Search'

ChannelGrouping.identify(source_url: nil, destination_url: 'https://your-site.com')
#=> 'Direct'

Installation

Add this line to your application's Gemfile:

gem 'channel_grouping'

And then execute:

$ bundle

Or install it yourself as:

$ gem install channel_grouping

Development

After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

• Fork it ( https://github.com/[my-github-username]/channel_grouping/fork )
• Create your feature branch (git checkout -b my-new-feature)
• Commit your changes (git commit -am 'Add some feature')
• Push to the branch (git push origin my-new-feature)
• Create a new Pull Request