You can use the Amazon DSP Data Provider Export Integration connectors to export segment data to Amazon DSP.
This Data Connector is in Beta. For more information, contact support@treasuredata.com. |
Basic knowledge of Amazon DSP and an advertiser account
Basic Knowledge of Treasure Data: Authentication, Query, Results Export, and (optionally) Workflow.
The External Audience ID
is the key to specify the target Audiences on Amazon (it is unique to all audiences). The values of this field will be unique for each Advertiser account.
The job may split the result set into multiple batches. In the case of one batch fail, the connector will not revert successfully uploaded batches.
The prefixes as required per Amazon DSP API (COOKIE- or MAID-) will be added by the connector. Do not add these prefixes manually in the result set.
The connector will not update Audience Metadata.
Null or empty column data will be ignored
Result output schema must have at least maid
or cookie
or both cookie
and maid
column in their metadata
maid
and cookie
column must be in String
data type
Maximum length for a cookie
field is 1999 characters
In Treasure Data, you must create and configure the data connection, to be used during export, prior to running your query. As part of the data connection, you provide authentication to access the integration.
Open TD Console.
Navigate to Integrations Hub > Catalog.
Search for and select Amazon DSP Data Provider.
The following dialog opens.
Choose the Region of your advertiser account
Enter your Advertiser ID. Then select Continue.
Enter a name for your connection.
Select Done.
Create or reuse a query. Sometimes you need to define the column mapping in the query.
When exporting your data to Amazon DSP, you must provide the following parameter values:
Parameter | Description |
---|---|
Audience Name (required) | The name of audience you would like to create. |
Audience Description (optional) | Description for your audience. |
External Audience ID (required) | Unique key for your audience. |
Time to live (required) | The time in seconds when the audience will stay valid. |
Operation (required) | Operation to perform on the output data (add or remove). |
Ignore Invalid Records | During the time data is sent to Amazon DSP, If the check box is ticked and there are incorrect records or errors, they will be skipped and continue to send data to the last row. Otherwise an exception will be thrown |
To export results:
Open the TD Console.
Navigate to Data Workbench > Queries.
Select the query that you plan to use to export data.
For example:
SELECT a_cookie_column AS cookie, a_maid_column AS maid FROM your_table; |
Select Export Results located at top of your query editor.
The Choose Integration dialog opens.
You have two options when selecting a connection to use to export the results:
using an existing connection
creating a new one
Type the connection name in the search box to filter.
Select your connection.
Select Next.
Type values for Audience Name, Audience Description, External Audience ID, Time to live, Operation and Ignore Invalid Records.
Select Create New Integration.
Type a Name for your connection.
Select your region from Region.
Type your advertiser id in Advertiser ID.
Select Next.
Type values for Audience Name, Audience Description, External Audience ID, Time to live, Operation and Ignore Invalid Records.
Select Done.
You can use Scheduled Jobs with Result Export, to periodically write the output result to a target destination that you specify.
timezone: UTC _export: td: database: sample_datasets +td-result-into-target: td>: queries/sample.sql result_connection: your_connections_name result_settings: region: NA advertiser_id: 12345 audience_name: This is a test audience audience_description: This is for testing purpose external_audience_id: test_audiences time_to_live: 3600 operation: Add ignore_error: false |
To learn more about using data connectors in a workflow, review Workflows and Machine Learning.