The Trade Desk First-Party Advertiser Data
Datafly Signal uploads first-party CRM and audience data to The Trade Desk server-to-server for identity resolution, audience building, and enhanced campaign targeting via UID2.
Why route The Trade Desk First-Party through Datafly Signal
- Conversions survive ad blockers and tracking prevention. A browser tag served from an advertising domain is blocked outright for part of your traffic, and Safari’s ITP shortens the cookies it can set. Signal sends the event from your own server, so the conversions The Trade Desk First-Party optimises against are not filtered by the browser.
- Email is hashed before leaving your infrastructure. Signal normalises (trim and lowercase) and applies SHA-256 inside your own deployment, so The Trade Desk First-Party receives match keys rather than raw personal data.
- Client IP and user agent are preserved. Server-to-server delivery normally loses both, which weakens matching. Signal forwards the genuine visitor values as request headers so The Trade Desk First-Party attributes the event to the right session.
- Delivery is batched, rate-limited, and retried. Signal buffers to Kafka, respects the The Trade Desk First-Party rate limit, and retries on 429 or transient failure rather than dropping the event.
- One consent decision governs every destination. The Trade Desk First-Party is gated by the same consent state as the rest of your stack, so a withdrawal applies everywhere at once.
- No vendor tag on the page. Removing it removes its page weight and its independent access to your visitors.
Prerequisites
Before configuring The Trade Desk First-Party Data in Signal, you need a Trade Desk account with access to the First-Party Data API and a secret key generated for authentication.
Create a Trade Desk Account
- If you don’t already have one, contact The Trade Desk to set up an advertiser account.
- Once provisioned, log in to the Trade Desk platform at desk.thetradedesk.com.
- Complete any onboarding steps required by your Trade Desk representative.
Get Your Advertiser ID
- In the Trade Desk platform, click on your account name in the top-right corner.
- Navigate to Advertiser Settings (or Advertiser Preferences).
- Note your Advertiser ID — a short alphanumeric string (e.g.
abcde12).
Your Advertiser ID is also visible in the URL when viewing your advertiser settings. It is the same ID used across all Trade Desk integrations.
Generate a Secret Key for First-Party Data API
- In the Trade Desk platform, navigate to Data > First-Party Data.
- Click API Access or Generate Secret Key.
- Copy the Secret Key immediately — it will only be shown once.
- Ensure your account has permissions for the First-Party Data API (contact your Trade Desk representative if this section is not visible).
Store the secret key securely. If you lose it, you will need to generate a new one. The secret key is used to authenticate all First-Party Data API requests.
Configure in Signal
Now that you have your Advertiser ID and secret key, configure the integration in Signal.
Configuration Fields
| Field | Required | Description |
|---|---|---|
advertiser_id | Yes | Your Trade Desk Advertiser ID. Found in the Trade Desk platform under Advertiser Settings. |
secret_key | Yes | Secret key for authenticating first-party data uploads. Generated in the Trade Desk platform under Data > First-Party Data. |
Management UI Setup
- Go to Integrations > Add Integration > The Trade Desk First-Party Advertiser Data.
- Enter your
advertiser_idandsecret_key. - Select consent categories (typically
advertising). - Click Save.
Management API Setup
curl -X POST http://localhost:8084/v1/admin/integrations \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"source_id": "src_abc123",
"vendor": "the_trade_desk_firstparty",
"name": "TTD First-Party Data Production",
"enabled": true,
"config": {
"advertiser_id": "abcde12",
"secret_key": "sk_ttd_abc123..."
},
"consent_categories": ["advertising"]
}'API endpoint
POST https://insight.adsrvr.org/track/realtimeconversionAllow egress to insight.adsrvr.org from the network your delivery workers run on.
Event Mapping
The default Retail preset maps:
| Signal event | Trade Desk event |
|---|---|
page | pageload |
Product Viewed | viewitem |
Order Completed | purchase |
To customise or extend, edit the integration’s Field Mappings in the Management UI.
Identity Resolution via UID2
The Trade Desk uses UID2 (Unified ID 2.0) for identity resolution. When you send user data via datafly.identify(), Signal hashes and uploads the data to The Trade Desk’s First-Party Data API, which resolves it to UID2 tokens for audience targeting.
datafly.identify("user-123", {
email: "jane.doe@example.com",
phone: "+44 7700 900123"
});All PII hashing is performed server-side by the Signal before the data leaves your infrastructure. Raw PII is never sent to The Trade Desk.
Testing Your Integration
Step 1: Send a Test Identity Event
- Call
datafly.identify()with a test user’s email or phone number. - Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.
Step 2: Verify in The Trade Desk
- In the Trade Desk platform, go to Data > First-Party Data.
- Check that data segments are being populated.
- It may take up to 24 hours for first-party data to appear in audience segments.
Step 3: Build an Audience
- Navigate to Audiences in the Trade Desk platform.
- Create a new audience segment using your first-party data.
- Verify that the audience size reflects the data uploaded via Signal.
Troubleshooting
| Problem | Solution |
|---|---|
| Data not appearing in The Trade Desk | Verify the advertiser_id and secret_key are correct. Check that the secret key has not been rotated. |
| Authentication errors | Regenerate the secret key in the Trade Desk platform under Data > First-Party Data and update Signal. |
| Audience segments empty | First-party data may take up to 24 hours to process. Ensure you are sending identity data via datafly.identify(). |
Permission denied error | Ensure your account has First-Party Data API access. Contact your Trade Desk representative. |
| Low match rate | Send both email and phone number for higher UID2 match rates. Ensure data is normalised (lowercase, trimmed). |
Visit The Trade Desk First-Party Data documentation for full API documentation and credential setup instructions.