Ruby tracker setup

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

Contents

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

1. Overview

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

2. Dependencies

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

3. Setup

3.1 RubyGems

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.

3.2 Installation

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