Java Tracker Setup

Anton Parkhomenko edited this page Mar 14, 2018 · 14 revisions

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:

Contents

1. Overview

The Snowplow Java Tracker lets you add analytics to your 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

2. Integration options

2.1 Tracker compatibility

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

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.8.2.

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

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.8.2</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.8.2'
}

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

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

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.