pixellint

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

Hosts
insight.adsrvr.org
Paths
/track/up, /track/up/, /track/cei, /track/cei/
Vendor docs
partnersandbox.thetradedesk.com/v3/portal/data/doc/TrackingTagsUniversalPixel?branch=APIDOCS-2938

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.missing
vendor.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.missing
vendor.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.missing
vendor.the-trade-desk.param.ref.empty
vendor.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.missing
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.the-trade-desk.http.method.empty
vendor.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