Java Tracker Setup 0.7 - OXYGEN-MARKET/oxygen-market.github.io GitHub Wiki

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

• 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-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

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

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

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.

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>

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

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.