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.

In this guide:

Table of Contents Placeholder

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.

What to Expect From This Integration

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

Signals

Contentsquare signals enable joint Tealium and Contentsquare customers to identify real-time behaviors, trigger events, and activate on those signals through AudienceStream. Once a potential friction or fraud behavior is detected, these signals are automatically sent to both Contentsquare and AudienceStream. From there, customers can build powerful behavior-based segments that can be used across their marketing and advertising ecosystem.

The Contentsquare Signals settings provide the following capture points associated with web page activity and can easily be enabled by toggling them to True:

Friction

  • Repeated Scrolling
    Identifies when a visitor scans the page quickly and scrolls repeatedly from top to bottom. Identifies a potentially poor user experience or a frustrated visitor.
  • Constant Hovering
    Identifies when a visitor consistently hovers over the same element without clicking. This signal indicates a visitor’s intent or interest without clicking the element.
  • Consecutive Clicking (Clickable Element)
    Identifies when a visitor repeatedly clicks the same (clickable) element without a response from the page. The customer does not click any other element between clicks. This signal indicates a potential issue with the element.
  • Consecutive Clicking (Un-clickable Element)
    Identifies when a visitor repeatedly clicks the same (un-clickable) element without a response from the page. The customer does not click any other element between clicks. This signal indicates a potential design flaw.
  • Rage Clicking
    Identifies when a customer repeatedly clicks the same element without a response from the page. This event triggers regardless of whether customers click other elements in between clicks.
  • JavaScript Click Error
    Identifies each time a click triggers a JavaScript error.

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 identifies that an ad-blocker is present.

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

Tag Configuration

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

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

Tag Tips

  • Conversion fires when Order ID is set.
  • In order to send your Contentsquare Replay Link to UDH, you must:
    • Contact your Contentsquare representative to enable the generation of the replay link.
    • Set the Send Replay Link configuration 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, toggle the Send UDH Audiences toggle to True.

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

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.

    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.