Amazon Ads Audience Management Connector Setup Guide

Amazon Ads Audience Management streamlines the upload, management, and use of audiences within Amazon Marketing Cloud (AMC). With the Amazon Ads Audience connector, you can create and upload audiences through the Audience Management Service that are eligible for follow-on actions through the Amazon DSP, AMC UI workflows, or API actions, such as AMC rule-based audiences.

This connector can add visitors to either AMC or DSP audiences. For AMC audiences, you must create an AMC connection during the Configuration process. For DSP audiences, you must select an Advertiser ID when you create the DSP audience.

API Information

This connector uses the following vendor API:

• API Name: Amazon Ads API
• API Version: v1.0
• API Endpoint: https://advertising-api.amazon.com

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 6,000
• Max time since oldest request: 60 minutes
• Max size of requests: 1 MB

Connector Actions

Action Name	AudienceStream	EventStream
Add Visitor to AMC Audience	✓	✓
Add Visitor to DSP Audience	✓	✓
Remove Visitor from Audience	✓	✓

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.

After adding the connector, configure the following settings:

• Amazon Ads Account Region
  • Required. Select the region of your Amazon Ads Account.

Amazon authentication

To authenticate the connector with Amazon:

1. Select your region from the Amazon Ads Account Region drop-down.
2. Click Establish Connection.
3. In the Amazon Sign in dialog, enter your Amazon credentials.

AMC audience connection

AMC audiences require a connection object to configure an audience. Amazon stores connections in objects that store the mapping of AMC instances and DSP audiences.

To establish an AMC connection with Amazon:

1. Click Create AMC Connection.
2. In the Create AMC Connection dialog, select the AMC instance to use for audience uploads under the AMC Instance drop-down.
3. (Optional) Select a DSP Advertiser ID from the DSP Advertiser ID drop-down to synchronize the audience to DSP.
4. Click Done and then click Create.

Country code

The country code is a two-character string in ISO 3166 format that indicates from which country the data was collected. Country code is an optional parameter, but we strongly recommend that you include it when uploading data. A country code added to records overrides the country code added to an audience.

For more information, see Amazon Ads: Country Code.

Action settings — Actions

Enter a name for the action and select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Action — Add Visitor to AMC Audience

Parameters

Parameter	Description
Audience ID	The Audience ID to add a visitor to. Click Create Audience to create a new audience. In the Create Audience dialog, select an AMC Connection from the drop-down. Enter an Audience Name. Enter an audience description in the Description field. Click Done. Click Verify Audience ID to verify the audience ID. Audiences that you create with this connector prepend the prefix Tealium: to the audience name before they are sent to Amazon.
External User ID	Select a non-Amazon user ID.
Email Address (already SHA256 hashed)	Provide an email address which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Email Address (apply SHA256 hash)	Provide a plain text email address and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Phone Number (already SHA256 hashed)	Provide a phone number which has been already whitespace trimmed and SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number and the connector will whitespace trim and hash this value using SHA256 hash.
First Name (already SHA256 hashed)	Provide a first name which has been already whitespace trimmed, lowercased, and SHA256 hashed.
First Name (apply SHA256 hash)	Provide a plain text first name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Last Name (already SHA256 hashed)	Provide a last name that has been already whitespace trimmed, lowercased, and SHA256 hashed.
Last Name (apply SHA256 hash)	Provide a plain text last name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
City (already SHA256 hashed)	Provide a city that has been already whitespace trimmed, lowercased, and SHA256 hashed.
City (apply SHA256 hash)	Provide a plain text city and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
State (already SHA256 hashed)	Provide a state that has been already whitespace trimmed, lowercased, and SHA256 hashed.
State (apply SHA256 hash)	Provide a plain text state and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Postal Code (already SHA256 hashed)	Provide a postal code that has been already whitespace trimmed, lowercased, and SHA256 hashed.
Postal Code (apply SHA256 hash)	Provide a plain text postal code and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Country Code	Provide a two-character string in ISO 3166 format that indicates from which country the data was collected. A country code added to records overrides the country code added to an audience.

