TikTok Pixel

Measure ad performance and build audiences for TikTok advertising campaigns.

TikTok Pixel is TikTok's conversion tracking and audience targeting tool. It measures ad effectiveness, tracks user actions, and helps optimize your TikTok advertising campaigns. By default, c15t loads this script based on marketing consent.

This script persists after consent is revoked because it has built-in consent management. When consent changes, c15t updates TikTok's internal consent state rather than removing the script entirely.

Implementation

Adding the script to c15t

Info

See the integration overview for how to pass scripts to your framework (JavaScript, React, or Next.js).

import { tiktokPixel } from '@c15t/scripts/tiktok-pixel';

tiktokPixel({
  pixelId: '123456789012345',
});

Types

TikTokPixelOptions

Property

Types

Loading…

Script

Property

Types

Loading…

Last modified on September 24, 2025

Property

Types

Full Type

((info: ScriptCallbackInfo) => void) | undefined

Properties

Property

Types

Loading...

Full Type

((info: ScriptCallbackInfo) => void) | undefined

Properties

Property

Types

Loading...

Full Type

((info: ScriptCallbackInfo) => void) | undefined

Properties

Property

Types

Loading...

Full Type

((info: ScriptCallbackInfo) => void) | undefined

Properties

Property

Types

Loading...

TikTok Pixel

Implementation

Adding the script to c15t

Types

TikTokPixelOptions

pixelIdYour TikTok Pixel IDrequiredstring

script?Override or extend the default script values. Default values: id: 'tiktok-pixel' src: https://analytics.tiktok.com/i18n/pixel/events.js category: 'marketing' Partial<Script>

Script

anonymizeId?Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockersboolean | undefined

async?Whether to use async loadingboolean | undefined

attributes?Additional attributes to add to the script elementRecord<string, string>

categoryConsent category or condition required to load this scriptrequiredHasCondition<AllConsentNames>

defer?Whether to defer script loadingboolean | undefined

fetchPriority?Priority hint for browser resource loading"high" | "low" | "auto" | undefined

iabLegIntPurposes?IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.{} | undefined

iabPurposes?IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.{} | undefined

iabSpecialFeatures?IAB TCF special feature IDs this script requires. Special features require explicit opt-in: 1: Use precise geolocation data 2: Actively scan device characteristics for identification {} | undefined

idUnique identifier for the scriptrequiredstring

nonce?Content Security Policy noncestring | undefined

onBeforeLoad?Callback executed before the script is loaded((info: ScriptCallbackInfo) => void) | u...

onConsentChange?Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.((info: ScriptCallbackInfo) => void) | u...

onError?Callback executed if the script fails to load((info: ScriptCallbackInfo) => void) | u...

onLoad?Callback executed when the script loads successfully((info: ScriptCallbackInfo) => void) | u...

persistAfterConsentRevoked?Whether the script should persist after consent is revoked.boolean | undefined

src?URL of the script to loadstring | undefined

textContent?Inline JavaScript code to executestring | undefined

vendorId?IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over category when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.string | number | undefined

pixelIdYour TikTok Pixel IDrequiredstring

script?Override or extend the default script values. Default values: id: 'tiktok-pixel' src: https://analytics.tiktok.com/i18n/pixel/events.js category: 'marketing' Partial<Script>

anonymizeId?Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockersboolean | undefined

async?Whether to use async loadingboolean | undefined

attributes?Additional attributes to add to the script elementRecord<string, string>

categoryConsent category or condition required to load this scriptrequiredHasCondition<AllConsentNames>

defer?Whether to defer script loadingboolean | undefined

fetchPriority?Priority hint for browser resource loading"high" | "low" | "auto" | undefined

iabLegIntPurposes?IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.{} | undefined

iabPurposes?IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.{} | undefined

iabSpecialFeatures?IAB TCF special feature IDs this script requires. Special features require explicit opt-in: 1: Use precise geolocation data 2: Actively scan device characteristics for identification {} | undefined

idUnique identifier for the scriptrequiredstring

nonce?Content Security Policy noncestring | undefined

onBeforeLoad?Callback executed before the script is loaded((info: ScriptCallbackInfo) => void) | u...

onConsentChange?Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.((info: ScriptCallbackInfo) => void) | u...

onError?Callback executed if the script fails to load((info: ScriptCallbackInfo) => void) | u...

onLoad?Callback executed when the script loads successfully((info: ScriptCallbackInfo) => void) | u...

persistAfterConsentRevoked?Whether the script should persist after consent is revoked.boolean | undefined

src?URL of the script to loadstring | undefined

textContent?Inline JavaScript code to executestring | undefined

vendorId?IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over category when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.string | number | undefined

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring

consentsThe current consent staterequiredRecord<AllConsentNames, boolean>

element?The script element (for load/error callbacks) Will be undefined for callback-only scriptsHTMLScriptElement

elementIdThe actual DOM element ID used (anonymized if enabled)requiredstring

error?Error information (for error callbacks)Error

hasConsentHas consentrequiredboolean

idThe original script IDrequiredstring