This article describes how to set up the Contentsquare UX Analytics tag in your Tealium iQ Tag Management account.

In this article:

Table of Contents Placeholder

How it Works

UX Analytics allows you to understand how users perceive your site, what they do, where they spend time, when they hesitate, and why they leave your site or do not purchase a product by mapping heat, exposure, visibility, time spent, movements, clicks, and conversions.

Tag Tips

  • Conversion fires when Order ID is set.
  • Set Send Replay Link to True to make your Contentsquare replay link available as a server-side attribute. (Pending Feature)
  • When mapping a badge, enter the name as it should appear in Contentsquare.
  • Set Send All Audiences to True to send each audience to Contentsquare in the following format: _uxa.push(["trackDynamicVariable", {key: "Tealium Audience AUDIENCE ID", value: "AUDIENCE NAME"}]);
  • Supported E-Commerce extension parameters:
    • Order ID (_corder )
      • Required for transactions.
    • Order Total (_ctotal )
      • Required for transactions.
    • Shipping Amount (_cship )
    • Tax Amount (_ctax )
    • List of Product IDs (_cprod )
    • List of Names (_cprodname )
      • Required for transactions.
    • List of SKUs (_csku )
      • Required for transactions.
    • List of Categories (_ccat )
    • List of Quantities (_cquan )
      • Required for transactions.
    • List of Prices (_cprice )
      • Required for transactions.

Tag Configuration

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

After adding the tag, configure the following settings:

  • Tag ID
    • The Tag ID specific to your website.
  • Send Replay Link
    • This is pending feature and is not yet available.
    • Select True to make your Contentsquare Replay Link available as a server-side attribute.
  • Send All Audiences
    • Select True to send each audience with trackDynamicVariable as {key: "Tealium Audience AUDIENCE ID", value: "AUDIENCE NAME"} .
  • Send Vars to Contentsquare
    • Toggle whether or not to send vars to Contentsquare by selecting True or False.
  • Send Event Data to Replay
    • Select True to enable to send event data to Replay.
  • Ad Blocker Detection
    • Select True to enable Ad Blocker Detection.
  • Fraud Detection
    • Select True to enable Fraud Detection.
  • Friction Detection
    • Select True to enable Friction Detection

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
id_project
  • String
  • Tag ID
  • The Project Tag ID specific to your project.
  • Map to this variable to set the project guide field.
base_url
  • String
  • Base URL
send_audiences
  • String
  • Send All Audiences
SendVarsToCS
  • String
  • Boolean
  • Toggle to Send Vars to Contentsquare
SendEventsToReplay
  • String
  • Toggle to Send Events to Replay
  • Boolean
ad_blocker_detection
  • String
  • Toggle Ad Blocker Detection
  • Boolean
fraud_detection
  • String
  • Toggle Fraud Detection
  • Boolean
friction_detection
  • String
  • Toggle Friction Detection
  • Boolean
livesignals_url
  • String
  • LiveSignals File URL

E-Commerce

Variable Description
order_id
  • Order ID
  • Overrides _corder.
order_total
  • Order Total
  • Overrides _ctotal.
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.
product_sku
  • Array
  • List of SKUs
  • Overrides _csku.
product_category
  • Array
  • List of Categories
  • Overrides _ccat.
product_quantity
  • Array
  • List of Quantities
  • Overrides _cquan.
product_unit_price
  • Array
  • List of Prices
  • Overrides _cprice.

Custom

Variable Description
1 through 20
  • 1 through 20

Ad Block Detection

Variable Description
adBlockerEventName
  • String
  • Ad Blocker Event Name
adBlockerFileURL
  • String
  • Ad Blocker File URL
adBlockerTimer
  • Number
  • Ad Blocker Timer

Fraud Detection

Variable Description
excessivePasteLowThreshold
  • Number
  • Excessive Paste Low Threshold
excessivePasteMediumThreshold
  • Number
  • Excessive Paste Medium Threshold
excessivePasteHighThreshold
  • Number
  • Excessive Paste High Threshold
excessivePasteEventName
  • String
  • Excessive Paste Event Name
excessiveReloadLowThreshold
  • Number
  • Excessive Reload Low Threshold
excessiveReloadMediumThreshold
  • Number
  • Excessive Reload Medium Threshold
excessiveReloadHighThreshold
  • Number
  • Excessive Reload High Threshold
excessiveReloadEventName
  • String
  • Excessive Reload Event Name
fraudCondition
  • String
  • Fraud Condition

Friction Detection

Variable Description
consecutiveClickClickableThreshold
  • Number
  • Consecutive Click Clickable Threshold
consecutiveClickNonClickableThreshold
  • Number
  • Consecutive Click Non-clickable Threshold
consecutiveClickEventName
  • String
  • Consecutive Click Event Name
constantHoverThreshold
  • Number
  • Constant Hover Threshold
constantHoverEventName
  • String
  • Constant Hover Event Name
jsErrorClickThreshold
  • Number
  • JS Error Click Threshold
jsErrorClickEventName
  • String
  • JS Error Click Event Name
rageClickClickableThreshold
  • Number
  • Rage Click Clickable Threshold
rageClickNonClickableThreshold
  • Number
  • Rage Click Non-clickable Threshold
rageClickEventName
  • String
  • Rage Click Event Name
repeatedScrollMinPercentThreshold
  • Number
  • Repeated Scroll Minimum Percent Threshold
repeatedScrollMaxPercentThreshold
  • Number
  • Repeated Scroll Maximum Percent Threshold
repeatedScrollAmountThreshold
  • Number
  • Repeated Scroll Amount Threshold
repeatedScrollEventName
  • String
  • Repeated Scroll Event Name
Version history
Revision #:
2 of 2
Last update:
4 weeks ago
Updated by: