Amazon Ads Conversions API

Amazon is a multinational technology company focusing on e-commerce, cloud computing, online advertising, digital streaming, and artificial intelligence. Using this destination you can import conversion event data in Amazon DSP.

Key features

The Amazon Ads Conversions API destination provides the following key features:

• Events structure: our Events reference model matches Amazon's conversion definitions/types, meaning that your data is properly bridged to the expected fields in an optimized way.

• Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.

• Automatic hashing: information is automatically hashed matching partner specifications.

• Smart mapping: data mapping can be readjusted using your datalayer defined fields.

Destination setup

Configuration

Settings	Description
Authentication	Required Your credentials with Amazon Ads as set in the Commanders Act interface following: Administration ➜ Connector Credentials ➜ Add connector credentials ➜ AmazonAds
API Base Url	Required Your selected Amazon API endpoint. More details are available by following this LINK.
Advertiser Id	Required Your account identifier you use to access the DSP. This is your DSP Advertiser ID. DSP Entity ID is not supported.
Profile Id	Required Select your profile identifier.
Conversion Definition Id	Required Select your conversion definition identifier.
Country	Required The country where the event originates from. E.g. "US". This value is based on ISO 3166-1 alpha-2.
Custom Event Properties	Map your custom event properties by setting their field names in Amazon property name and adding the values in Your value . Check with Amazon whether this option is activated for your specific account.

Quick reference

Commanders Act Events	Amazon Tracking
[Any Event] [1]	[Any Conversion Definitions/Types] [2]

[1] Use Destination filters to specify your matching events. [2] See Conversion Definition Id in Configuration for more details.

Field Mappings

Most properties can be remapped using our "Smart Mapping" feature. All Amazon properties are include in eventData.0 .

At least one identifier must be provided in matchKeys .

Commanders Act Properties	Amazon Properties
Country	countryCode [*]
event_name	name [*]
context.event_timestamp	timestamp [*]
Conversion Definition Id	conversionDefinitionId [*]
user.email_sha256 user.phone user.firstname user.lastname user.street user.city user.state user.zipcode context.device.advertising_id	matchKeys.X.values[0] [1]
(user.email_sha256 user.phone user.firstname user.lastname user.street user.city user.state user.zipcode context.device.advertising_id)	matchKeys.X.type [2]
items.length	unitsSold
value	value
currency	currencyCode
context.event_id	clientDedupeId [3]
partners.amazon.data_processing	dataProcessingOptions [4]

[*] Mandatory property. [1] At least one identifier must be provided. [2] Depending on the value provided in matchKeys.X.values[0] , this is one of the following values: EMAIL, PHONE, FIRST_NAME, LAST_NAME, ADDRESS, CITY, STATE, POSTAL or MAID. [3] The client specified id for the conversion event. For events with the same clientDedupeId only the latest event will be kept. [4] This is set with with LIMITED_DATA_USE when partners.amazon.data_processing is a non-empty string, non-false (boolean), non-zero (number) value.