Set up the SDK

The justtrack SDK offers extensive tracking capabilities for attribution, events, and various other functionalities within your Android application. In this guide, you'll learn to:

• Add the justtrack SDK to your app
• Copy your API token
• Instantiate a JustTrackSdk object
• Shutdown the SDK instance

Add the SDK

In your project-level build.gradle, add the following repository to allprojects:

Groovy

allprojects {
    repositories {
        maven {
            url "https://sdk.justtrack.io/maven"
        }
    }
}

Kotlin

allprojects {
    repositories {
        maven {
            url = uri("https://sdk.justtrack.io/maven")
        }
    }
}

Then, in your module-level build.gradle, add the following dependency to your dependencies:

Groovy

dependencies {
    implementation "io.justtrack:justtrack-android-sdk:4.6.1"
}

Kotlin

dependencies {
    implementation("io.justtrack:justtrack-android-sdk:4.6.1")
}

Copy your API token

Before integrating the justtrack SDK into your app, you need to obtain an API token. Follow our guide to find your token.

Store your token as a constant called JUSTTRACK_SDK_API_TOKEN in your BuildConfig file:

Groovy

android {
    defaultConfig {
        buildConfigField "String", "JUSTTRACK_SDK_API_TOKEN", '"prod-c6654a0ae88b2f21111b9d69b4539fb1186de983f0ad826f0febaf28e3e3b7ed"'
    }
}

Kotlin

android {
    defaultConfig {
        buildConfigField("String", "JUSTTRACK_SDK_API_TOKEN", "\"prod-c6654a0ae88b2f21111b9d69b4539fb1186de983f0ad826f0febaf28e3e3b7ed\"")
    }
}

Instantiate the SDK

In your main activity class, or the class where you want to use the SDK, create an instance variable, SDK, for the JustTrackSdk.

Java

public class MainActivity extends SomeActivity {
    private JustTrackSdk sdk = null;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // ...
        sdk = new JustTrackSdkBuilder(this, BuildConfig.JUSTTRACK_SDK_API_TOKEN).build();
    }
}

Kotlin

class MainActivity : Activity() {
    private lateinit var sdk: JustTrackSdk

    override fun onCreate(savedInstanceState: Bundle?) {
        // ...
        sdk = JustTrackSdkBuilder(this, BuildConfig.JUSTTRACK_SDK_API_TOKEN).build()
    }
}

warning

If you define your own application class, it must extend android.app.Application.

Shutdown the SDK

When your app terminates, you need to deregister listeners and tear down session tracking.

First, in onDestroy(), call your SDK object's shutdown() method. Then, set the SDK to null because it will no longer be used:

Java

@Override
protected void onDestroy() {
    sdk.shutdown();
    sdk = null;
    // ...
    super.onDestroy();
}

Kotlin

override fun onDestroy() {
    sdk.shutdown()
    sdk = null
    // ...
    super.onDestroy()
}