Product Analytics data capture

This page instructs how to set up Product Analytics data capture in combination with Experience Analytics.

1. Initialize the SDK with your environment ID.

   • Product Analytics
   • CSQ Experience Platform (Early Access)

     Get Early Access to CSQ Experience Platform, our latest, all-in-one offering.

     Reach out to your Customer Success Manager to join the Early Access Program.

   import android.app.Application
   import com.contentsquare.CSQ
   
   class MyApplication : Application() {
     override fun onCreate() {
       super.onCreate()
   
       CSQ.start(
         context = this,
         StartConfig.withEnvironmentId(
           id = "YOUR_ENVIRONMENT_ID"
         )
       )
   
     }
   }

2. Apply the Contentsquare Gradle plugin to your Android application module to instrument your app code. If the root build file declares plugin versions with apply false, declare the version there and apply the plugin in the application module without repeating the version.

   • Kotlin
   • Groovy

   plugins {
     // ...
   
     id("com.contentsquare.gradle") version "1.1.0"
   }

   When upgrading from io.heap.gradle, remove the old plugin declaration. Do not apply both plugins to the same module.

3. Set up autocapture by adding enableViewAutocapture = true. With this option, CSQ.start() registers both Views and Jetpack Compose autocapture.

   • Product Analytics
   • CSQ Experience Platform (Early Access)

     Get Early Access to CSQ Experience Platform, our latest, all-in-one offering.

     Reach out to your Customer Success Manager to join the Early Access Program.

   import android.app.Application
   import com.contentsquare.CSQ
   
   class MyApplication : Application() {
     override fun onCreate() {
       super.onCreate()
   
       CSQ.start(
         context = this,
         StartConfig.withEnvironmentId(
           id = "YOUR_ENVIRONMENT_ID",
           options = AnalyticsOptions(
             enableViewAutocapture = true
           )
         )
       )
   
     }
   }

4. For Jetpack Compose, add the sdk-compose dependency.

   • Kotlin
   • Groovy

   dependencies {
     implementation("com.contentsquare.android:sdk:1.13.0")
     implementation("com.contentsquare.android:sdk-compose:1.13.0")
   }

5. (Optional) If your Product Analytics environment is hosted in the EU, set the baseUri option to https://mh.ba.contentsquare.net.

   • Product Analytics
   • CSQ Experience Platform (Early Access)

     Get Early Access to CSQ Experience Platform, our latest, all-in-one offering.

     Reach out to your Customer Success Manager to join the Early Access Program.

   import android.app.Application
   import com.contentsquare.CSQ
   
   class MyApplication : Application() {
     override fun onCreate() {
       super.onCreate()
   
       CSQ.start(
         context = this,
         StartConfig.withEnvironmentId(
           id = "YOUR_ENVIRONMENT_ID",
           options = AnalyticsOptions(
             enableViewAutocapture = true,
             baseUri = URI.create("https://mh.ba.contentsquare.net")
           )
         )
       )
     }
   }

6. Add disablePageviewAutocapture = true to prevent automatic screenviews and keep tracking screens with CSQ.trackScreenview(). Interaction autocapture stays on, but interactions have no automatic screenview to attach to. See the screenview options.

   • Product Analytics
   • CSQ Experience Platform (Early Access)

     Get Early Access to CSQ Experience Platform, our latest, all-in-one offering.

     Reach out to your Customer Success Manager to join the Early Access Program.

   import android.app.Application
   import com.contentsquare.CSQ
   
   class MyApplication : Application() {
     override fun onCreate() {
       super.onCreate()
   
       CSQ.start(
         context = this,
         StartConfig.withEnvironmentId(
           id = "YOUR_ENVIRONMENT_ID",
           options = AnalyticsOptions(
             enableViewAutocapture = true,
             disablePageviewAutocapture = true
           )
         )
       )
   
     }
   }