theTradeDesk Quick Start Guide

Send advertising events directly to theTradeDesk

Destination Info

When no suffix is specified, all configured Advertiser IDs are selected for inclusion / exclusion.

  • Connection Modes:

Client-side
Server-side

Web

Mobile

Server

Getting Started

What You'll Need

  1. Your theTradeDesk Advertiser ID

  2. Image Pixel IDs / tracker_ids for your conversions

  3. Advertising media configured in your theTradeDesk account to specify ttdimp

  4. Advertiser ID configured in Freshpaint

  5. Conversion Events configured in your Freshpaint account, or GTM tags using the Google Tag Manager integration

To set up theTradeDesk with Freshpaint, follow these steps:

  1. Make sure you have the appropriate access in both Freshpaint and theTradeDesk:

    1. Contact your Freshpaint Account Manager to request access to this destination. Once you have that, we will help you step by step through the configuration process

    2. Contact your Agency & theTradeDesk pod to complete necessary legal documentation. These documents are referred to as ‘API Order Form’ and ‘Access Letter’. These documents are required by theTradeDesk to set up Freshpaint on your theTradeDesk account.

  2. Create your conversion funnel, and create events in Freshpaint to track your conversions.

  3. Find the Advertiser ID in your theTradeDesk account. Be sure you have the desired Advertiser selected, then find the Advertiser ID from the URL when navigating to Inventory -> Site/App in theTradeDesk UI. It should look similar to 4w1ba8e:

  4. Set up an Image Pixel in theTradeDesk

    1. The owner of theTradeDesk account will need to apply for legal for approval (vendor attribution) for all new pixels through theTradeDesk. This is required by theTradeDesk.

  5. Get the Image Pixel ID(s) for your conversions. These may be found by navigating to Data -> Image Pixels in theTradeDesk UI (if using the Google Tag Manager integration, these are populated from your migrated theTradeDesk Static Tracking Tags):

  6. For click through conversions:

    1. Creatives hosted in theTradeDesk: Configure all media assets used by your theTradeDesk account to include ttdimp in the landing page URL: ttdimp=%%TTD_IMPRESSIONID%%

    2. Creatives hosted in CM360: Refer to this guide once you have followed the rest of the steps on this page.

  7. Go to the theTradeDesk configuration page in Freshpaint and configure the Advertiser ID:

  8. (Optional) For view through conversions:

    1. In order to track view through conversions with theTradeDesk, enable the Impression Pixel from the Freshpaint configuration page. See View Through Conversions for more detailed instructions on this step.

    2. You'll need to apply the Freshpaint Impression Pixel to your campaign creative in theTradeDesk

If you use CM360 as your Ad Tech Platform, please follow this guide once you are done configuring theTradeDesk destination in Freshpaint.

Required Properties

The following event properties are required in order to attribute events to specific ads, and if in HIPAA mode, must be selected in the Required Properties Allow List.

Freshpaint property

theTradeDesk parameter

Type

Description

$ttdimp

All advertising media must include the following in the URL: ttdimp=%%TTD_IMPRESSIONID%%

string

ttdimp (theTradeDesk impression ID) is generated at ad bid time and appended to the landing page URL. Freshpaint will automatically capture ttdimp for events from your website. If you wish, you may provide $ttdimp as an event property to override the automatically captured value.

tracker_id

tracker_id

string

The Image Pixel ID associated with a conversion, as described above.

There are other optional parameters you can add to your events in order to achieve different use cases. You can view the full list of parameters here.

To send an event to theTradeDesk, you'll need to enable the destination for the event:

If you'd like to send an autotrack event from your event library to theTradeDesk, navigate to your Freshpaint event definition and toggle the destination on to enable the event to be sent to theTradeDesk:

If you've configured multiple Advertiser IDs, you'll need to toggle each pixel individually for each Freshpaint event.

If you're using Google Tag Manager to send data to The Trade Desk, you'd simply create a tag with the Freshpaint tag template in Google Tag Manager and select the tag type "theTradeDesk". If you have multiple Advertiser IDs enabled for theTradeDesk, you'll need to specify which Advertiser ID(s) you'd like to enable the event for in the event tag.

You'll need to include the image pixel ID from theTradeDesk with the conversion event. You can do with by creating a constant property transformation in Freshpaint.

Set up a test campaign in theTradeDesk

  1. Set up a test campaign that targets a small audiences and set your budget to 1000 impressions ($10-50 budget)

  2. Attach a creative that has the Freshpaint Impression Pixel

  3. Verify impressions and clicks are flowing into Freshpaint correctly by working with your Customer Success Engineer

  4. Verify in Freshpaint that the events triggering and flowing through to successfully to theTradeDesk by using Freshpaint's Liveview and Event Verification tools

Confirm and Validate Conversions in theTradeDesk

Congratulations! Once you have confirmed conversion in theTradeDesk, you have finished setting up this integration.

You can find more detailed documentation on this integration in the theTradeDesk Reference

Last updated