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:
Groovy Kotlin
Copy dependencies {
implementation "io.justtrack:justtrack-android-sdk:4.5.0"
}
Copy dependencies {
implementation ( "io.justtrack:justtrack-android-sdk:4.5.0" )
}
Add the justtrack SDK to your app
Instantiate a JustTrackSdk
object
Shutdown the SDK instance
Add the SDK
In your project-level build.gradle
, add the following repository to allprojects
:
Groovy Kotlin
Copy allprojects {
repositories {
maven {
url "https://sdk.justtrack.io/maven"
}
}
}
Copy 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 Kotlin
Copy dependencies {
implementation "io.justtrack:justtrack-android-sdk:4.5.0"
}
Copy dependencies {
implementation ( "io.justtrack:justtrack-android-sdk:4.5.0" )
}
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 Kotlin
Copy android {
defaultConfig {
buildConfigField "String", "JUSTTRACK_SDK_API_TOKEN", '"prod-c6654a0ae88b2f21111b9d69b4539fb1186de983f0ad826f0febaf28e3e3b7ed"'
}
}
Copy 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 Kotlin
Copy 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 ();
}
}
Copy class MainActivity : Activity () {
private lateinit var sdk: JustTrackSdk
override fun onCreate (savedInstanceState: Bundle ?) {
// ...
sdk = JustTrackSdkBuilder ( this , BuildConfig.JUSTTRACK_SDK_API_TOKEN). build ()
}
}
If you define your own application class, it must extend android.app.Application
.
Shutdown the SDK
When your app terminates, you need to unregister 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 Kotlin
Copy @ Override
protected void onDestroy() {
sdk . shutdown ();
sdk = null ;
// ...
super . onDestroy ();
}
Copy override fun onDestroy () {
sdk. shutdown ()
sdk = null
// ...
super . onDestroy ()
}
Last updated 10 months ago