# theTradeDesk Audiences

Freshpaint Audiences allows you to sync your segmented or imported audiences to theTradeDesk Audiences — all while enabling you to maintain compliance with privacy regulations like HIPAA.

{% hint style="info" %}
In theTradeDesk, these will appear as CRM Data Segments, even though Freshpaint refers to them as Audiences.
{% endhint %}

This guide walks through how to set up and verify your connection between Freshpaint and your theTradeDesk account.

#### theTradeDesk account requirements

The following must be true about theTradeDesk account you use for this integration:

1. You have a theTradeDesk Advertiser ID.
2. [You have a valid theTradeDesk API token](https://partner.thetradedesk.com/v3/portal/api/doc/Authentication#ui-method-create).

<figure><img src="/files/hcRXJEUlAOM74AXehyfW" alt="" width="563"><figcaption></figcaption></figure>

3. Your account is in good standing and authorized for CRM audience activation.
4. You have worked with your theTradeDesk account manager to complete any required agreement(s) for CRM audience usage.

#### Connect theTradeDesk Audiences account to Freshpaint

1. To begin, select **theTradeDesk Audiences** option from [Freshpaint’s Integration Catalog](https://app.freshpaint.io/destinations/catalog?category=audiences).

<figure><img src="/files/T4GpQnYJR0V7dYHwda6o" alt="" width="563"><figcaption></figcaption></figure>

2. On the theTradeDesk Audiences configuration page, click Configure and enter your Advertiser ID.

<figure><img src="/files/iKvfCan1ulYJ561jiUMs" alt="" width="563"><figcaption></figcaption></figure>

3. Enter your API token in the API token configuration row.
4. Enable Automatic identity matching if you plan to sync Segments (behavioral audiences).

<figure><img src="/files/eMZSqEHxx4XmadSOg2Fh" alt="" width="375"><figcaption></figcaption></figure>

5. Open Allowlisted Audience identifiers, confirm Email is allowlisted, accept the consent checkbox, and click Save.

<figure><img src="/files/b80FFsmi9JZAShOQoGr5" alt=""><figcaption></figcaption></figure>

6. Click Test connection to verify setup — this tests:
   1. Your API token is valid and active.
   2. Your token has access to the configured advertiser.
   3. Your destination configuration is valid.
7. Add a label to your integration so it is easier to identify later.

✅ That’s it! Your theTradeDesk Audiences integration is now ready to use.

{% hint style="info" icon="lightbulb-exclamation" %}
After you sync an audience from Freshpaint, you’ll manage it in theTradeDesk as a CRM Data Segment.
{% endhint %}

#### Processing and audience size expectations

* Audience processing in theTradeDesk can take up to 72 hours before matched size is fully reflected.
* Freshpaint uses Active IDs as the matched/reachable audience size shown for this integration.
* Very small audiences may remain below theTradeDesk minimum threshold for activation.

#### Custom Consent Manager Integration

* Refer to this destination as Audiences in the [Consent object](https://documentation.freshpaint.io/integrations/consent-management/custom-consent-manager).

### Best Practices & Reminders

Use a neutral audience alias\
The alias is the external segment name. Prefer campaign-safe names without health-condition context.

Plan around processing time\
Assume up to \~72 hours after sync for Active IDs to stabilize before judging reach.

#### What's Next?

Now that you understand how theTradeDesk Audiences integration works, you're ready to start syncing audiences.

Here’s what you can do next:

* [Create a Segment](https://documentation.freshpaint.io/audiences/segments) → Build behavioral audiences from your event data
* [Import an Audience](https://documentation.freshpaint.io/audiences/importing-audiences) → Upload a CSV of users to target
* Send an Audience → Sync your audiences to theTradeDesk for activation

Need help? Contact <support@freshpaint.io>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/audiences/audience-integrations/thetradedesk-audiences.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
