Amazon DSP

How to link your account and export audiences to Amazon DSP

Amazon DSP enables advertisers to target various Amazon properties, including Amazon.com, IMDb, Twitch, and Fire TV. Additionally, it offers placements on Amazon-owned and operated sites, as well as third-party sites within the Amazon Publisher Services network, allowing for a comprehensive reach across multiple platforms to effectively engage audiences.

Adding Amazon DSP as a Destination

From the UI

You can create a new Amazon DSP destination from your DCN by going to the Integrations -> Destinations section in your navigation menu.

To connect your Amazon DSP account, just assign a name to your export destination and click "Create." You will be redirected to Amazon DSP, where you'll be required to authenticate and grant your DCN access to your advertiser account by signing in with an Amazon account associated with your Amazon DSP account.

You will then be redirected to Amazon in order to login to your account and grant grant your DCN access to the Amazon Ads API.

After clicking "Allow," you will be redirected to your DCN, where you'll find an "Advertiser ID" field displaying a list of all available advertisers linked to your Amazon DSP account. You can either choose an advertiser from this list or manually input the Advertiser ID for the specific advertiser you'd like to export to.

Note: Each destination can only support one advertiser account, if you would like to link your other advertiser accounts, you will have to create a new destination in your DCN.

From the CLI

From the CLI, input the following command. This will redirect you to your browser to authorize access and connect your Amazon DSP account with your DCN. Below is an example of the expected CLI output:

optable-cli destination create amazon-dsp amazon_dsp

{
  "id":  3,
  "kind":  "DESTINATION_KIND_AMAZON_DSP",
  "created_at":  "2023-04-06T18:48:29.113151900Z",
  "updated_at":  "2023-04-06T18:48:29.113151900Z",
  "name":  "amazon_dsp",
  "state":  "DESTINATION_STATE_SETUP",
  "amazon_dsp":  {
    "advertiser":  {}
  }
}

Once you grant your DCN access, you can then select the advertiser that you want to export to, these will appear in the response under "advertiser_options".

optable-cli destination get 3

{
  "id":  3,
  "kind":  "DESTINATION_KIND_AMAZON_DSP",
  "created_at":  "2023-04-06T18:48:29.113151Z",
  "updated_at":  "2023-04-06T18:48:40.784725Z",
  "name":  "amazon_dsp",
  "state":  "DESTINATION_STATE_SETUP",
  "amazon_dsp":  {
    "advertiser":  {},
    "advertiser_options":  [
      {
        "id":  "3484322347483",
        "name":  "Example",
        "region":  "NA"
      },
      {
        "id":  "9393749020",
        "name":  "Example2",
        "region":  "NA"
      }
    ]
  }
}

To choose the advertiser, use the following command and replace advertiser-id with the advertiser you want to export to and your DCN will respond with your completed Amazon DSP destinations configuration details.

optable-cli destination update amazon-dsp 3 --advertiser-id=586353118933041404 --region=NA 

{
  "id":  3,
  "kind":  "DESTINATION_KIND_AMAZON_DSP",
  "created_at":  "2023-04-06T18:48:29.113151Z",
  "updated_at":  "2023-04-06T18:49:58.192364300Z",
  "name":  "amazon_dsp",
  "state":  "DESTINATION_STATE_ACTIVE",
  "amazon_dsp":  {
    "advertiser":  {
      "id":  "3484322347483",
      "region":  "NA"
    }
  }
}

Your export destination is now ready to use and you can export to it following the instructions in the next section.

Finally, if you created the destination using your DCN UI you will be redirected to the destinations listing.

Exporting Audiences to Amazon DSP

From the UI

To export an audience to your Amazon DSP account, locate the desired audience and click the 'Export' button in the top-right corner. You will then be prompted to choose your preferred export destination from a list of available options.

Each export will create a new audience in your Amazon DSP account. If an audience exists with the same name as your DCN audience, the audience will be appended with a number and you will get a new audience ID.

From the CLI

From the CLI, enter the following:

optable-cli export create dv360 <audience-id> <destination-id>

Where:

  <audience-id>       Audience to export
  <destination-id>    Destination of the export

You can choose which ID or update method to send with:

--identifiers-filter=IDENTIFIERS-FILTER,...
                        Filter identifiers by type. Options are: email or 
                        phone. The options are not mutually
			exclusive except and can be combined. 

Here is an example of what your command should look like:

$ optable-cli audience export amazon-dsp 8 1 --frequency=now

Here is an example of the expected CLI output:

{
  "id":  8,
  "kind":  "EXPORT_CONFIGURATION_KIND_AMAZON_DSP",
  "audience":  {...},
  "destination":  {...},
  "identifiers_filter":  [
    "ID_KIND_EMAIL_HASH",
    "ID_KIND_PHONE_NUMBER",
    "ID_KIND_APPLE_IDFA",
    "ID_KIND_GOOGLE_GAID"
  ],
  ...
  "amazon_dsp":  {
    "data_provider_audience_id":  "400450668747643732"
  },
  "frequency":  "FREQUENCY_ONCE",
  ...
  "export_schedule":  {
    "start_time":  "2023-04-06T20:39:15.484433Z",
    "next_run_time":  "2023-04-06T20:39:15.484433Z"
  }
}

What Can I Export to Amazon DSP?

You can transfer emails, phone numbers, IDFAs, and GAIDs to your Amazon DSP account. Keep in mind that Amazon DSP does not accept empty audience exports; ensure that the audience you've selected includes the desired ID(s) for a successful export.

How Will My Export Appear in Amazon DSP?

Your export will appear in the Audiences section under "Advertiser Audiences" with the name of the audience that you exported from your DCN.

Where to locate your exported audience.