Ruby tracker setup - OXYGEN-MARKET/oxygen-market.github.io GitHub Wiki

HOME > SNOWPLOW SETUP GUIDE > Step 2: setup a Tracker > Ruby tracker

• 1 Overview
• 2 Dependencies
• 3 Setup
  • 3.1 RubyGems
  • 3.2 Installation

The Snowplow Ruby Tracker lets you add analytics to your Ruby applications and gems.

Setting up the tracker should be relatively straightforward if you are familiar with Ruby development.

Ready? Let's get started.

Back to top

The Snowplow Ruby Tracker is compatible with Ruby versions 1.9.3, 2.0.0, and 2.1.0.

To make the Snowplow Ruby Tracker work with as many different Ruby programs as possible, we have tried to keep external dependencies to a minimum. There are only two external dependencies currently:

• contracts - Ruby package that allows one to declare constraints on function parameters and return values.
• webmock - HTTP library used to stub requests for testing.

These dependencies can be installed from the package manager of the host system or through RubyGems.

Back to top

The Snowplow Ruby Tracker is published to RubyGems, the Ruby community's gem hosting service. This makes it easy to either install the tracker locally, or to add it as a dependency into your own Ruby app.

To install the Snowplow Ruby Tracker locally:

$ gem install snowplow-tracker

To add the Snowplow Tracker as a dependency to your own Ruby gem, edit your gemfile and add:

gem 'snowplow-tracker'

Done? Now read the Ruby Tracker API to start tracking events.

Back to top