Providers

Connect TikTok Pixel (Coming soon)

Coming soon — not yet available. VibesAnalytics does not collect TikTok data yet. Calling connect_provider with tiktok returns not_supported today, so it will not return real numbers. This guide describes the planned integration and is on the roadmap. For now, use GA4 and Meta (both live).

If you run TikTok Ads, the TikTok Pixel measures the conversions those campaigns drive. VibesAnalytics connects it and maps your canonical events to TikTok's standard events so campaign reporting stays accurate.

Before you start

  • A TikTok Ads Manager account with a Pixel (or permission to create one).
  • Your VibesAnalytics project created.

Connect

Have your agent call connect_provider with provider tiktok for your project. VibesAnalytics auto-discovers the pixels on your TikTok Ads account.

Event mappings

Canonical events map to TikTok's standard events:

  • session_started → ViewContent
  • signup_completed → CompleteRegistration
  • purchase_completed → CompletePayment (with value and currency)

The integration contract specifies the exact pixel setup and the env var holding your pixel ID, so your agent wires it up without guesswork.

Verify

Use the TikTok Pixel Helper browser extension and the Events tab in Ads Manager to confirm events fire, then call validate_tracking. TikTok spend and ROAS then appear alongside your other channels in normalized metrics.

Resilience

Like all client-side pixels, the TikTok Pixel is subject to blockers and consent gating. Keep owned events as your source of truth so a blocked pixel never hides a real conversion — see Owned Events vs Provider Events.