Contentsquare Android SDK Integration

Tested against CSQ SDK 1.11.x. The official documentation is the source of truth — see the References section to fetch the latest pages on demand.

MANDATORY FIRST STEP — Contentsquare project healthcheck

Before ANY Contentsquare work in a conversation — integration, debugging, configuration questions, code changes — run this healthcheck exactly once per conversation. Do not skip it. Do not defer it to later in the task.

1. Announce it first. Tell the user what you are about to do, for example:

   "Before we start, I'll run a quick healthcheck of your Contentsquare project: I'll ask for your data source ID (or read your app's application id if you don't have one), call the Contentsquare healthcheck endpoint, and show you the current project configuration. Then we'll continue."

2. Ask the user for their Contentsquare data source ID(s) first. For example: "Do you have a Contentsquare data source ID? There can be one or several." Use only the IDs the user gives — never invent one.

   • The user gives one or more data source IDs → check by data source ID only (v3). Skip step 3.
   • The user only has an environment ID → check by application id only (v2): an environment ID is not a data source ID and never works in the v3 path.
   • The user has none, does not know, or skips the question → check by application id only (v2).

3. Resolve the application id (only without a data source ID). Read applicationId from app/build.gradle or app/build.gradle.kts. If it is absent, fall back to namespace, then to the package attribute in AndroidManifest.xml. Resolve any variables or flavour suffixes to the literal id that ships.