Contentsquare UX Analytics Tag Setup Guide

[#1]

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 )
  • Order Currency (_ccurrency
  • 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.
order_ccurrency	Currency type Overrides _ccurrency.
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