TikTok Events API, enviada a partir do seu servidor
O ROASaurus envia eventos de e-commerce para a Events API 2.0 do TikTok a partir do servidor, com os mesmos IDs de evento do pixel do TikTok. Ele também puxa o investimento em anúncios do TikTok para o ROAS e os relatórios de criativos.
| O TikTok em resumo | |
|---|---|
| Conexão | Events API 2.0 (servidor) mais o pixel do TikTok (navegador), compartilhando IDs de evento |
| Eventos | ViewContent, AddToCart, InitiateCheckout, CompletePayment (nome antigo de Purchase) |
| Dados do cliente | E-mail e telefone com hash SHA-256, external_id, IP, user agent |
| IDs de clique | ttclid e o cookie _ttp |
| Credenciais | Código do pixel e um token de acesso da Events API |
| Sincronização do investimento em anúncios | Sim, com um ID do anunciante e um token da Marketing API |
O que o ROASaurus envia ao TikTok
Quatro eventos vão para a Events API: ViewContent, AddToCart, InitiateCheckout e CompletePayment. O TikTok renomeou CompletePayment para Purchase e ainda aceita o nome antigo como uma compra. As visualizações de página passam apenas pelo pixel do navegador; o servidor não envia PageView ao TikTok.
Cada evento leva o ID do evento, a URL da página, o ID de clique ttclid, o cookie _ttp, o endereço IP e o user agent. Quando o comprador é conhecido, ele adiciona o e-mail e o telefone dele, com hash SHA-256, e um ID de cliente ou de visitante com hash como external_id. As propriedades trazem a moeda, o valor, o ID do pedido e o ID, o nome, a quantidade e o preço de cada produto.
O TikTok pode responder HTTP 200 e mesmo assim rejeitar um evento com um código de erro no corpo da resposta. O ROASaurus lê esse código, então um evento rejeitado aparece como falha no Event log em vez de passar em silêncio.
Como conectar
- No ROASaurus, vá em Tracking & platforms e clique em Add pixel no card do TikTok.
- Informe o código do seu pixel e um token de acesso da Events API.
- Deixe Also load the browser pixel ativado. Assim, os eventos do navegador e do servidor compartilham IDs e o TikTok os deduplica.
- Opcional: cole um código de evento de teste para ver os eventos primeiro em Testar eventos.
- Para o investimento em anúncios, adicione o seu ID do anunciante e um token da Marketing API.
Relatórios de investimento em anúncios e de criativos
Com o investimento em anúncios sincronizado, as campanhas do TikTok mostram ROAS e CPA ao lado do Meta na atribuição. A análise de criativos adiciona as estatísticas de vídeo do TikTok: o hook rate conta visualizações de 2 segundos e o hold rate conta visualizações de 6 segundos. Nomeie os seus anúncios com gancho, criador e formato para compará-los.
Limites
- Se o app do canal de vendas do TikTok também envia esse pixel, as compras são contadas em dobro. Desconecte o pixel nesse app.
- O ROASaurus só conta pedidos que consegue ligar a um clique, então os totais dele costumam ser diferentes dos do TikTok Ads Manager.
Relacionados
Perguntas respondidas
Por que uma compra se chama CompletePayment?
CompletePayment é o nome mais antigo do evento de compra do TikTok; hoje o TikTok o chama de Purchase e ainda aceita o nome antigo. O ROASaurus usa CompletePayment tanto no pixel do navegador quanto na Events API, para que o TikTok possa associar as duas cópias pelo event_id.
Preciso também do app do TikTok no Shopify?
Não. Se você mantiver o app, desconecte o pixel nele, porque os eventos que ele envia usam IDs diferentes e o TikTok contaria cada compra em dobro.
Posso testar antes de entrar no ar?
Sim. Cole o código do evento de teste do Gerenciador de Eventos do TikTok nas configurações do pixel. Os eventos então aparecem em Testar eventos. Remova o código quando terminar.
Cada venda, rastreada até o anúncio que a gerou
Rastreamento server-side, lucro e valor vitalício em um só app. 14 dias de teste grátis, sem cartão de crédito.
Comece seu teste grátis →