LiveIntent Tag Setup Guide
This article describes how to set up the LiveIntent tag.
Tag Configuration
First, go to the Tealium Tag Marketplace and add the LiveIntent tag to your profile (See Add a tag).
After adding the tag, configure the below settings:
- App ID: Your unique App ID provided by LiveIntent.
Load Rules
Load Rules determine when and where to load an instance of this tag on your site.
Recommended Load Rule: 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 LiveIntent tag are built into its Data Mapping tab. Available categories are:
Standard
Destination Name | Description |
---|---|
App ID (app_id ) |
Map to this destination to override or dynamically set the App ID |
Content/Category/Conversion Name (name ) |
Typically used to:
|
Content ID (contentID ) |
A product ID that matches the product feed |
Hashed User Email (emailHash ) |
The customer’s email address as an MD5 hashed string |
User Email (email ) |
The customer’s email address in plain text |
E-Commerce
Since the LiveIntent 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 e-commerce variable is not offered in the extension
Destination Name | Description |
---|---|
Order ID (order_id ) |
Unique identifier for this order. Use this to override the default e-commerce value _corder . |
Order Total (order_total ) |
The total revenue for this order. Use this to override the default e-commerce value _ctotal . |
Order Currency (order_currency ) |
Use this to override the default e-commerce value _ccurrency . |
List of Product IDs (product_id ) |
The product ID for each line item. Use this to override the default e-commerce value _cprod . |
List of Quantities (product_quantity ) |
Quantity of product for each line item. Use this to override the default e-commerce value _cquan . |
List of Prices (product_unit_price ) |
The price of each item at point of sale. Use this to override the default e-commerce value _cprice . |
Events
Map to these destinations for triggering specific events on a page. To trigger an event:
- Select an event from the drop-down list.
You may choose from the predefined list or create a event. For a event, enter a name with which to identify it. - In the Trigger field, enter the value of the variable being mapped.
- To map more events, click the + button and repeat steps 1 and 2.
- Click Apply.
The event triggers when the supplied value is found in the data layer.
Destination Name | Description |
---|---|
View Content (content_view ) |
A view of any content page which requires tracking |
View Category (category_view ) |
A view of a category page |
View Search Results (search ) |
A view of a search results page |
Purchase (purchase ) |
Customer has completed an order |
Add Product to Cart (cart_add ) |
Customer has added one or more items to the cart |
Remove Product from Cart (cart_remove ) |
Customer has removed one or more items from the cart |
Custom | Input a name for a custom event. |
Event Parameters
Map to these destinations if you wish to pass additional data with the event(s) you mapped earlier.
Parameters are only used with predefined events. See Event Specifications to learn how to pass a parameter with a Custom event.
To pass a parameter with a predefined event:
- Event: Select a LiveIntent event from the drop-down list.
- Parameter: Select a LiveIntent parameter from the drop-down list.
- For a Custom parameter, enter a name with which to identify it.
- Click + Add.
Destination Name | Description |
---|---|
User Email (email ) |
Use to overwrite the standard configuration value on a per event basis. |
Content/Category/Conversion Name (name ) |
Use to overwrite the standard configuration value on a per event basis. |
Content ID (contentId ) |
Use to overwrite thestandard configuration value on a per event basis. |
Content Type (contentType ) |
The type of page being viewed. For example, Product , LandingPage , Article , Hotel , Flight , Destination . |
Hashed User Email ( emailHash ) |
Use to overwrite the standard configuration value on a per event basis. |
Page Number (currentPage ) |
The page number of the current page. |
Search Term (searchTerm ) |
The term used in the search. |
Product IDs (itemIds ) |
An array of product IDs that are shown on the page. |
Custom | Custom parameter to be passed with a predefined event. |
Custom Event Data
Map to these destinations if you wish to pass a custom parameter with a custom event that you mapped in the events tab.
To map a Custom Event Data variable:
- Event Action: Enter the name of the Custom Event exactly as specified in the Events tab.
- Parameter: Enter the name of the Parameter you wish to send.
- Click + Add.
Vendor Documentation
This page was last updated: July 12, 2018