# theTradeDesk Reference

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/readme/hipaa-mode)
* Supports [Freshpaint Impression Pixel](https://documentation.freshpaint.io/integrations/impression-pixel)
* Supports forwarding from the [Google Tag Manager Integration](https://documentation.freshpaint.io/integrations/google-tag-manager-integration)
* Refer to this destination as **theTradeDesk** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-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.  

{% hint style="info" %}
When no suffix is specified, all configured Advertiser IDs are selected for inclusion / exclusion.
{% endhint %}

* Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"> </th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

This is a reference document for the theTradeDesk destination. For information on how to set up this integration, see the[ ](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/google-ads-conversion-api/google-ads-conversion-api-quick-start-guide)[thetradedesk-quick-start-guide](https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/thetradedesk/thetradedesk-quick-start-guide "mention")

### 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](https://partner.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi) 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:

<table data-header-hidden data-full-width="true"><thead><tr><th width="213"></th><th width="199"></th><th width="96"></th><th width="157"></th><th></th></tr></thead><tbody><tr><td><strong>Freshpaint</strong><br><strong>property</strong></td><td><strong>theTradeDesk</strong><br><strong>parameter</strong></td><td><strong>Type</strong></td><td><strong>Required?</strong><br><strong>Recommended?</strong></td><td><strong>Description</strong></td></tr><tr><td><code>$ttdimp</code></td><td><code>imp</code></td><td>string</td><td>Required</td><td>A 36-character string (including dashes) that serves as the unique ID for the impression to which the event is attributed.<br><br>When in HIPAA mode, is a Required Allow List property.</td></tr><tr><td><code>tracker_id</code></td><td><code>tracker_id</code></td><td>string</td><td>Required</td><td>The platform ID of the event tracker. Example value: hc7ihke<br><br>When in HIPAA mode, is a Required Allow List property.</td></tr><tr><td><code>value</code></td><td><code>value</code></td><td>number</td><td>Optional</td><td>When specified, the default currency is used.</td></tr><tr><td><code>privacy_settings</code></td><td><code>privacy_settings</code></td><td>object</td><td>Optional</td><td>User privacy settings based on data privacy consent processing. For object properties, see <a href="https://partner.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#properties-privacy">Privacy Settings Properties</a>.</td></tr><tr><td><code>data_processing_option</code></td><td><code>data_procession_option</code></td><td>object</td><td>Optional</td><td>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 <code>GPP</code> string in the <code>privacy_settings</code>, see <a href="https://partner.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#properties-dpo">Data Processing Options</a></td></tr></tbody></table>

### 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](https://documentation.freshpaint.io/integrations/impression-pixel).&#x20;

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.

{% hint style="warning" %}
If you use CM360 as your Ad Tech platform, please refer to this [setup guide](https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/thetradedesk/thetradedesk-with-cm360-configuration-guide) once you have finished setting up theTradeDesk destination in Freshpaint
{% endhint %}

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FAeCmZBksFGks1XafZXK4%2FScreenshot%202024-10-22%20at%205.44.40%E2%80%AFPM.png?alt=media&#x26;token=88d8b300-d32b-4b53-9a4c-1659b6c08364" alt="" width="563"><figcaption><p>Impression Pixel config in theTradeDesk destination configuration</p></figcaption></figure>

{% hint style="info" %}
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.
{% endhint %}

There are a couple of options for adding the Freshpaint Impression Pixel to your existing Trade Desk creatives.

1. Manually append the pixel in The Trade Desk's `Add Creative` Ul by adding the pixel into the "1x1 Pixel Impression Tracking URL" or "JavaScript Tracking Tag" field.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2Fz8ezyGcN5QE7W8LZVbu9%2Fimage%20(1).png?alt=media&#x26;token=2fab0425-779b-4699-9b51-9ef0a5bbbe0a" alt=""><figcaption></figcaption></figure>

2. Set a "Default" Impression Tracking URL in The Trade Desk, which will automatically append any pixel onto all creatives uploaded under your Advertiser seat. Note: this option requires outreach to your The Trade Desk CS team member who can help grant access to this option.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FUaQz1KIbrxTJzuOuOAWb%2Fimage%20(2).png?alt=media&#x26;token=0916b8ea-4c3e-40cb-ae62-a6cc030f87cb" alt=""><figcaption></figcaption></figure>