---
title: Getting Started with Product Analytics - Android
description: Integrate the CSQ SDK for Product Analytics into your Android app in minutes
lastUpdated: 08 July 2026
source_url:
  html: https://docs.contentsquare.com/en/csq-sdk-android/product-analytics/
  md: https://docs.contentsquare.com/en/csq-sdk-android/product-analytics/index.md
---

> Documentation index: https://docs.contentsquare.com/llms.txt
> Use this file to discover all available pages before exploring further.

This quick start guide shows you how to get Contentsquare Product Analytics set up in an Android application.

Faster implementation using agent skills

Use [Agent skills](https://docs.contentsquare.com/csq-sdk-android/product-analytics/using-agent-skills/) to let your AI coding assistant handle SDK setup, version migration, and feature implementation automatically.

Once you've completed the setup process, the Contentsquare SDK will capture a wide variety of user interactions in your application with no additional code required.

Upgrading

See our guides to upgrade to the CSQ SDK from the [Heap Core SDK](../product-analytics/upgrade-from-heap-core-sdk/) or the [Heap Classic SDK](../product-analytics/upgrade-from-heap-classic-sdk/).

## Install the SDK

1. In your app-level `build.gradle` file, add the dependency for the CSQ SDK and the CSQ Compose SDK.

   * Kotlin

     **build.gradle.kts**

     ```kotlin
     dependencies {
       implementation("com.contentsquare.android:sdk:1.11.2")
       implementation("com.contentsquare.android:sdk-compose:1.11.2")
     }
     ```

   * Groovy

     **build.gradle**

     ```groovy
     dependencies {
       implementation 'com.contentsquare.android:sdk:1.11.2'
       implementation 'com.contentsquare.android:sdk-compose:1.11.2'
     }
     ```

2. Add the Android View Autocapture Plugin to instrument your app code:

   * Kotlin

     **build.gradle.kts**

     ```kotlin
     plugins {
       // ...


       id("io.heap.gradle") version "1.1.1"
     }
     ```

   * Groovy

     **build.gradle**

     ```groovy
     plugins {
       // ...


       id 'io.heap.gradle' version "1.1.1"
     }
     ```

3. Once the dependencies and plugins have been added, sync Gradle and rebuild your application.

## Start the SDK

1. Configure and start the SDK with `CSQ.start()`.

   * Product Analytics

     **MyApplication.kt**

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

     Find your environment ID

     `YOUR_ENVIRONMENT_ID` is either provided to you by Contentsquare or you can find it in **Account** > **Manage** > **Projects** > \[Select your project] > **Environments** within the [Product Analytics web app ↗](https://heapanalytics.com/app/).

   * CSQ Experience Platform (Early Access)

     **MyApplication.kt**

     ```kotlin
     import android.app.Application
     import com.contentsquare.CSQ


     class MyApplication : Application() {
       override fun onCreate() {
         super.onCreate()


         CSQ.start(
           context = this,
           StartConfig.withDataSourceId(
             id = "YOUR_DATASOURCE_ID"
           )
         )
       }
     }
     ```

     Find your data source ID

     `YOUR_DATASOURCE_ID` is either provided to you by Contentsquare or you can find it in **Definitions** > **Data sources** > \[Expand your mobile data source] > \[Copy the App ID in step 1] within the [CSQ Experience Platform web app ↗](https://app.contentsquare.com/).

2. Enable autocapture by setting `enableViewAutocapture` to `true`.

   * Product Analytics

     **MyApplication.kt**

     ```kotlin
     CSQ.start(
       context = this,
       StartConfig.withEnvironmentId(
         id = "YOUR_ENVIRONMENT_ID",
         options = AnalyticsOptions(
           enableViewAutocapture = true
         )
       )
     )
     ```

   * CSQ Experience Platform (Early Access)

     **MyApplication.kt**

     ```kotlin
     CSQ.start(
       context = this,
       StartConfig.withDataSourceId(
         id = "YOUR_DATASOURCE_ID",
         options = AnalyticsOptions(
           enableViewAutocapture = true
         )
       )
     )
     ```

3. (Optional) For Jetpack Compose, register the Compose Autocapture SDK.

   * Product Analytics

     **MyApplication.kt**

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

   * CSQ Experience Platform (Early Access)

     **MyApplication.kt**

     ```kotlin
     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.withDataSourceId(
             id = "YOUR_DATASOURCE_ID",
             options = AnalyticsOptions(
               enableViewAutocapture = true
             )
           )
         )
       }
     }
     ```

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

   * Product Analytics

     **MyApplication.kt**

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

   * CSQ Experience Platform (Early Access)

     **MyApplication.kt**

     ```kotlin
     import android.app.Application
     import com.contentsquare.CSQ


     class MyApplication : Application() {
       override fun onCreate() {
         super.onCreate()


         CSQ.start(
           context = this,
           StartConfig.withDataSourceId(
             id = "YOUR_DATASOURCE_ID",
             options = AnalyticsOptions(
               enableViewAutocapture = true,
               baseUri = URI.create("https://mh.ba.contentsquare.net")
             )
           )
         )
       }
     }
     ```

5. Implement the `optIn()` API to forward user consent to the SDK, generate a user ID, and initiate tracking.

   * Product Analytics

     ```kotlin
     import android.app.Application
     import com.contentsquare.CSQ


     class MyApplication : Application() {
       override fun onCreate() {
           super.onCreate()
           CSQ.start(this, StartConfig.withEnvironmentId("YOUR_ENVIRONMENT_ID"))
       }
     }


     // ConsentActivity
     val optinButton: Button = findViewById(R.id.btn_accept_tracking)


     optinButton.setOnClickListener {
       CSQ.optIn()
       startActivity(Intent(this, MainActivity::class.java))
     }
     ```

   * CSQ Experience Platform (Early Access)

     ```kotlin
     import android.app.Application
     import com.contentsquare.CSQ


     class MyApplication : Application() {
       override fun onCreate() {
           super.onCreate()
           CSQ.start(this, StartConfig.withDataSourceId("YOUR_DATASOURCE_ID"))
       }
     }


     // ConsentActivity
     val optinButton: Button = findViewById(R.id.btn_accept_tracking)


     optinButton.setOnClickListener {
       CSQ.optIn()
       startActivity(Intent(this, MainActivity::class.java))
     }
     ```

   Once tracking has started, you're able to take full advantage of the CSQ SDK API to identify users, track custom events, and more.

   Contentsquare's Product Analytics module will also automatically start tracking a wide range of user interactions, view controller changes, and app version changes without any additional code.

6. Start your application, and check logs for this output:

   ```text
   [INFO] CSQ 1.11.2 for Product Analytics is attempting to start.
   ```

## Next steps

Our SDK offers a wide range of features to enhance your implementation, including extended tracking capabilities, and personal data masking.

[Track identity](track-identity/)Link anonymous and identified user data across sessions and devices for comprehensive analytics

[Track push notifications](track-push-notifications/)Track mobile notification interactions automatically

[Track events manually](track-events-manually/)Learn how to track custom events

[Hide sensitive data](hide-sensitive-data/)Protect sensitive data by disabling text capture, masking specific views, or ignoring interactions

Session Replay and Error Monitoring are both available with the [Experience Analytics extension](dxae-setup/), which you can purchase separately.

[Experience Analytics extension](dxae-setup/)