Extole Tag Setup Guide
This article describes how to set up the Extole tag.
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:
- Title: The default is
Extole
. You may change this to a custom name. - Client Name: Your Extole unique client name.
- 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:
- Select an event from the Trigger dropdown.
- In the Mapped Value field, enter the value of the Variable you are mapping.
- 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
This page was last updated: June 1, 2017