Contentsquare iOS SDK Integration

This skill helps AI agents integrate or upgrade the Contentsquare iOS SDK in client applications.

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 bundle 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 bundle 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 bundle id only (v2).

3. Resolve the bundle id (only without a data source ID). Read PRODUCT_BUNDLE_IDENTIFIER from the Xcode project (*.xcodeproj/project.pbxproj), or CFBundleIdentifier from Info.plist. Resolve any $(...) build-setting variables to their literal value before using it.