Java Tracker Setup 0.7

Our documentation has moved!

🚧 This documentation is for an outdated version of the Java tracker. The latest documentation can be found on the Snowplow documentation site.

---

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

Contents

• 1. Overview
• 2. Integration options
  • 2.1 Tracker compatibility
  • 2.2 Dependencies
• 3. Setup
  • 3.1 Hosting
  • 3.2 Maven
  • 3.3 Gradle
  • 3.4 SBT

1. Overview

The Snowplow Java Tracker lets you add analytics to your Java-based desktop and server apps, servlets and games. It does not (yet) support Android.

The Tracker should be relatively straightforward to setup if you are familiar with Java development.

Ready? Let's get started.

Back to top

2. Integration options

2.1 Tracker compatibility

The Snowplow Java Tracker has been built and tested using JDK6 (JRE 1.6), so should work within any Java application built using JDK6 upwards.

Back to top

2.2 Dependencies

To minimize jar bloat, we have tried to keep external dependencies to a minimum. For the full list of dependencies, please see our Gradle build file.

Back to top

3. Setup

3.1 Hosting

The Tracker is published to Snowplow's hosted Maven repository, which should make it easy to add it as a dependency into your own Java app.

The current version of the Snowplow Java Tracker is 0.7.0.

3.2 Maven

If you are using Maven for building your Java application, then add the following code into your HOME/.m2/settings.xml to be able to use this repository:

<settings>
  <profiles>
    <profile>
      <!-- ... -->
      <repositories>
        <repository>
          <id>com.snowplowanalytics</id>
          <name>SnowPlow Analytics</name>
          <url>http://maven.snplow.com/releases</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>
</settings>

Then add into your project's pom.xml:

<dependency>
    <groupId>com.snowplowanalytics</groupId>
    <artifactId>snowplow-java-tracker</artifactId>
    <version>0.7.0</version>
</dependency>

3.3 Gradle

If you are using Gradle in your own Java application, then add our Maven repository in your build.gradle file:

repositories {
    ...
    maven {
        url "http://maven.snplow.com/releases"
    }
}

Then add into the same file:

dependencies {
    ...
    // Snowplow Java Tracker
    compile 'com.snowplowanalytics:snowplow-java-tracker:0.7.0'
}

3.4 SBT

The Snowplow Java Tracker is also usable from Scala. Add this to your SBT config:

// Resolvers
val snowplowRepo = "SnowPlow Repo" at "http://maven.snplow.com/releases/"

// Dependency
val snowplowTracker = "com.snowplowanalytics"  % "snowplow-java-tracker"  % "0.7.0"

Done? Now read the Java/Android Tracker API to start tracking events.