Tealium + Contentsquare Integration Guide

This article describes how to get the most out of Tealium and Contentsquare by setting up the Contentsquare UX Analytics tag in your Tealium iQ Tag Management account and enabling the transmission of Tealium audiences and Visitor badges to Contentsquare.

A working integration of iQ Tag Management with the Contentsquare tag from the Tealium tag marketplace enables customers to execute session replays associated with clickstream data in order to detect and minimize end customer friction associated with tagged web pages.


  • Tealium
    • iQ Tag Management
    • AudienceStream
    • EventStream (optional)
  • Contentsquare
    • Contentsquare Business Edition or higher

How it works

Contentsquare empowers brands to act on unique behavioral insights to turn user experiences into measurable advantages. Contentsquare daily transforms trillions of digital behaviors into intelligent visualizations and recommendations that can be used to grow revenue, increase loyalty, and fuel innovation. Users can access benchmarks and predictive scoring based on leading global data sets of digital behavior across geographies and industries.

For more information, visit contentsquare.com.


  • Excessive Pasting
    Triggers when thresholds are met that identify abnormal and potentially fraudulent pasting behavior within the same visitor session. There are three (3) levels of Fraud likelihood: low, medium, and high.
  • Excessive Reload
    Triggers when thresholds are met that identify abnormal and potentially fraudulent reload behavior within the same visitor session. There are three (3) levels of Fraud likelihood: low, medium, and high

Ad blocking

  • Ad Blocker Signal
    Identifies when or if certain files are blocked, which identifies that an ad-blocker is present.

You can optionally use signals from your EventStream event specifications and your AudienceStream visitor attributes.

Tag tips

  • Conversion fires when Order ID is set.

  • To make your Contentsquare Replay Link available as a server-side attribute:

    • Contact your Contentsquare representative to enable the generation of the replay link.
    • Set Send Replay Link to True.
  • The Contentsquare tag automatically detects the Tealium account and profile loading on the page and sends the replay link there. To send the replay link to a different account or profile, override the default values by mapping the desired account and profile to the tealium_account and tealium_profile destinations, respectively.

  • To pass Tealium Audiences and Badges to Contentsquare:

    • Contact your Contentsquare representative to enable the receiving of this data.
    • To send a badge to Contentsquare, navigate to the Badges tab in the mapping toolbox and enter the name by which the badge will be identified in the Contentsquare system.
    • To send all audiences to Contentsquare, set Send All Audiences to True.

Tag configuration

First, go to the Tealium tag marketplace and add the Contentsquare UX User Analytics tag (Learn more about how to add a tag).

See: Contentsquare UX User Analytics Tag Setup Guide

After adding the tag, go to the Data Mappings section to configure any additional mappings.

Load rules

Load Rules determine when and where to load an instance of this tag. The ‘Load on All Pages’ rule is the default load rule.

To load this tag on a specific page, create a new load rule with the relevant conditions and load the Contentsquare tag on the page where you want to track the visitor’s mouse movements.


You must set tealium_datasource in your data layer to allow Contentsquare to send data server-side.

  1. Go to Server-Side > Data Sources.
  2. Add the HTTP API data source
  3. Set the name to “Contentsquare Server-Side Events”.

When you finish, note the data source key. In iQ Tag Management, use an extension to assign this value to the variable tealium_datasource.

If you are running the Tealium Universal Tag (utag.js) version 4.41 or older, you must also set the following variables:

  • tealium_account
  • tealium_profile
  • tealium_visitor_id

These variables are set automatically in version 4.42+.

Data Mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see Data Mappings.

The available categories are:


Variable Description
  • Required.
  • Identifies the tag instance.
  • Contentsquare UX Analytics is the default name.
  • When using multiple tags by the same vendor, assign a unique name.
  • The Project Tag ID specific to your project.
  • Map to this variable to set the project guide field.
  • Base URL
  • Send Contentsquare Replay Link
  • Values are true or false.
  • Also known as contensquare_replay_link. Note: This variable and session replay capability is currently in development for Contentsquare tag and is expected to be released in H1 2020.
  • Send Customer Data Hub (CDH) audiences.
  • Values are true or false.
  • Tealium account.
  • Tealium profile.


Variable Description
  • Order ID.
  • Overrides _corder.
  • Required for transactions.
  • Order total.
  • Overrides _ctotal.
  • Required for transactions.
  • Shipping amount.
  • Overrides _cship.
  • Tax amount.
  • Overrides _ctax.
  • Array
  • List of Product IDs.
  • Overrides _cprod.
  • Array
  • List of Names.
  • Overrides _cprodname.
  • Required for transactions.
  • Array
  • List of SKUs.
  • Overrides _csku.
  • Required for transactions.
  • Array
  • List of Categories.
  • Overrides _ccat.
  • Array
  • List of Quantities.
  • Overrides _cquan.
  • Required for transactions.
  • Array
  • List of Prices.
  • Overrides _cprice.
  • Required for transactions.


Variable Description
  • Badge Identifier.
  • To send the mapped badge to Contentsquare, enter the name by which the badge will be identified in Contentsquare.
  • Tealium automatically includes the badge title as a child property of a new object send_udh_data
  • Your badge name will appear as mapped to send_udh_data.

Was this page helpful?

This page was last updated: January 7, 2023