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

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. Requests are queued until one of the following thresholds is met:

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	✓	✗

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:

API Base URL: Required. Select your API Base URL.

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	Click Create Audience to create a new audience. Click Verify Audience ID to verify the audience ID.
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, lowercased, and SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number and the connector will whitespace trim, lowercase, 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.

Action — Add Visitor to DSP Audience

Parameters

Parameter	Description
Audience ID	Click Create Audience to create a new audience. Click Verify Audience ID to verify the audience ID.
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, lowercased, and SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number and the connector will whitespace trim, lowercase, 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.