Consent

When using the Add Visitor to AMC Audience action, the connector sends the value GRANTED for the amznAdStorage and amznUserData parameters. To prevent non-consented visitors from being added to lists, create an audience with rules that check visitor profile consent status. Then use the Remove Visitor from Audience action to remove visitors that have not given consent from lists.

Action — Add Visitor to DSP Audience

Parameters

Parameter	Description
Audience ID	The Audience ID to add a visitor to. Click Create Audience to create a new audience. In the Create Audience dialog, select a DSP Advertiser from the drop-down. Enter an Audience Name. Enter an audience description in the Description field. Enter a Data Source Country. This is a Digital Markets Act (DMA)-related field that represents where the user data in an audience is collected from. Default value UNKNOWN will be applied if not set. Click Done. Click Verify Audience ID to verify the audience ID. Audiences that you create with this connector prepend the prefix Tealium: to the audience name before they are sent to Amazon.
External User ID	Select a non-Amazon user ID.
Email Address (already SHA256 hashed)	Provide an email address which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Email Address (apply SHA256 hash)	Provide a plain text email address and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Phone Number (already SHA256 hashed)	Provide a phone number which has been already whitespace trimmed and SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number and the connector will whitespace trim and hash this value using SHA256 hash.
First Name (already SHA256 hashed)	Provide a first name which has been already whitespace trimmed, lowercased and SHA256 hashed.
First Name (apply SHA256 hash)	Provide a plain text first name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Last Name (already SHA256 hashed)	Provide a last name which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Last Name (apply SHA256 hash)	Provide a plain text last name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
City (already SHA256 hashed)	Provide a city which has been already whitespace trimmed, lowercased, and SHA256 hashed.
City (apply SHA256 hash)	Provide a plain text city and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
State (already SHA256 hashed)	Provide a state which has been already whitespace trimmed, lowercased, and SHA256 hashed.
State (apply SHA256 hash)	Provide a plain text state and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Postal Code (already SHA256 hashed)	Provide a postal code which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Postal Code (apply SHA256 hash)	Provide a plain text postal code and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Country Code	Provide a two-character string in ISO 3166 format that indicates from which country the data was collected. A country code added to records overrides the country code added to an audience.

Consent

When using the Add Visitor to DSP Audience action, the connector sends the value GRANTED for the amznAdStorage and amznUserData parameters. To prevent non-consented visitors from being added to lists, create an audience with rules that check visitor profile consent status. Then use the Remove Visitor from Audience action to remove visitors that have not given consent from lists.

Action — Remove Visitor from Audience

Parameters

Parameter	Description
Audience ID	To use an existing Tealium-created Amazon audience, enter its ID and click Verify Audience ID to verify that the audience is correct. You can copy the audience ID created in the Add to Audience action configuration.
External User ID	Select a non-Amazon user ID.
Email Address (already SHA256 hashed)	Provide an email address which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Email Address (apply SHA256 hash)	Provide a plain text email address and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Phone Number (already SHA256 hashed)	Provide a phone number which has been already whitespace trimmed and SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number and the connector will whitespace trim and hash this value using SHA256 hash.
First Name (already SHA256 hashed)	Provide a first name which has been already whitespace trimmed, lowercased, and SHA256 hashed.
First Name (apply SHA256 hash)	Provide a plain text first name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Last Name (already SHA256 hashed)	Provide a last name that has been already whitespace trimmed, lowercased, and SHA256 hashed.
Last Name (apply SHA256 hash)	Provide a plain text last name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
City (already SHA256 hashed)	Provide a city that has been already whitespace trimmed, lowercased, and SHA256 hashed.
City (apply SHA256 hash)	Provide a plain text city and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
State (already SHA256 hashed)	Provide a state that has been already whitespace trimmed, lowercased, and SHA256 hashed.
State (apply SHA256 hash)	Provide a plain text state and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Postal Code (already SHA256 hashed)	Provide a postal code which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Postal Code (apply SHA256 hash)	Provide a plain text postal code and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.