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.
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:
Setting | Description |
---|
Name | Specify a unique name to identify the destination in RudderStack. |
Account Settings | Click Create Account > Connect with Amazon Audience and give RudderStack the required permissions to access your Amazon account. |
Select your Account | Select the required Advertiser ID from the dropdown. This is populated from your Amazon Audience account. |
Authorization Servers | Select the authorization server from the dropdown. Currently, RudderStack supports only North America. |
Send record
event
The Amazon Audience destination supports only record
events.
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 field | Amazon Audience property/event Base: records[0].hashedRecords.$. | Data Type |
---|
email | email | String |
phone | phone | String |
first_name | firstName | String |
last_name | lastName | String |
address | address | String |
city | city | String |
state | state | String |
country | country | String |
postalCode | postalCode | String |
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.
Create data provider audience.
The following table lists the mappings between RudderStack and Amazon fields:
RudderStack field | Amazon Audience property/event | Data Type |
---|
name (from RudderStack dashboard) Required | name | String |
description (from RudderStack dashboard) Required | description | String |
config.advertiserId Required | advertiserID | String |
DATA_PROVIDER | metadata.type | String |
config.source_country
US | metdadata.dataSourceCountry | String |
config.externalaudienceId
Ruderstack Audience | externalAudienceId | String |
config.ttl | ttl | String |
You must hash the above fields before sending them to Amazon.
Associate record data with the data provider audience.
The following table lists the mappings between RudderStack and Amazon fields:
RudderStack field | Amazon Audience property/event | Data Type |
---|
externalId (from step 1) Required | externalId | String |
audienceId (from step 2’s response) Required | audienceId | String |
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