theTradeDesk Quick Start Guide

Send advertising events directly to theTradeDesk

Destination Info

  • Supports Track calls

  • Supports HIPAA mode

  • 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:





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 ttidimp

  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. 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:

  2. 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):

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

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

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




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


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.




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

If you are using more than one Advertiser ID for a given Freshpaint Environment, the following event property is required to specify an Advertiser ID other than the Primary configured Advertiser ID, and if in HIPAA mode, must be selected in the Recommended Properties Allow List:


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.

That's it! Now all you need to do to send an event to theTradeDesk is enable the destination in the Freshpaint event definition:

Navigate to your Freshpaint event, and toggle the destination on to enable the event to be sent to theTradeDesk destination:

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, and you have multiple Advertiser IDs enabled, you'll need to specify which Advertiser ID(s) you'd like to enable the event for in the event tag.

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