The Trade Desk Real Time Conversions

The Trade Desk is a leading digital advertising technology platform for efficient campaign management. It offers comprehensive tools to target audiences across diverse channels like video, mobile, and display.

RudderStack lets you send real-time conversion events data to The Trade Desk via cloud mode using The Trade Desk Real-Time Conversion Events API. Find the open source transformer code for this destination in the GitHub repository.

Setup

In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for The Trade Desk Real Time Conversions.

Connection settings

Configure the following settings to set up The Trade Desk Real Time Conversions as a destination in RudderStack:

• Name: Specify a unique name to identify the destination in RudderStack.
• Advertiser ID: Enter the advertiser ID from the Advertiser Preferences page in the The Trade Desk dashboard.
• Tracking Tag ID: Enter the tracking tag ID. Contact your The Trade Desk representative to obtain it.

Connection mode

Specify how you want to route events from your source to The Trade Desk Real Time Conversions.

RudderStack supports sending event data to The Trade Desk Real Time Conversions via the following connection modes:

Event mapping

Click Set-up mapping to map your RudderStack events/properties to specific The Trade Desk Real Time Conversions events/properties. RudderStack also provides the JSON mapper to set these mappings.

Use Event tab to map the respective events:

Use Custom properties tab to map the custom properties (td1 to td10) by entering the property path from where RudderStack maps it to the corresponding The Trade Desk Real Time Conversions’ custom property:

Track

The track call lets you capture user events along with the properties associated with them.

A sample track call is shown below:

rudderanalytics.track("Product Added", {
  product_id: "622c6f5d5cf86a4c77358033",
  sku: "8472-998-0112",
  category: "Games",
  name: "Cones of Dunshire",
  brand: "Wyatt Games",
  variant: "expansion pack",
  price: 49.99,
  quantity: 5,
  coupon: "PREORDER15",
  position: 1,
  url: "https://www.website.com/product/path",
  image_url: "https://www.website.com/product/path.webp",
})

Supported events

RudderStack supports all The Trade Desk Real Time Conversions events. Out of these, RudderStack maps the following standard ecommerce events as:

You can map the rest of The Trade Desk Real Time Conversions events (listed below) in the RudderStack dashboard in the Map RudderStack to The Trade Desk Events setting:

• searchitem
• searchcategory
• login
• messagebusiness
• direction
• sitevisit

RudderStack sends all the other unmapped events as is.

Property mappings

The following table details the property mappings between RudderStack and The Trade Desk Real Time Conversions:

adid mapping

RudderStack maps the advertising ID (adid) from context.device.advertisingId if the os information is provided in context.os.name.

RudderStack maps the type of advertising ID (adid_type) as:

• AAID if os’s name is android
• NAID if os’s name is windows
• IDFA if os’s name is ios

Sample context object:

{
   "app": {
      "build": "1.0.0",
      "name": "RudderLabs Android SDK",
      "namespace": "com.rudderlabs.javascript",
      "version": "1.0.5"
   },
   "device": {
      "adTrackingEnabled": true,
      "advertisingId": "test-advertisingId",
      "id": "test-id",
      "manufacturer": "Google",
      "model": "AOSP on IA Emulator",
      "name": "generic_x86_arm",
      "type": "ios",
      "attTrackingStatus": 3
   },

   "locale": "en-GB",
   "os": {
      "name": "ios",
      "version": ""
   }
}

If the device information is absent, you can also pass the advertising ID (adid) in the context’s externalId object:

{
  "externalId": [
    {
      "type": "daid",
      "id": "test-daid"
    }
  ]
}

value mapping

For Product Added, Product Viewed, and Product Added to Wishlist events, RudderStack maps price*quantity to The Trade Desk Real Time Conversions’ value field.

For Order Completed, and Checkout Started events, RudderStack maps revenue/value to The Trade Desk Real Time Conversions’ value field.

items mapping

For Order Completed, Checkout Started, and Cart Viewed event events, RudderStack maps the individual products inside the products array to The Trade Desk Real Time Conversions’ item array.

For single product events, that is, Product Added, Product Viewed, and Product Added to Wishlist, RudderStack maps the root-level properties to single item in the items array of The Trade Desk Real Time Conversions:

privacy_settings mapping

RudderStack maps the following privacy settings (privacy_settings) from the integration object:

Sample integration object:

{
  All: true,
  THE_TRADE_DESK: {
    privacy_settings: [
      {
        privacy_type: 'GDPR',
        is_applicable: 1,
        consent_string: 'ok',
      },
    ],
  },
};

data_processing_option mapping

RudderStack maps the following data processing options (data_processing_option) from the integration object:

Sample integration object:

{
  All: true,
  THE_TRADE_DESK: {
    policies: ['LDU'],
    region: 'US-CA'
  },
};

Questions? Contact us by email or on Slack