Tealium + Contentsquare Integration Guide | Technology Partners

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.

Prerequisites

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.

Previously, Fraud and Ad blocking triggers were available as configuration settings in the Contentsquare tag. These settings are now built-in to the tag and enabled by default.

Fraud

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 signifies 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.

Extensions

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

Go to Server-Side > Data Sources.
Add the HTTP API data source
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:

Standard

Variable	Description
`title`	Required. Identifies the tag instance. Contentsquare UX Analytics is the default name. When using multiple tags by the same vendor, assign a unique name.
`id_project`	The Project Tag ID specific to your project. Map to this variable to set the project guide field.
`base_url`	Base URL
`send_replay_link`	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_udh_audiences`	Send Customer Data Hub (CDH) audiences. Values are true or false.
`tealium_account`	Tealium account.
`tealium_profile`	Tealium profile.

E-Commerce

Variable	Description
`order_id`	Order ID. Overrides `_corder`. Required for transactions.
`order_total`	Order total. Overrides `_ctotal`. Required for transactions.
`order_shipping`	Shipping amount. Overrides `_cship`.
`order_tax`	Tax amount. Overrides `_ctax`.
`product_id`	Array List of Product IDs. Overrides `_cprod`.
`product_name`	Array List of Names. Overrides `_cprodname`. Required for transactions.
`product_sku`	Array List of SKUs. Overrides `_csku`. Required for transactions.
`product_category`	Array List of Categories. Overrides `_ccat`.
`product_quantity`	Array List of Quantities. Overrides `_cquan`. Required for transactions.
`product_unit_price`	Array List of Prices. Overrides `_cprice`. Required for transactions.

Badges

Variable	Description
`title`	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`.