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

Max number of requests: 500
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 Name	(Required) The name of the conversion to send.
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.
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 trims, lowercases, and hashes this value using an SHA256 hash.