Amazon Ads Conversions 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
Documentation: Amazon API

Connector Actions

Action Name	AudienceStream	EventStream
Send Conversion	✗	✓

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.
Amazon Advertiser ID: Required. Enter your Amazon Advertising account ID.

Action settings — parameters and options

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 — Send Conversion

Batch Limits

This action 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: 100
Max time since oldest request: 10 minutes
Max size of requests: 1 MB

Parameters

Parameter	Description
Advertising Profile	Select an advertising profile for this conversion.
Conversion Definition	Select a conversion definition or click Create Definition to create a new definition.

Conversion Data

Parameter	Description
Country Code	(Required) The country where the user performing the event is located, in ISO 3166-1 alpha-2 format.
Conversion Time	The timestamp of the conversion in ISO format (`YYYY-MM-DDThh:mm:ssTZD`). If not mapped, the connector uses the event time.
Conversion Value	The value of the conversion.
Currency	The currency in ISO-4217 format. Only applicable for the `OFF_AMAZON_PURCHASES` conversion type.
Units Sold	The number of items purchased. Only applicable for the `OFF_AMAZON_PURCHASES` conversion type.
Dedupe ID	If you are tracking conversions in both the tag and the connector, specify a deduplication ID. The value should match for both events.

User Data

Parameter	Description
Email (already SHA256 hashed)	Provide an email address that has been already whitespace trimmed, lowercased, and SHA256 hashed.
Email (apply SHA256 hash)	When a plain text email address is provided, the connector whitespace trim, lowercase, and hashes this value using an SHA256 hash.
Phone (already SHA256 hashed)	Provide a phone number which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Phone (apply SHA256 hash)	Provide a plaintext 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 plaintext 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 plaintext Last name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Address (already SHA256 hashed)	Provide an address which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Address (apply SHA256 hash)	Provide a plaintext address 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 plaintext 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 plaintext 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 plaintext postal code and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
MAID	Mobile Identifier - MAID, ADID, IDFA, or FIREADID accepted.

For more information about formatting and normalization requirements, see Format audience file for hashing.