pooriaarab The Trade Desk
This skill is a product-agnostic adapter for the shared conversion hub. It maps
one canonical event to the vendor event, sends it after payment confirmation,
and makes an absent TRADE_DESK_TOKEN a logged no-op.
The three-layer conversion model
- Client tag. Load the vendor pixel or approved data source on the browser.
- Server conversion path. Send the canonical event from the server when the payment provider confirms the charge. Use one stable event ID across both paths.
- Attribution layer. Configure the vendor conversion action and reporting surface. A 2xx response does not prove that an ad received credit.
Official tracking reference: The Trade Desk pixel or measurement docs.
Client tag
Install the exact tag generated by the vendor console. Do not copy an old blog snippet or mirror a vendor script through your own CDN.
⚠ UNVERIFIED — confirm the current init call, script origin, pixel ID field, and purchase event shape at The Trade Desk tracking reference.
Use TRADE_DESK_PIXEL_ID or TRADE_DESK_TAG_ID for the public identifier, as the vendor
names it. Send event_id when the platform supports client/server deduplication.
Server-side conversion API
Server endpoint:
GET https://api.thetradedesk.com/v3/is an official API or console root, not a claimed conversion endpoint.
⚠ UNVERIFIED — confirm the current conversion POST path, authorization header, timestamp unit, deduplication field, and JSON payload at The Trade Desk API documentation.
Do not invent a CAPI body from an SDK or old help article.
Get a token and validate it
- Open the official The Trade Desk console or request access from the account team.
- Create the advertiser, pixel, data source, or API connection.
- Generate the credential required by the official API. Store it as
TRADE_DESK_TOKEN. - Keep the credential in a server-side secret store.
The Trade Desk API and audience onboarding are partner-gated. CRM API segments and conversion tracking depend on account permission.
Token validation:
curl -sS 'https://api.thetradedesk.com/v3/' -H "Authorization: Bearer $TRADE_DESK_TOKEN"
⚠ UNVERIFIED — confirm the endpoint, token type, and required headers at The Trade Desk authentication reference before using this command.
Audience, retargeting, and lookalike expansion
Use the platform's official site-audience, customer-list, CRM, or conversion audience workflow. Normalize email by trimming and lowercasing before SHA-256 hashing when the official product requires hashed contacts.
The Trade Desk API and audience onboarding are partner-gated. CRM API segments and conversion tracking depend on account permission.
⚠ UNVERIFIED — confirm the current customer-list fields, minimum usable size, match-rate rules, lookalike product, and audience eligibility at The Trade Desk audience documentation.
Verify the audience status in the console or with the official read endpoint. A successful upload response is not proof that the audience can serve.
Deduplication and event rules
- Use the payment transaction ID as the shared event ID.
- Do not require a click ID before sending a server event.
- Persist the click ID in first-party storage when the platform requires it later.
- Hash first-party identifiers only after consent. Never send raw email or phone data.
- Read the vendor's current timestamp unit. Do not assume seconds or milliseconds.
Small-budget campaign launch
- Run one audience, geo, creative, and conversion goal per test.
- Disable broad expansion, network, placement, and automatic targeting defaults until they fit the hypothesis.
- Start with traffic or click optimization when no conversion history exists.
- Set a hard spend cap where the product supports one.
- Check the campaign's review, billing, and delivery status before increasing spend.
- ⚠ UNVERIFIED — confirm current bid floors, learning thresholds, budget minimums, and default placements at The Trade Desk API documentation.
Verification
Use the official test-event view, status endpoint, or reporting API. Reconcile the result with payment-provider succeeded charges. A zero count before deploy is expected. A real charge with zero platform events is a tracking failure.
⚠ UNVERIFIED — confirm the current event-test or reporting query at The Trade Desk API documentation.
Hub conventions
Pair this skill with ad-conversion-hub for canonical taxonomy, consent,
hashing, secret names, and multi-platform dispatch. Pair it with ad-experiments
for seed sizing, narrow tests, PII-export authorization, and ground truth.
Keep this adapter thin. A vendor error must not fail checkout or a payment webhook.
Common pitfalls
- A browser tag can fire while server events remain absent.
- A successful upload can return partial warnings or a non-servable audience.
- Partner-gated APIs often need account approval before a token works.
- Build-time secrets need a redeploy after they change.
- Do not infer attribution from the presence of an event in a debug view.
Security
Load client code only from the vendor's official HTTPS origin. Keep TRADE_DESK_TOKEN
server-side. Never log or commit it. Send only consented and hashed identifiers.