Extole Tag Setup Guide for Tealium iQ

Extole Tag Setup Guide for Tealium iQ

by ‎05-05-2017 01:50 PM - edited ‎06-01-2017 10:05 AM (143 Views)

This article describes how to install the Extole Tag in your Tealium iQ profile.

Table of Contents Placeholder

Prerequisites

  • jQuery - Required if you are using the HTML Element method of selection

Supported Versions

  • Extole v5.0

Tag Configuration

First, go to Tealium's Tag Marketplace and add the Extole Tag to your profile (how to add a Tag?).

After adding the Tag, configure the below settings:

  1. Title - The default is "Extole". You may change this to a custom name.
  2. Client Name: Your Extole unique client name.
  3. Target Content Method - (required) Choose a method for identifying where to place CTAs:
    • Element ID (default): Accepts a string Element ID (no need to include '#').
    • HTML Element: Accepts a CSS selector to match against (requires jQuery on the page).

Load Rules

Load Rules determine when and where to load an instance of this Tag on your site.

Recommended Load Rule: Load on all pages.

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 destination variables for the Extole Tag are built into its Data Mapping tab. Available categories are:

Standard

Destination Name Description
Client Name Extole unique client name.
Registration Custom Data Add custom data to the Registration event.
Conversion Custom Data Add custom data to the Conversion event.

Replace "custom" with your variable name, e.g., registration.date.

Calls-To-Action (CTA)

Destination Name Description
Global Header Map an element ID or selector to fire this CTA
Global Footer Map an element ID or selector to fire this CTA
Product Map an element ID or selector to fire this CTA
Product Custom Data Map the relevant product data to fire this CTA. Replace "custom" with your product data variable name
Confirmation Map an element ID or selector to fire this CTA
Referral Page Map an element ID or selector to fire this CTA
Account Page Map an element ID or selector to fire this CTA
Custom CTA Name Map to this destination to fire a custom CTA. Replace custom with your CTA name.
Add CTA Custom Data Map to this destination to send additional data with your CTA. Replace CTAname and custom with your CTA name and variable name respectively. Your CTA name can be one of the Standard CTA names from the list below or your custom CTA.

If you are not mapping an element id or selector, then make sure to map the string "n/a".

Standard CTA Names

CTA Name Value
Global Header global_header
Global Footer global_footer
Confirmation confirmation
Referral Page referral_page
Account Page my_account

Let's say, you want to send the date for a referral CTA. First, map to the Referral Page destination. Then map to the Add CTA custom data destination like so: cta.referral_page.data.date

E-Commerce

Since the Extole Tag is e-commerce enabled, it will automatically use the default E-Commerce Extension mappings. Manually mapping in this category is generally not needed unless:

  • you want to override any Extension mappings
  • your desired ecommerce variable is not offered in the Extension
Destination Name Description
Order ID Unique Order ID
Order Total Total value of order
Customer ID Unique customer ID

Event Triggers

Map to these destinations for triggering specific events on a page. To trigger an event:

  1. Select an event from the Trigger dropdown.
  2. In the Mapped Value field, enter the value of the Variable you are mapping.
  3. Click Add.

The event triggers when the supplied value is found in the Data Layer.

Destination Name Description
Registration Fires the registration event
Confirmation Fires the confirmation event with no Element ID

The Conversion event fires automatically when an Order ID is detected. No mapping is required.

Release Notes

v5.0, released March 16, 2017

  • Deprecated the old Extole tag.
  • Added support for multiple HTML element selection methods for placing CTAs.
  • Added support for Conversion and Registration events.

Vendor Documentation

Extole Asyc Documentation (requires login)