theTradeDesk Quick Start Guide
Send advertising events directly to theTradeDesk
Destination Info
Supports Track calls
Supports HIPAA mode
Supports Freshpaint Impression Pixel
Supports forwarding from the Google Tag Manager Integration
Refer to this destination as theTradeDesk in the Integrations object
If you've configured multiple Advertiser IDs, you can choose a specific one by suffixing the Advertiser ID, such as: theTradeDesk::4w1ba8e. You can retrieve this value from theTradeDesk configuration page for the Advertiser ID of interest.
When no suffix is specified, all configured Advertiser IDs are selected for inclusion / exclusion.
Connection Modes:
Web
Mobile
Server
Getting Started
What You'll Need
Your theTradeDesk Advertiser ID
Image Pixel IDs / tracker_ids for your conversions
Advertising media configured in your theTradeDesk account to specify
ttdimp
Advertiser ID configured in Freshpaint
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:
Make sure you have the appropriate access in both Freshpaint and theTradeDesk:
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
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.
Create your conversion funnel, and create events in Freshpaint to track your conversions.
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:
Set up an Image Pixel in theTradeDesk
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.
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):
For click through conversions:
Creatives hosted in theTradeDesk: Configure all media assets used by your theTradeDesk account to include
ttdimp
in the landing page URL:ttdimp=%%TTD_IMPRESSIONID%%
Creatives hosted in CM360: Refer to this guide once you have followed the rest of the steps on this page.
Go to the theTradeDesk configuration page in Freshpaint and configure the Advertiser ID:
(Optional) For view through conversions:
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.
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
Set up a test campaign that targets a small audiences and set your budget to 1000 impressions ($10-50 budget)
Attach a creative that has the Freshpaint Impression Pixel
Verify impressions and clicks are flowing into Freshpaint correctly by working with your Customer Success Engineer
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