theTradeDesk Reference

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:

	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.
distinct_id	token	string	Required, Built-in	The unique ID for the user. Will be $user_id if identify has been called, otherwise is $device_id.
ttd_event_name	event_name	string	Optional	theTradeDesk event name. See valid event names.
value	value	number	Optional	The revenue-tracking value. Required when event_name is purchase.
currency	currency	string	Optional	The ISO 4217 currency code for the revenue value. Required when event_name is purchase.
order_id	order_id	string	Optional	The associated order identifier of the event.
items	items	object array	Optional	One or more items in the order. For object properties, see Item Properties.
adid	adid	string	Optional	The unique advertising ID for the event.
adid_type	adid_type	string	Optional	The type of the advertising ID, specified in the adid property: TDID, IDFA, AAID, DAID, NAID, IDL, EUID, or UID2. Required when adid is specified.
privacy_settings	privacy_settings	object	Optional	User privacy settings based on data privacy consent processing. For object properties, see Privacy Settings Properties.
td1-td10	td1-td10	string	Optional	Ten sequentially numbered custom dynamic properties that can be used to provide additional conversion metadata.
$ip	client_ip	list	Optional, Built-in	The client IPv4 or IPv6 IP address.
$referrer	referrer_url	list	Optional, Built-in	The website URL from where the event occurred, if any.

Freshpaint will deliver events to theTradeDesk only when a user arrives on your site by clicking on an ad that directs the user to a landing page that has Freshpaint installed. Without the impression id ($ttdimp) from the landing page, Freshpaint and theTradeDesk will not be able to attribute conversions.

View-Through Conversions and Retargeting

View-through conversions and retargeting are possible with TheTradeDesk when an adid is provided and adid_type are provided. See TheTradeDesk docs for more information on these parameters.

View-through conversions and retargeting are not possible in the absence of these parameters.