pixellint

TikTok loaders carry the configured pixel identity.

The loader uses sdkid and lib=ttq on /i18n/pixel/events.js. Browser event payloads on the exact /api/v2/pixel collector now have a separate TikTok browser pack.

Events API requests retain their own schemas. Loader identity cannot prove that an event payload is valid or delivered.

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`. Value diagnostic severity: warning. 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