Amazon Ads Conversions Connector Setup Guide
This article describes how to set up the Amazon Ads Conversions connector.
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. |
This page was last updated: August 3, 2023