Skip to main content

What this is

Amazon Marketing Cloud (AMC) is a privacy-safe, cloud-based clean-room environment operated by Amazon Ads that stores pseudonymised, event-level Amazon Ads signals — impressions, clicks, and purchases — and lets you build audiences from custom queries. This integration sends audiences from Zeotap CDP into AMC as SHA-256 hashed identifiers plus optional PII attributes, so you can combine your first-party segments with Amazon Ads signals for overlap analysis, journey measurement, and Amazon DSP activation. It differs from the Amazon Conversions API integration, which forwards conversion events into Amazon DSP rather than audiences into AMC.

Prerequisites

Before you create the AMC Destination, make sure the following are in place:
  • An Amazon Marketing Cloud account. AMC accounts come in two forms: fully managed by Amazon (your Amazon point of contact creates the Connection ID for you) and self-serve (you create the Connection ID yourself via the Amazon Ads API).
  • A Connection ID issued by Amazon Ads that references the AMC instance and Amazon DSP advertiser you want to activate against. See Obtain a Connection ID below.
  • Amazon Ads sign-in credentials with authorisation to grant Zeotap CDP access to the referenced AMC instance.
  • The country in which the customer data is collected and the region (North America or Europe) to which your AMC instance is subscribed.

What this integration supports

The integration sends the following identifiers and attributes to AMC:
  • External User ID
  • Hashed Email Addresses (SHA-256)
  • Hashed Cellphone Numbers (SHA-256)
  • First Name
  • Last Name
  • Address
  • City
  • State
  • Postal
  • Country Code
The single action available is Send Identifiers and Attributes to AMC Audiences. This integration does not support ID Extension, Delete, or Delta Upload.

Obtain a Connection ID

A Connection in Amazon Ads is an object that stores the mapping of an AMC instance to an Amazon DSP advertiser; Amazon Ads uses it as the target for audience creation, targeting, and activation.
  • Fully managed AMC accounts — your Amazon point of contact provisions the Connection ID. Request it from them and paste it into the Destination configuration in Zeotap CDP.
  • Self-serve AMC accounts — call the Amazon Ads AmcpLinkAddConnectionV2 API with the required parameters and schema. The response returns the Connection ID. See the Amazon Ads API reference for the full request contract.
The Amazon Ads Connections API expects the following media type in the request headers:
Store the returned Connection ID for the Destination configuration step below.

Choose the country and region

Country — the country in which the customer data is collected. You select this from a dropdown in the Destination configuration; Zeotap CDP converts your selection into the 2-character ISO 3166 format required by AMC. Country can be set at two levels:
  • Audience-metadata level — the Country you choose while creating the Destination. It applies to every customer who qualifies for any audience linked to that Destination.
  • Record level — the field you map for Country Code on the Actions and Mapping screen. Zeotap CDP offers a catalogue field named User Source Country that stays up to date with the latest country of the customer entering the system; map User Source Country → Country Code to send the freshest per-record country to AMC.
Country selection at the audience-metadata and record levels in the AMC Destination configuration
When both are present and disagree, the record-level Country Code supersedes the audience-level Country. Confirm which behaviour you want before mapping Country Code.
Region — the region to which your AMC instance is subscribed. Select North America or Europe based on your Amazon DSP Advertiser Account region. Audiences reach connected AMC instances regardless of the endpoint region you select here.

Create the AMC Destination

Work through the Destination creation flow in the DESTINATIONS application of the Zeotap CDP App.
  1. In the DESTINATIONS application, click + Create Destination.
    Create Destination button in the DESTINATIONS application
  2. Under All Destinations, search for and select Amazon Marketing Cloud.
    Searching for Amazon Marketing Cloud under All Destinations
  3. On the Destination configuration screen, enter:
    • A name for the Destination in Destination Name.
    • The Connection ID for your advertiser account on AMC in Connector Id (see Obtain a Connection ID).
    • The country where the customer data is collected in Audience Country.
    • The region to which your AMC instance is subscribed in Account Region.
    AMC Destination configuration screen with the Destination Name, Connector Id, Audience Country and Account Region fields
  4. Click Connect Amazon Marketing Cloud. Sign in to your AMC account in the Amazon window that opens. Signing in grants Zeotap CDP permission to manage the referenced AMC instance.
    Amazon sign-in window for connecting Zeotap CDP to AMC
  5. Back in Zeotap CDP, confirm that the Access Token and Refresh Token fields have auto-populated, along with the Access Token expiry period. Click Next.
    Access Token and Refresh Token auto-populated after connecting to AMC
  6. On the Actions and Mapping screen, under Choose your Action, select Send Identifiers and Attributes to AMC Audiences. Under Map the Fields, map each Catalogue field to the corresponding AMC Destination field. Apply SHA-256 hashing to Email and Cellphone Number in your Catalogue mapping before sending.
    Actions and Mapping screen with the Send Identifiers and Attributes to AMC Audiences action selected
  7. Review the mapping and click Create Destination.
The Destination is now listed in the Audiences application and can be linked to any audience.

Verify the Destination is ready

Before linking an audience, confirm the three signals that show the Destination is configured correctly:
  • On the Destination configuration screen, the Access Token, Refresh Token, and Access Token expiry values are populated (not blank).
  • The Destination appears in the list in the Audiences application under the name you provided.
  • The Country and Region values match the AMC instance you intend to activate against.
For the full linking flow, see Link an Audience to the Destination.
The terms Audiences and Segments are used interchangeably to refer to customer cohorts belonging to a specific category — for example, a group of customers who are over 18 and who performed an addToCart event within the last 30 days.

Troubleshooting

Use this table to diagnose customer-observable conditions during Destination setup and activation. Resolution steps
  1. If Access Token and Refresh Token did not populate, click Connect to Amazon Marketing Cloud again and complete the Amazon sign-in flow to the end, granting Zeotap CDP the requested permissions.
  2. If the Connection ID is not recognised, retrieve it again — for fully managed accounts, from your Amazon point of contact; for self-serve accounts, by re-calling AmcpLinkAddConnectionV2 and copying the ID from the response. Update the Destination with the corrected ID.
  3. If a record-level country is overriding the audience-level Country unintentionally, remove the mapping to Country Code on the Actions and Mapping screen, or remap it to User Source Country for the freshest per-record value.
  4. If none of the above resolves the condition, contact your Zeotap customer success representative. Include: the Destination name, the Connection ID, the audience ID, the Country and Region you configured, and the timestamp of the last successful activation.

FAQ

Yes. The integration accepts Email and Cellphone Number only as SHA-256 hashed values. Apply the hash in your Catalogue mapping before the Destination sends the record to AMC.
Select the region that matches your Amazon DSP Advertiser Account region (North America or Europe). Audiences reach connected AMC instances regardless of the endpoint region you select.
The record-level value wins. Map Country Code only when you want the per-record country to override the audience-metadata Country you selected during Destination creation.
This integration sends audiences into AMC’s clean-room environment for analysis and DSP activation. The Amazon Conversions API integration is a separate, server-to-server pipeline that forwards conversion events into Amazon DSP.

Next steps

Last modified on November 5, 2026