Why your TikTok pixel is not firing

The TikTok pixel is a piece of code on your site that tells TikTok when someone takes an action there, so TikTok can measure traffic and campaign results and optimize campaigns. When it stops, TikTok's reports go quiet while the site keeps working. This guide covers what the pixel sends, how TikTok expects you to verify it, and what on the page can stop it.

Know what the pixel sends

According to TikTok's overview of the pixel, it collects what a standard browser makes available: which ad was clicked or which event happened, a timestamp, the IP address (for location), the user agent (for the device and browser), cookies, and page metadata and button clicks. Third-party cookies are on by default; first-party cookies are optional.

TikTok also recommends events across the whole customer journey, from viewing a product to adding it to a cart to buying, rather than the purchase alone.

Verify it three ways

TikTok's setup guide gives three checks. The TikTok Pixel Helper extension for Chrome reads the page and reports errors. The Test Events feature in Events Manager lets you test pixel events. The Diagnostics tab in Events Manager lists the issues it finds so you can resolve them.

The same guide recommends setting up the pixel and the Events API together. TikTok describes the Events API as a reliable connection for marketing data across web, app, and offline channels such as a store or a CRM.

Two causes the page itself can hide

A consent banner is the first. A site that asks before tracking holds the pixel back until the visitor allows it, so a test from a browser that never clicked Allow sends nothing. Test again after choosing Allow.

A Content Security Policy is the second. A policy decides which scripts a page may load, and the browser blocks one from a source the policy does not allow, as MDN's guide to CSP explains. A policy that leaves out TikTok's pixel host stops the pixel before it runs.

To check a page from outside, the FlowPilots free scan reads one public page the way a browser does: which analytics and ad tags it is set up to load, and whether its own headers let them run. It needs no account and nothing installed on the site, and what it cannot observe is named rather than guessed.

All posts