theTradeDesk Reference

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:

	Client-side	Server-side
Web
Mobile
Server

This is a reference document for the theTradeDesk destination. For information on how to set up this integration, see the theTradeDesk Quick Start Guide

Events

When you send an event to theTradeDesk from Freshpaint, Freshpaint will create an event in theTradeDesk by hitting theTradeDesk's Real-Time Conversion Events endpoint in theTradeDesk.

Track Events

When you send an event to theTradeDesk, you can track conversions from your ads based on those events.

Below are the Required, Recommended, and Optional properties which are mapped to theTradeDesk request:

Freshpaint property	theTradeDesk parameter	Type	Required? Recommended?	Description
$ttdimp	imp	string	Required	A 36-character string (including dashes) that serves as the unique ID for the impression to which the event is attributed. When in HIPAA mode, is a Required Allow List property.
tracker_id	tracker_id	string	Required	The platform ID of the event tracker. Example value: hc7ihke When in HIPAA mode, is a Required Allow List property.
value	value	number	Optional	When specified, the default currency is used.
privacy_settings	privacy_settings	object	Optional	User privacy settings based on data privacy consent processing. For object properties, see Privacy Settings Properties.
data_processing_option	data_procession_option	object	Optional	A data processing option to pass users' opt-out choices, such as Limited Data Use (LDU), in applicable US states. This is an alternative to the GPP string in the privacy_settings, see Data Processing Options

Click-Through Conversion

For click-through conversions some additional configuration is needed on creatives within the trade desk. A macro will need to be added to the landing page URL that will cause theTradeDesk to include the impression id as part of the URL of the click. Freshpaint will automatically look for the URL parameter of ttdimp when installed on the page.

View-Through Conversions

Freshpaint can track view-through conversions and send them to theTradeDesk using the Freshpaint Impression Pixel.

On the impression pixel configuration dialog within the destination configuration page within Freshpaint ensure that either IP or Cookie based matching is turned on. Also ensure any creatives within theTradeDesk are configured to include the pixel URL and setting provided within the destination configuration page.

If you use CM360 as your Ad Tech platform, please refer to this setup guide once you have finished setting up theTradeDesk destination in Freshpaint

Impression Pixel config in theTradeDesk destination configuration

Configuring the impression pixel does not require sharing an IP address or Cookie with theTradeDesk. Freshpaint will do the attribution by matching either the IP address or Cookie to an impression that is seen by the Freshpaint Impression Pixel and if a match is found will send the impression id to theTradeDesk.