TikTok

TikTok é integrado via GTM atualmente. O ttclid é capturado no front (clicked-id), mas a tag TikTok Pixel é configurada no GTM da brand.

ttclid — Click ID do TikTok

Capturado da URL e persistido como:

• Campo individual no cookie_tracking: { "ttclid": "abc123" }
• media_clid derivado quando é o primeiro match: { "media_source": "tiktok", "media_clid": "abc123" }

Vai no payload de signup e deposit pro BFF.

Pixel via GTM

O setup é responsabilidade do operador GTM:

1. Tag type: Custom HTML (com snippet TikTok Pixel)
2. Triggers:
   • Page View na entrada → track('PageView')
   • Custom Event sign_up → track('CompleteRegistration')
   • Custom Event first_deposit → track('Purchase', { value, currency })

Snippet padrão TikTok Pixel disponível em TikTok Ads Manager → Tools → Events.

Events API — Roadmap

Status: NÃO implementado.

TikTok Events API (CAPI equivalente do TikTok) requer:

1. BFF receber external_id no payload — front já tem (rmkvera)
2. BFF chamar TikTok Events API server-side com hashed user data + external_id
3. Configurar Pixel ID + Access Token no TikTok Ads Manager

Mesma trajetória da Meta CAPI — depende de priorização BFF.

Cookies escritos pelo Pixel

Cookie	Conteúdo	TTL
_ttp	TikTok Pixel ID	13 meses

Como debuggar

TikTok Pixel Helper (Chrome extension)

TikTok Pixel Helper — debug client-side.

Events Manager → Test Events

TikTok Ads → Events Manager → Test Events com URL parameter ?test_event_code=TEST....

Anti-patterns

1. Configurar TikTok Pixel via tag custom + via SDK próprio. Duplica eventos. Hoje só GTM.
2. Disparar Purchase em deposit_initiated. Mesma regra da Meta — Purchase só após confirmação BFF.