Amazon Ads Audience Management Connector Setup Guide | Server-Side Connectors

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: 6000
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:

Select your region from the Amazon Ads Account Region drop-down.
Click Establish Connection.
In the Amazon Sign in dialog, enter you 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:

Click Create AMC Connection.
In the Create AMC Connection dialog, select the AMC instance to use for audience uploads under the AMC Instance drop-down.
(Optional) Select a DSP Advertiser ID from the DSP Advertiser ID drop-down to synchronize the audience to DSP.
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 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 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.

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.

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 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 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.