Setup Guide

Send your event data from RudderStack to Amazon Audience.

This guide will help you set up Amazon Audience as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Amazon.

info
Make sure you have already set up a Reverse ETL source in RudderStack before following the steps in this guide.

Setup

In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for Amazon Audience.

Connection settings

Configure the following settings to set up Amazon Audience as a destination in RudderStack:

SettingDescription
NameSpecify a unique name to identify the destination in RudderStack.
Account SettingsClick Create Account > Connect with Amazon Audience and give RudderStack the required permissions to access your Amazon account.
Select your AccountSelect the required Advertiser ID from the dropdown. This is populated from your Amazon Audience account.
Authorization ServersSelect the authorization server from the dropdown. Currently, RudderStack supports only North America.

Send record event

The Amazon Audience destination supports only record events.

  1. Upload record data and provide an externalId of your choice to each record. It is used later to associate the record to a data provider audience. If not provided, RudderStack assigns Rudderstack_${sha256(users)} as the default externalId.

    The following table lists the mappings between RudderStack and Amazon fields:

    RudderStack fieldAmazon Audience property/event Base: records[0].hashedRecords.$.Data Type
    emailemailString
    phonephoneString
    first_namefirstNameString
    last_namelastNameString
    addressaddressString
    citycityString
    statestateString
    countrycountryString
    postalCodepostalCodeString
info

Note that:

  • You must format and hash the above fields before sending them to Amazon.
  • If you are passing the phone field, and:
    • The country is US, you just need to send the hashed phone number.
    • The country is not US, you must send the hashed phone number along with the country name in country property.
  1. Create data provider audience.

    The following table lists the mappings between RudderStack and Amazon fields:

    RudderStack fieldAmazon Audience property/eventData Type
    name (from RudderStack dashboard)
    Required
    nameString
    description (from RudderStack dashboard)
    Required
    descriptionString
    config.advertiserId
    Required
    advertiserIDString
    DATA_PROVIDERmetadata.typeString
    config.source_country
    US
    metdadata.dataSourceCountryString
    config.externalaudienceId
    Ruderstack Audience
    externalAudienceIdString
    config.ttlttlString
info
You must hash the above fields before sending them to Amazon.
  1. Associate record data with the data provider audience.

    The following table lists the mappings between RudderStack and Amazon fields:

    RudderStack fieldAmazon Audience property/eventData Type
    externalId (from step 1)
    Required
    externalIdString
    audienceId (from step 2’s response)
    Required
    audienceIdString

Next steps

FAQ

What might be the reason for below error while creating the data provider audience?

 {
    errorType: 'INVALID_INPUT',
    message: 'Existing name: string, New name: khfyuc',
    fieldName: 'name',
},
{
  errorType: 'INVALID_INPUT',
  message: 'Existing description: string, New description: strinogiycvg1',
  fieldName: 'description',
},

You can try changing your external_audience_id which is unique for each audience. That should resolve the issue.


Questions? Contact us by email or on Slack