# TikTok Ads

Conecte o TikTok Ads via OAuth para enviar eventos de conversão server-side e otimizar suas campanhas automaticamente.

## Como conectar

A integração usa OAuth — não é necessário copiar Pixel Code nem Access Token manualmente. O Paywallo gerencia o token e o pixel após a autorização.

1. No dashboard, acesse Configurações > Integrações e clique em TikTok Ads.

2. Clique em Conectar via TikTok. Você será redirecionado ao TikTok Business Center para autorizar o acesso ao Paywallo.

3. Após autorizar, nenhuma conta de anúncio (advertisers) começa ativa. Na seção Trocar contas ativas, marque as contas que devem receber eventos e clique em Confirmar contas. Sem esse passo a integração aparece conectada, mas nenhum evento é enviado.

Nada mais para configurar

O Paywallo lê o pixel vinculado à conta de anúncio e cuida da rotação de token. Não é necessário acessar o TikTok Ads Manager para obter credenciais.

## Conexão legada

Se o seu app tinha uma integração configurada manualmente (Pixel Code + Access Token), o dashboard exibe um aviso `Conexão legada detectada`. Basta clicar em `Conectar via TikTok` para migrar para OAuth — a migração não interrompe o envio de eventos.

## Eventos enviados

O Paywallo envia esses eventos automaticamente via Events API. Nenhuma configuração adicional no código é necessária.

`paywallo_install` 

Install atribuído ao TikTok — evento customizado, aparece automaticamente após o primeiro envio

`Purchase` 

Compra realizada (com valor e moeda) — evento padrão do TikTok

`StartTrial` 

Trial iniciado — mapeado de $trial_started

Renovações de assinatura **não** são enviadas ao TikTok. Isso é intencional, para não inflar as conversões no painel de campanhas.