> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abconvert.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Contentsquare Integration

> Add an ABConvert dynamic variable to each assigned Contentsquare session so you can segment journeys, zones, and replays by test group.

<Warning>
  **Pre-release.** This guide applies when the Integrations hub is enabled for your ABConvert account. Configure the Contentsquare tag and approve your storefront domain in Contentsquare first.
</Warning>

Use Contentsquare dynamic variables to add ABConvert test context to session analysis. ABConvert enriches the existing Contentsquare queue; it does not install the Contentsquare tag or choose a Contentsquare project.

## Configure Contentsquare and ABConvert

<Steps>
  <Step title="Install and approve the Contentsquare tag">
    Add the Contentsquare tag to your storefront through the approved Shopify or theme installation path. Confirm the tag ID is approved for the storefront domain and follows your consent policy.
  </Step>

  <Step title="Enable Contentsquare in ABConvert">
    In **Integrations**, enable **Contentsquare**. ABConvert uses the existing `window._uxa` queue and does not need a separate API key.
  </Step>

  <Step title="Visit an eligible active test">
    Use a fresh, consented visitor on a storefront page where the test can assign them. ABConvert sends the dynamic variable after assignment.
  </Step>

  <Step title="Verify the dynamic variable">
    In Contentsquare, inspect the session or use the Contentsquare Tracking Setup Assistant. For network-level diagnosis, Contentsquare documents a `dvar` request after `trackDynamicVariable` runs.
  </Step>
</Steps>

## What Contentsquare receives

ABConvert sends one dynamic variable for each assigned test.

| Field                  | Value                      |
| ---------------------- | -------------------------- |
| Dynamic-variable key   | `AB_ABCONVERT_<test name>` |
| Dynamic-variable value | Test group name            |

The key is capped at 512 characters and the value at 255 characters. ABConvert uses a distinct key for each test, so concurrent tests retain separate values. Contentsquare keeps only the last value for a repeated key on the same pageview.

## Use cases

* **Compare journeys:** segment a journey analysis by an ABConvert dynamic variable to see where Control and another test group diverge.
* **Analyze zones:** filter page analysis or zone metrics by a test group before comparing clicks and scroll behavior.
* **Inspect replay context:** find a collected session with the dynamic variable before watching a replay for qualitative evidence.

## Things to know

* A Contentsquare tag loading on a page is not proof that its project accepts the domain or stored an ABConvert variable.
* Dynamic variables describe an assigned test group. They do not create a purchase event or calculate test significance.
* Do not put personal data in test or test-group names. Dynamic-variable values are sent to Contentsquare.
* Verify in an ordinary eligible browser. Preview and forced-assignment visits are excluded from ABConvert integration tagging.