Set up 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.

   • Standalone
   • Unified CSQ

     Onboard to Unified CSQ, our latest, all-in-one platform offering.

     Reach out to your Customer Success Manager for more information.

   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. Add the Android View Autocapture Plugin to instrument your app code:

   • Kotlin
   • Groovy

   plugins {
     // ...
   
     id("io.heap.gradle") version "1.1.1"
   }

1. Set up autocapture by adding enableViewAutocapture = true.

   • Standalone
   • Unified CSQ

     Onboard to Unified CSQ, our latest, all-in-one platform offering.

     Reach out to your Customer Success Manager for more information.

   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
           )
         )
       )
   
     }
   }

1. (Optional) For Jetpack Compose, add the dedicated import and register the Compose Autocapture SDK.

   • Kotlin
   • Groovy

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

   • Standalone
   • Unified CSQ

     Onboard to Unified CSQ, our latest, all-in-one platform offering.

     Reach out to your Customer Success Manager for more information.

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

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

   • Standalone
   • Unified CSQ

     Onboard to Unified CSQ, our latest, all-in-one platform offering.

     Reach out to your Customer Success Manager for more information.

   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")
           )
         )
       )
     }
   }

1. Add the disablePageviewAutocapture: true option to the configuration.

   • Standalone
   • Unified CSQ

     Onboard to Unified CSQ, our latest, all-in-one platform offering.

     Reach out to your Customer Success Manager for more information.

   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
           )
         )
       )
   
     }
   }