This article describes how to configure the Heap Tag in your iQ account.
First, go to Tealium's Tag Marketplace and add the Heap Tag to your profile (how to add a Tag?). After adding the Tag, configure the below settings:
Override, or dynamically populate, the Application ID and String Delimiter using Data Mappings.
Load Rules determine when and where to load an instance of this Tag on your site.
Recommended Load Rule: The default All Pages Rule.
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 Mapping Variables.
The destination variables for the Heap Tag are built into its Data Mapping toolbox under the following categories:
|Application ID||The app id value provided by Heap|
|User ID||Unique visitor identifier assigned by Heap|
|Track Event Properties (track.custom*)||Attach event properties to the event being tracked. Mapping to this destination triggers the
|Add Event Properties (addEventProperties.custom*)||Attach new event properties to the visitor's subsequent events (learn more).|
|Add User Properties (addUserProperties.custom*)||Attach new properties to a visitor profile (learn more)|
|String Delimiter||The delimiter character for separating array values.
NOTE: Mapping to this destination overrides the default semicolon delimiter.
* Replace "custom" with your specific value.
The Heap Tag automatically triggers any events that are defined in your Heap interface. But when you want to trigger events on the fly, without defining them in Heap first, you must map them in the Event Triggers category.
Triggering an event requires two things:
To map an event trigger,
Repeat if you want to add more triggers.
As the Tag loads on a page, it scans the Data Layer to see what value is populated in the mapped Variable. If it's equal to the supplied trigger string, the Tag fires the event.
In this example, the event
Purchase triggers on a page when the Data Layer Variable
page_type equals "order".
The Ecommerce Extension does not automatically map any e-commerce Variables for this Tag.