This article describes how to set up the Amazon Advertising DSP connector.

In this article:

Connector Actions

Action Name AudienceStream EventStream
Add Hashed Record
Add to Audience
Remove from Audience

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

When you add this connector you are prompted to accept the vendor's data platform policy.

After adding the connector, configure the following settings:

  • Api Base URLs
    Select your Api Base URL.
  • Amazon Advertiser ID
    Enter your Amazon Advertising account ID.

Click Done when you are finished configuring the connector.

Action Settings — Parameters and Options

Click Continue to configure the connector actions. Enter a name for the action and then 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 Hashed Record

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: 5000
  • Max time since oldest request: 10 minutes
  • Max size of requests: 5 MB

Parameters

Parameter Description
External ID
  • The external identifier for this record.
  • This can be any ID unique to the record in the caller's own identity space.
  • This identifier will be matched to hashed records in Amazon Ads and can then be used to add users to audiences.
Email Address (already SHA256 hashed)
  • Email address.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
Email Address (apply SHA256 hash)
  • Email address.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. 
First Name (already SHA256 hashed)
  • First Name.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
First Name (apply SHA256 hash)
  • First Name.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.
Last Name (already SHA256 hashed)
  • Last Name.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
Last Name (apply SHA256 hash)
  • Last Name.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.
Street Address (already SHA256 hashed)
  • Street Address.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
Street Address (apply SHA256 hash)
  • Street Address.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.
Phone Number (already SHA256 hashed)
  • Phone Number.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
Phone Number (apply SHA256 hash)
  • Phone Number.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.
City (already SHA256 hashed)
  • City.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
City (apply SHA256 hash)
  • City.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.
Postal Code (already SHA256 hashed)
  • Postal Code.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
Postal Code (apply SHA256 hash)
  • Postal Code.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.
State (already SHA256 hashed)
  • State.
  • Must be SHA256 Hashed. 
  • If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash. 
State (apply SHA256 hash)
  • State.
  • Must be SHA256 Hashed.
  • Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.

Action — Add to Audience

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

Parameters

Parameter Description
Audience ID Click “Create Audience” to create a new Amazon Ads audience.
To use an existing Tealium-created Amazon audience, enter its ID and click “Verify Audience ID” to verify that the audience is correct.
External ID An External ID previously sent to Amazon via hashed matching.
MAID Mobile advertising identifier.
Amazon Cookie Cookie obtained via a cookie sync.

Action — Remove from Audience

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

Parameters

Parameter Description
Audience ID To use an existing Tealium-created Amazon audience, enter its ID and click “Verify Audience ID” to verify that the audience is correct.
You can copy the audience ID created in the "Add to Audience" action configuration.
External ID An External ID previously sent to Amazon via hashed matching.
MAID Mobile advertising identifier.
Amazon Cookie Cookie obtained via a cookie sync.
Public