Extole Tag Setup Guide for Tealium iQ

[#1]

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)