The Trade Desk

How to link your account and export audiences to The Trade Desk DSP

The Trade Desk (TTD) is a demand-side platform (DSP) to which you can export your audiences for real time ad targeting based on your own first party data.

Adding The Trade Desk as a Destination

From the UI

You can create a new TTD destination from your DCN by going to the Integrations -> Destinations section in your navigation menu or by using the CLI. (see above tab).

Step 1: Select The Trade Desk in Integrations -> Destinations

To add your TTD account, you will need to enter the name of this destination (this is how your destination will appear across the platform), your Advertiser ID and Secret Key.

To find your Advertiser ID & Secret Key, to to The Trade Desk, select your advertiser and go to Preferences -> First Party Data Credentials.

Step 2: Enter your Advertiser ID & Secret Key

Once created you can then toggle which identifier types you want to enable at export time as well as map custom to TDID (The Trade Desk ID) and RampID

(Optional) Step 3: In the Identifiers tab, you can manage which identifiers are available at export time.

From the CLI

From the CLI, enter the following:

optable-cli destination create ttd <name> <advertiserid> <advertiserkey>

To find your Advertiser ID and Secret Key you will have to:

1. Login to your TTD account.

2. Choose which advertiser you wish to export to.

3. Go to Preferences

4. Search for "First Party Data Credentials" this is where you will see your Advertiser ID and Advertiser Secret Key.

Once you obtain the Advertiser ID and the Advertiser Secret Key you can enter the command above. Here is an example of the expected CLI output:

{
  "id": 6,
  "kind": "DESTINATION_KIND_TTD",
  "created_at": "2022-09-28T14:12:01.196007420Z",
  "updated_at": "2022-09-28T14:12:01.196007420Z",
  "name": "TTDfromCLI",
  "state": "DESTINATION_STATE_ACTIVE",
  "ttd": {
    "advertiser_id": "suwujsl"
  }
}

Finally, if you created the destination using your DCN UI you will be redirected to the destinations listing. If you used the CLI, you will be able to export directly from the command line.

Exporting Audiences to The Trade Desk

From the UI

To export to your TTD account, navigate to the audience you want to export and click export in the top right. From there you will be asked to select your preferred TTD export destination from a list of all available destinations.

Export Configuration Example

When exporting to The Trade Desk, a segment will be created with the name of the audience you selected. You can only append to a segment, so when re-exporting an audience, all new IDs will be appended to the original segment. You can also set Expiry/TTL at export time. Each time you export an audience to a destination supporting Expiry/TTL you will reset the timer. This will ensure that stale segments don't remain in your export destinations for longer than necessary.

From the CLI

From the CLI, enter the following:

optable-cli export create ttd <audience-id> <destination-id> <segment> <ttl-days>

Where:

  <audience-id>       Audience to export.
  <destination-id>    Destination of the export.
  <segment>           Segment name to add the IDs to.
  <ttl-days>          Amount of time (in days) during which IDs remain active.

You can choose which ID to send with:

--identifiers-filter=IDENTIFIERS-FILTER,...
                             Filter identifiers by type. Options are: idfa,
                             gaid. Defaults to all types if omitted.

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

$ optable-cli export create ttd 119 6 my-segment 30

Here is an example of the expected CLI output:

{
  "id": 94,
  "created_at": "2022-09-28T14:16:13.956080408Z",
  "updated_at": "2022-09-28T14:16:13.956080408Z",
  "destination": {
    "id": 6,
    "kind": "DESTINATION_KIND_TTD",
    "created_at": "2022-09-28T14:12:01.196007Z",
    "updated_at": "2022-09-28T14:12:01.196007Z",
    "name": "TTDfromCLI",
    "state": "DESTINATION_STATE_ACTIVE"
  },
  "audience": {
    "id": 119,
    "name": "My TTD Audience",
    "kind": "AUDIENCE_KIND_QUERY",
    "created_at": "2022-08-18T16:39:37.823716Z",
    "updated_at": "2022-09-08T12:40:32.432216Z",
    "insights_computed_at": "2022-09-08T12:40:32.429581Z",
    "state": "AUDIENCE_STATE_ACTIVE",
    "activation": {
      "keyword": "5dcfkl9dc"
    }
  },
  "state": "EXPORT_STATE_PENDING",
  "identifiers_filter": [
    "ID_KIND_APPLE_IDFA",
    "ID_KIND_GOOGLE_GAID",
  ],
  "ttd": {
    "segment": "CLIEXPORT",
    "ttl_days": 30
  }
}

What Can I Export to The Trade Desk?

You can export emails and phone numbers as UID 2.0 IDs as well as GAIDs, IDFAs, ID5 IDs, and EU NetIDs. Your DCN automatically translates hashed Email addresses and phone numbers to UID 2.0 IDs at export time.

The Trade Desk only supports emails and phone numbers as UID 2.0

If you select emails and/or phone numbers, your DCN will automatically generate UID 2.0s for you on each export attempt.

How Will My Export Appear in The Trade Desk?

Your export will appear under the Optable 1PD data provider as a segment within the advertiser you chose to export to. The name of the export will be the name of the audience you chose to export.