Extole Tag Setup Guide

Prerequisites

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

Supported Versions

• Extole v5.0

Tag Configuration

Navigate to the Tag Marketplace to add a new tag. For more information, see About tags.

When adding the tag, configure the following 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 the tag on all pages or set conditions for when your tag will load. For more information, see About load rules.

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 more information, see About data mappings.

The destination variables for the Extole Tag are built into its Data Mapping tab.

The 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, for instance 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