Trade Desk initialization accepts advertiser or merchant ownership.
Legacy universal pixels retain their account and pixel requirements. Current SDK initialization accepts advertiser or merchant ownership, with advisory flag and page-context checks.
Initialization, JSON conversions and browser fallback conversions use separate routes and contracts. Custom identifiers and versions remain opaque.
What this pack matches
Rules
Codes are stable. A finding in CI, MCP, or the playground lands on the same id.
| Field | Required | What it checks | Rule ids | Source |
|---|---|---|---|---|
operation |
optional | Collector operation extracted from the endpoint path. Evidence: vendor template. | docs | |
adv |
required | It is the platform advertiser ID that owns the tracking tag. The Trade Desk documents it as required on the iframe src. Applies when {"kind":"value_in","param":"operation","values":["up"]}. Fix: Set `adv` to the advertiser ID from the generated universal pixel code. | vendor.the-trade-desk.param.adv.missingvendor.the-trade-desk.param.adv.empty |
docs |
upid |
required | It is the universal pixel ID from the inline script. The Trade Desk documents it as required on the iframe src. Applies when {"kind":"value_in","param":"operation","values":["up"]}. Fix: Set `upid` to the universal pixel ID from the generated tag. | vendor.the-trade-desk.param.upid.missingvendor.the-trade-desk.param.upid.empty |
docs |
ref |
required | It is the page URL the tag fired on. The Trade Desk documents it as required, and mappings match against it. Applies when {"kind":"value_in","param":"operation","values":["up"]}. Fix: Set `ref` to the absolute URL of the page that fired the pixel. | vendor.the-trade-desk.param.ref.missingvendor.the-trade-desk.param.ref.emptyvendor.the-trade-desk.param.ref.invalid |
docs |
upv |
required | It is The Trade Desk version number of the universal pixel. The iframe src documents it as required. Applies when {"kind":"value_in","param":"operation","values":["up"]}. Fix: Set `upv` to the version from the generated universal pixel code, such as `3.3.0`. | vendor.the-trade-desk.param.upv.missingvendor.the-trade-desk.param.upv.empty |
docs |
order_id |
optional | Optional dynamic parameter; current and documented previous names are accepted. Applies when {"kind":"value_in","param":"operation","values":["up"]}. | docs | |
value |
optional | Optional dynamic parameter; current and documented previous names are accepted. Applies when {"kind":"value_in","param":"operation","values":["up"]}. Value diagnostic severity: warning. | vendor.the-trade-desk.param.value.emptyvendor.the-trade-desk.param.value.invalid |
docs |
currency |
optional | Optional dynamic parameter; current and documented previous names are accepted. Applies when {"kind":"value_in","param":"operation","values":["up"]}. | docs | |
policies |
optional | Optional dynamic parameter; current and documented previous names are accepted. Applies when {"kind":"value_in","param":"operation","values":["up","cei"]}. Value diagnostic severity: warning. | vendor.the-trade-desk.param.policies.emptyvendor.the-trade-desk.param.policies.invalid |
docs |
region |
optional | Optional dynamic parameter; current and documented previous names are accepted. Applies when {"kind":"value_in","param":"operation","values":["up","cei"]}. Value diagnostic severity: warning. | vendor.the-trade-desk.param.region.emptyvendor.the-trade-desk.param.region.invalid |
docs |
td_values… |
optional | Values beyond 64 characters are logged but truncated in reports. Applies when {"kind":"value_in","param":"operation","values":["up"]}. Value diagnostic severity: warning. Maximum decoded characters: 64. | vendor.the-trade-desk.param.td_values.invalid |
docs |
advertiser_id |
optional | Configured advertiser ownership on initialization. Applies when {"kind":"value_in","param":"operation","values":["cei"]}. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.the-trade-desk.param.advertiser_id.empty |
docs |
merchant_id |
optional | Configured merchant ownership on initialization. Applies when {"kind":"value_in","param":"operation","values":["cei"]}. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.the-trade-desk.param.merchant_id.empty |
docs |
cookie_sync |
optional | The SDK serializes this switch as 0 or 1. Applies when {"kind":"value_in","param":"operation","values":["cei"]}. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.the-trade-desk.param.cookie_sync.emptyvendor.the-trade-desk.param.cookie_sync.invalid |
docs |
uidc_present |
optional | The SDK emits 1 when UID configuration is supplied. Applies when {"kind":"value_in","param":"operation","values":["cei"]}. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.the-trade-desk.param.uidc_present.emptyvendor.the-trade-desk.param.uidc_present.invalid |
docs |
initialization_owner_missing |
recommended | SDK initialization supplies advertiser_id or merchant_id. Evidence: vendor template. | vendor.the-trade-desk.initialization_owner_missing |
docs |
initialization_context_missing |
recommended | The pinned initialization producer sends page context and a pixel version. Evidence: vendor template. | vendor.the-trade-desk.initialization_context_missing |
docs |
initialization_ref_invalid |
recommended | The pinned initialization producer supplies an absolute page location unless overridden by the caller. Evidence: vendor template. | vendor.the-trade-desk.initialization_ref_invalid |
docs |
method |
required | The documented Universal Pixel iframe uses a GET navigation. Complete HTTP capture contract. Presence diagnostic severity: warning. Evidence: vendor template. | vendor.the-trade-desk.http.method.missingvendor.the-trade-desk.http.method.emptyvendor.the-trade-desk.http.method.invalid |
docs |
Validate a payload
pixellint validate url "$ARTIFACT" --rulepack vendor/the-trade-desk
Try this failing payload in the playground. A Trade Desk initialization with an invalid cookie switch.
https://insight.adsrvr.org/track/cei?merchant_id=synthetic&ref=https%3A%2F%2Fexample.test&upv=3.0.0&cookie_sync=2
cargo install pixellint
·
npm install pixellint