Help

Contentsquare and Heap

Contentsquare is a behavioral analytics platform that helps retailers understand how users interact with their app. It enables clients to capture in-app user behavior—such as taps, scrolls, and navigation flows—while ensuring data collection is managed through a dedicated privacy layer.

Heap is a digital insights platform that helps retailers understand user behavior across their app without the need for manual event tagging. It allows clients to automatically capture interaction data such as taps, screen views, and user flows.

Contentsquare and Heap are integrated into a single Poq SDK, referred to as the Contentsquare PoqSDK. Contentsquare uses AnalyticsEvent.VERSION_2.

To integrate Contentsquare and Heap into your application, follow these steps:

  1. Include the Contentsquare PoqSDK in your build.gradle: 
    implementation("com.poqstudio:analytics.contentsquare:$poqSdkVersion")
  2. Configure Contentsquare and Heap settings: Set all required IDs in the ContentSquareSettings object.
  3. Make sure the bundle IDs configured in ContentSquare match those used in the project.

Poq Settings

The Contentsquare PoqSDK is configurable via ContentSquareSettings. Through ContentSquareSettings you can configure:

  • heapEnvironmentId: Heap Environment ID — if this field is left empty, the Heap SDK will not initialize. This does not affect the initialization or functionality of the Contentsquare SDK.
  • heapLogLevel: Heap log level — defaults to LogLevel.NONE in release mode and LogLevel.ERROR in debug mode.

The Heap Environment ID can be found in the Heap console under: Account (left menu) → Manage → Projects → Select the target project. The ID will be displayed in the panel on the right.

Contentsquare Poq SDK provides one new deep link:

://contentsquare-privacy-settings: it opens the Contentsquare Privacy Settings screen.