Android SDK - Kotlin Tutorial

The latest Android SDK version is 2.6.6

Step 1 – add our repo to your module Gradle file  

allprojects { 
     repositories { 
         google() 
         jcenter() 
        maven  { 
 
           url "https://bluetriangletech.jfrog.io/artifactory/android-sdk-local/" 
 
        } 
     } 
}

Step 2 – add the Blue Triangle analytics library as a dependency in your application Gradle file  

dependencies { 
 
    implementation 'androidx.appcompat:appcompat:1.2.0' 
    implementation 'com.google.android.material:material:1.3.0' 
    implementation 'androidx.constraintlayout:constraintlayout:2.0.4' 
    implementation 'androidx.navigation:navigation-fragment:2.3.3' 
    implementation 'androidx.navigation:navigation-ui:2.3.3' 
    implementation 'bluetriangle.sdk.package:analytics:2.6.6' 
    testImplementation 'junit:junit:4.+' 
    androidTestImplementation 'androidx.test.ext:junit:1.1.2' 
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0' 
}

Step 3 – sync your Gradle dependencies  

Step 4 – import the Blue Triangle tracker in your app delegate  

import com.bluetriangle.analytics.Tracker;
 
class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        var tracker: Tracker = Tracker.init(this.applicationContext,"YOUR_SITE_PREFIX_HERE");
...

Step 5 – Change the site prefix of tracker to your own site prefix  

var tracker: Tracker = Tracker.init(this.applicationContext,"YOUR_SITE_PREFIX_HERE");

Step 6 – Turn on crash detection (optional)

In your app delegate where you set up tracker call track crashes 

var tracker: Tracker = Tracker.init(this.applicationContext,"YOUR_SITE_PREFIX_HERE");
tracker.trackCrashes();

Step 7 – set up timers  

import com.bluetriangle.analytics.Timer
...

var myTimer: Timer = Timer();
myTimer.setPageName("YOUR_PAGE_NAME");
myTimer.setTrafficSegmentName("YOUR_TRAFFIC_SEGMENT");
myTimer.start();
...

Step 8 – set up Custom Variables

import com.bluetriangle.analytics.Timer
...

var myTimer: Timer = Timer();
myTimer.setPageName("YOUR_PAGE_NAME");
myTimer.setTrafficSegmentName("YOUR_TRAFFIC_SEGMENT");
myTimer.setField("CV1","YOUR_CUSTOM_VARIABLE");
myTimer.start();
...

CV1 - CV5  Maps to Custom Variable 1 - 5 in the portal
CV6 - CV10 Maps to Custom Category 1 – 5 in the portal
CV11 - CV15 Maps to Variable 6-10 in the Portal
CN1 - CN20 is Custom Numeric 1 - 20

Step 9 – submit timer

var sharedTracker: Tracker = Tracker.getInstance();
sharedTracker.submitTimer(myTimer);

Full example of timer set up   

import com.bluetriangle.analytics.Timer
import com.bluetriangle.analytics.Tracker;

class MainActivity : AppCompatActivity() {

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    var tracker: Tracker = Tracker.init(this.applicationContext,"YOUR_SITE_PREFIX_HERE");
    tracker.trackCrashes();
    setContentView(R.layout.activity_main)
    setSupportActionBar(findViewById(R.id.toolbar))

    findViewById<FloatingActionButton>(R.id.fab).setOnClickListener { view ->
      var myTimer: Timer = Timer();
      myTimer.setPageName("YOUR_PAGE_NAME");
      myTimer.setTrafficSegmentName("YOUR_TRAFFIC_SEGMENT");
      myTimer.setField("CV1","YOUR_CUSTOM_VARIABLE");
      myTimer.start();
      Snackbar.make(view, "Replace with your own action", Snackbar.LENGTH_LONG).setAction("Action", null).show()
      var sharedTracker: Tracker = Tracker.getInstance();
      sharedTracker.submitTimer(myTimer);
    }
  }  
...