Amazon Advertising Tag Setup Guide
This article describes how to set up the Amazon Advertising tag in your Tealium iQ Tag Management account.
Amazon Advertising System is an online advertising service which runs ads on the Amazon network. It is used to drive traffic and boost sales.
Tag tips
- Use mappings to override or dynamically set the tag configurations.
- To make Amazon Ads Event IDs available as server-side attributes for deduplication, set Generate Event ID to
true
and use the latest version of the Tealium Collect tag. - The event ID attribute names will be in the format
amazon_event_id_<EventName>_<TagUID>
(for exampleamazon_event_id_PageView_512.
).
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:
- Region: Enter your Amazon Advertising account region, for example:
NA
,EU
,FE
. - Tag IDs: Enter your Amazon Advertising tag IDs as a comma-separated list.
- Automatic Pageview Tracking: When Automatic Pageview Tracking is set to
true
, if the event equalsview
, the Amazon event is set to toPageview
. - Automatic Purchase Tracking: When Automatic Purchase Tracking is set to
true
, iforder_id
is defined, the Amazon event is set to toPurchase
. - Generate Event ID: Automatically generate an event ID for every Amazon Ads tracking event in the following format:
amazon_event_id_<EventName>_<TagUID>
. For example,amazon_event_id_PageView_512
.
Load rules
Load the tag on all pages or set conditions for when your tag will load. For more information, see About load rules.
Event Mapping
Amazon Advertising events are configured through data mappings by selecting a variable that maps to an event and entering a trigger. The trigger initiates the event when the variable is equal to a specific value, as demonstrated in the following use case.
Use Case: Add to Cart Event
To set up an add to cart event:
- Select
tealium_event
from the variable drop-down list and click Select a Destination. - In the Category section, select Events.
- Set the When mapped variable equals field to
cart_add
, which is the valuetealium_event
must equal to trigger an add to cart. - In the Trigger event drop-down list, select
AddToCart
, which is the event that is triggered whentealium_event
equalscart_add
.
If additional data needs to be sent with the add to cart event, use Custom Parameters to map additional event data.
The following example passes the product id as productid with the add to cart event:
- Select
product_id
from the variable drop-down list and click Select a Destination. - In the Category section, select Event-specific Parameters.
- Set the Destination field to the name
productid
for the Custom Parameter. - In the For event drop-down list, select the event
AddToCart
which the Custom Parameter collects with.
Test the mappings by using the Developer Tools offered by your browser.
- Use the Network Panel and filter for
Amazon
to display all the network requests containing amazon as a keyword. - Confirm the
AddToCart
event was successful by looking at the name of the request. - Open the request and select the Payload to view the Query String Parameters and see the values of the the data mappings that were configured:
AddToCart
andproductid
.
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 available categories are:
Tag Configuration
Variable | Type | Description |
---|---|---|
Region region |
String |
|
Tag IDs ids |
String |
|
Automatic Pageview Tracking auto_page_tracking |
Boolean |
|
Automatic Purchase Tracking auto_purchase_tracking |
Boolean |
|
Generate Event ID generate_event_id |
Boolean |
|
Event ID event_id |
String |
|
E-Commerce
Variable | Type | Description |
---|---|---|
Order ID order_id (Overrides _corder ) |
String |
|
Enhanced Conversions
Variable | Type | Description |
---|---|---|
Email email_raw |
String | Provide a plain text email address and the tag will whitespace trim and lowercase this value. |
Phone Number phonenumber |
String | Provide a plain text phone number and the tag will whitespace trim and remove symbols from this value. |
Hashed Email email |
String | A SHA256-hashed version of the user’s email address. |
GDPR Enabled gdpr.enabled |
Boolean | Whether GDPR restrictions are active on the account.
|
GDPR Consent gdpr.consent |
String | A valid IAB version 1 or 2 consent string. |
Events
To map events, refer to Create an Event Mapping.
Variable | Description |
---|---|
AddToCart | AddToCart |
Application | Application |
Checkout | Checkout |
Contact | Contact |
Lead | Lead |
Purchase | Purchase |
PageView | PageView |
Search | Search |
SignUp | SignUp |
Subscription | Subscription |
Custom | Custom |
Event-specific Parameters
To map events, refer to Create an Event Mapping.
In order to map a parameter for a specific event only, enter the name of the parameter you want to set and then select the name of the event for which you want to set that parameter.
To specify a custom event for the event-specific mapping to occur, select the Custom option from the Events drop-down list and enter the name of the custom event in the field that appears.
This page was last updated: April 12, 2024