Skip to content

Inth is now agentic by default. Use it from Claude, ChatGPT or Cursor.

See how

TikTok Pixel

Measure TikTok ad results only after visitors allow marketing. c15t grants and revokes TikTok consent as the choice changes.

Works with Next.js, TanStack Start, React, Nuxt, Vue, Astro, Svelte, SvelteKit, HTML and JavaScript

Inth keeps the consent record of each choice, with the visitor’s country and the policy that applied.

Start for free
pnpm add @c15t/integrations
TikTok PixelWaiting for consent
Before a choice

events.js does not load, and window.ttq does not exist.

Turn the switch on, then off, to see what loads.

Before you start

You need an Inth project that connects to your app, c15t in that app and your TikTok Pixel ID.

New to c15t? Complete the quickstart for your framework first. Keep its Inth endpoint, policy, styles and consent UI.

Open the quickstart for your framework

How consent gets to the TikTok Pixel

Before marketing has permission, the c15t tiktokPixel helper defines no ttq queue and loads nothing from TikTok.

After permission, the helper sets up ttq the way the TikTok base code does. It queues ttq.grantConsent() and ttq.page(), then loads events.js.

On withdrawal, the helper keeps the pixel and calls ttq.revokeConsent(). By default, c15t also reloads the page.

If the visitor allows marketing again before the reload, the helper calls ttq.grantConsent().

Installation

The TikTok Pixel has one load mode in c15t. The helper waits for marketing permission.

Wait for permission. No request goes to TikTok until the visitor accepts marketing. On withdrawal, the pixel gets revokeConsent.

tiktokPixel({ pixelId })

An opt-out policy or no policy gives optional categories permission before a choice. Then the TikTok Pixel loads on the first page. This guide uses an opt-in policy.

Setup steps

  1. Install the integration package

    Add the helpers next to c15t. An import alone does not start the TikTok Pixel.

    pnpm add @c15t/integrations
  2. Add your pixel ID

    The helper adds the pixel ID to the loader URL as sdkid. It also sends the page view.

    src/consent-scripts.ts
    import { tiktokPixel } from '@c15t/integrations/tiktok-pixel';
    
    export const scripts = [tiktokPixel({ pixelId: 'YOUR_PIXEL_ID' })];

    The package exports no event wrapper. Your ttq.track and ttq.identify calls need a permission check.

  3. Check permission before each event

    window.ttq still exists after withdrawal. So check permission first, and then check that the pixel is ready.

    src/track-purchase.ts
    export function trackPurchase(marketingAllowed: boolean, value: number) {
      if (!marketingAllowed || typeof window.ttq?.track !== 'function') return;
      window.ttq.track('CompletePayment', { currency: 'USD', value });
    }
  4. Register it with your existing setup

    Add scripts to the c15t configuration that you have now. Keep your Inth endpoint, mode, policy, styles and consent UI.

    Add scripts to c15t.config.ts, next to next.config.ts. Keep the rest of your config, such as mode, in the same call. App Router, Pages Router and static export read the same file.

    c15t.config.ts
    import { defineConsentConfig } from 'c15t/next';
    import { scripts } from './src/consent-scripts';
    
    export default defineConsentConfig({ scripts });
All frameworks

Remove the original TikTok base code, so it cannot load the pixel without consent.

Verify your setup

Use a private window with an opt-in policy. Open DevTools Network and filter by tiktok. Then test the three states.

  • Before a choice

    events.js does not load, and window.ttq does not exist.

  • After you allow marketing

    A request to analytics.tiktok.com/i18n/pixel/events.js carries your pixel ID as sdkid. The pixel sends one page event.

  • After you withdraw marketing

    Until the reload, trackPurchase sends nothing.

Pass the current marketing permission from your framework, for example useConsent('marketing') in React.

Open the full TikTok Pixel guide