Java Tracker Setup - chuwy/snowplow-ci GitHub Wiki

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

This page refers to version 0.8.0+ of the Snowplow Java Tracker.

Documentation for older version of this tracker is available:

• Java 0.7

• 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

The Snowplow Java Tracker lets you add analytics to your Java java-based desktop and server apps, servlets and games.

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

Ready? Let's get started.

Back to top

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

Back to top

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] gradle-build.

Back to top

The Tracker is published to Snowplow's [hosted Maven repository] maven-snplow, 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.8.0.

You can also manually insert the Tracker by downloading the jar directly: snowplow-java-tracker-0.8.0.jar

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.8.0</version>
</dependency>

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.8.0'
}

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.8.0"

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