pixellint

vendor/tiktok · ecosystem evidence

TikTok Pixel loaders need sdkid

TikTok documents events for the JavaScript and server APIs, not this loader query. The pack is scoped to what Events Manager generates: sdkid and lib=ttq on /i18n/pixel/events.js, including analytics.us.tiktok.com. Collect POST /api/v2/pixel stays directory-only.

This is the loader, not collect

events.js carries sdkid. /api/v2/pixel is a POST with no published body. Events API is vendor/tiktok-events-api.

Rule: vendor.tiktok.param.sdkid.missing

What this pack matches

Hosts
analytics.tiktok.com, analytics.us.tiktok.com
Paths
…/i18n/pixel/events.js…
Vendor docs
ads.tiktok.com/help/article/get-started-pixel

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
sdkid required It carries the Pixel ID the loader initializes. TikTok generates this URL in Events Manager rather than documenting the parameter, so this rule is ecosystem evidence, not a published contract. Fix: Copy the base code from Events Manager so `sdkid` carries the Pixel ID. vendor.tiktok.param.sdkid.missing
vendor.tiktok.param.sdkid.empty
docs
lib recommended The generated base code sends `lib=ttq`. vendor.tiktok.param.lib.missing
vendor.tiktok.param.lib.empty
vendor.tiktok.param.lib.invalid
docs

Validate a payload

pixellint validate url "$ARTIFACT" --rulepack vendor/tiktok

Try this failing payload in the playground. TikTok pixel missing sdkid.

https://analytics.tiktok.com/i18n/pixel/events.js

cargo install pixellint · npm install pixellint