This article describes how to set up the Clicktale tag in your iQ Tag Management (TiQ) account.

In this guide:

Table of Contents Placeholder

How it Works

Clicktale empowers brands to act on unique behavioral insights to turn user experiences into measurable advantages. For more information about Clicktale, a Contentsquare company, visit contentsquare.com.

What to Expect from this Integration

A working integration of iQ Tag Management with the Clicktale tag from the Tealium tag marketplace enables customers to seamlessly 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)

Clicktale

  • Clicktale real-time signals are available to all customers with access to the Data Export

Signals Extensions

Clicktale signals enable joint Tealium and Clicktale 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 Clicktale and AudienceStream. From there, customers can build powerful behavior-based segments that can be used across their marketing and advertising ecosystem.

Some of the features described below require configuration of additional JavaScript extensions. All required code will be provided by your Clicktale representative.

Signals Settings

This JavaScript code extension is required for any of the signals described below. When adding the JavaScript Code extension, ensure that the order of execution is set to execute specific signals code and that all signals extensions are scoped to your Clicktale tag.

The Clicktale Signals settings provide the following capture points associated with web page activity:

Friction

  • Repeated Scrolling
    repeated_scrolling_signal
    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
    constant_hovering_signal
    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)
    consecutive_click_signal
    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
    rage_click_signal
    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
    js_error_signal
    Identifies each time a click triggers a JavaScript error.

Fraud

  • Excessive Pasting
    excessive_paste_fraud_signal
    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
    excessive_reloads_fraud_signal
    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
    adblocker_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 Tealium's tag marketplace and add the Clicktale Carmel tag (Learn more about how to add a tag).

After adding the tag, configure the following settings in the Data Mappings section.

Tag Tips

  • Conversion fires when Order ID is set.
  • In order to send your Clicktale Replay Link to UDH, you must:
    • Contact your Clicktale 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 Clicktale:
    • Contact your Clicktale representative to enable the receiving of this data.
    • To send a Badge to Clicktale, navigate to the Badges tab in the mapping toolbox and enter the name by which the Badge will be identified in the Clicktale system.
    • To send all Audiences to Clicktale, 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.

  • Load this 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.
  • Clicktale Carmel is the default name.
  • When using multiple tags by the same vendor, assign a unique name.
partition
  • Partition.
  • The partition where data is sent.
  • Map to this variable to dynamically configure the server partition value.
project_guid
  • Project GUID.
  • Map to this variable to set the project guide field.
send_replay_link
  • Send Clicktale Replay Link
  • Values are true or false.
send_udh_audiences
  • Send UDH 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 Clicktale, enter the name by which the badge will be identified in Clicktale.
  • 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.