TikTok Events API para Shopify: guia completo de configuração (2026)
O TikTok se tornou uma das plataformas de publicidade mais eficazes para lojistas Shopify. O problema é que o pixel do navegador do TikTok subnotifica conversões de forma consistente, muitas vezes de 40 a 60 por cento. Se você está veiculando anúncios no TikTok e confiando apenas no pixel para rastreamento de conversões, quase certamente está tomando decisões de orçamento com base em dados incompletos. A TikTok Events API resolve isso enviando dados de conversão diretamente do seu servidor para o TikTok, contornando todos os problemas do lado do navegador que causam perda de dados.
Por que o rastreamento por pixel do TikTok falha no Shopify
Os anúncios do TikTok têm um desafio de atribuição único que os torna especialmente vulneráveis a lacunas de rastreamento. Compreender esses desafios explica por que a Events API é essencial e não opcional.
O problema entre dispositivos
O TikTok é principalmente um aplicativo móvel. Os usuários descobrem seu produto enquanto rolam o feed no celular. Mas muitos desses usuários não compram imediatamente no celular. Eles visitam sua loja mais tarde a partir de um notebook, um tablet ou um navegador diferente. O pixel do TikTok na sua loja Shopify não consegue conectar essas duas sessões porque elas acontecem em dispositivos diferentes com cookies diferentes. O TikTok vê um clique mas nunca vê a compra, então reporta uma impressão desperdiçada em vez de uma venda lucrativa.
Bloqueadores de anúncios e prevenção de rastreamento
Entre 30 e 40 por cento dos usuários de desktop utilizam bloqueadores de anúncios ou extensões de privacidade que bloqueiam o pixel do TikTok completamente. Quando esses usuários clicam no seu anúncio do TikTok e compram na sua loja Shopify, o pixel nunca dispara. A venda aconteceu, mas o TikTok nunca fica sabendo. No mobile, a Prevenção Inteligente de Rastreamento do Safari cria lacunas semelhantes ao limitar o tempo de vida dos cookies.
Problemas com o domínio de checkout do Shopify
Quando um cliente chega ao checkout em muitas lojas Shopify, ele faz a transição para um domínio ou subdomínio diferente. Essa troca de domínio pode quebrar a continuidade dos cookies para o pixel do TikTok, fazendo com que ele perca o rastreamento da sessão do usuário. O evento de compra dispara sem dados de atribuição adequados ou não dispara de forma alguma.
O que é a TikTok Events API
A TikTok Events API é a solução de rastreamento do lado do servidor do TikTok. Em vez de depender de JavaScript rodando no navegador do cliente, a Events API permite que você envie eventos de conversão diretamente do seu servidor para o TikTok. Quando um cliente conclui uma compra na sua loja Shopify, os dados do evento, incluindo identificadores hasheados do cliente como e-mail e número de telefone, são enviados servidor-a-servidor para o TikTok.
O TikTok então cruza esses dados com sua base de dados de usuários para atribuir a conversão ao clique de anúncio correto. Como os dados trafegam servidor-a-servidor, não são afetados por bloqueadores de anúncios, restrições do navegador, expiração de cookies ou lacunas de atribuição entre dispositivos.
Events API vs pixel do TikTok: diferenças principais
| Fator | Pixel do TikTok (navegador) | Events API (lado do servidor) |
|---|---|---|
| Bloqueado por bloqueadores de anúncios | Sim | Não |
| Afetado pelo iOS 14+ | Sim | Não |
| Atribuição entre dispositivos | Muito limitada | Forte (via identificadores hasheados) |
| Dependência de cookies | Sim (limite de 7 dias no Safari) | Não |
| Confiabilidade dos dados | 50-70% das conversões reais | 90-95% das conversões reais |
| Complexidade de configuração | Simples (colar código) | Requer integração de servidor |
Quais eventos você deve enviar
A Events API do TikTok suporta vários eventos padrão de e-commerce. Para lojistas Shopify, os eventos mais importantes para rastrear são:
- ViewContent: Quando um cliente visualiza uma página de produto. Isso ajuda o TikTok a entender quais produtos atraem interesse e a otimizar a entrega para usuários propensos a interagir com produtos semelhantes.
- AddToCart: Quando um cliente adiciona um item ao carrinho. Este é um sinal forte de intenção que ajuda o TikTok a identificar públicos de alto valor.
- InitiateCheckout: Quando um cliente inicia o processo de checkout. Este evento ajuda o TikTok a construir públicos de usuários próximos da compra.
- CompletePayment: O evento mais crítico. Este é o evento real de compra que determina seu ROAS e impulsiona a otimização de campanhas. Perder este evento significa que o TikTok não consegue ver sua receita.
Enviar o funil completo de eventos dá ao TikTok uma imagem completa do seu caminho de conversão. O algoritmo usa esses dados para encontrar mais usuários propensos a seguir a mesma jornada desde visualizar um produto até concluir uma compra.
Três formas de configurar a TikTok Events API no Shopify
Opção 1: integração manual da API
Você pode construir sua própria integração do lado do servidor escrevendo código que escuta os webhooks do Shopify (orders/create, checkouts/create) e envia eventos formatados para o endpoint da Events API do TikTok. Isso requer um desenvolvedor, um servidor para hospedar a integração, manutenção contínua conforme o TikTok atualiza sua API, e tratamento adequado de deduplicação de eventos, hashing de dados e registro de erros. Essa abordagem dá controle total, mas exige um tempo significativo de desenvolvimento e é difícil de manter.
Opção 2: Google Tag Manager do lado do servidor
Se você já usa o Google Tag Manager, pode configurar um contêiner GTM do lado do servidor e configurá-lo para encaminhar eventos ao TikTok. Isso requer provisionar um servidor na nuvem (geralmente Google Cloud), configurar o contêiner do lado do servidor, definir a tag do TikTok e gerenciar os custos de infraestrutura. Funciona, mas adiciona complexidade e custos contínuos de servidor que podem se acumular rapidamente.
Opção 3: usar Converlay (recomendado)
O Converlay cuida de toda a integração da TikTok Events API para sua loja Shopify sem nenhum código ou configuração de servidor. Você instala o aplicativo, conecta sua conta do TikTok, e o Converlay começa imediatamente a encaminhar eventos do lado do servidor para cada compra, adição ao carrinho e visualização de página. Ele cuida da deduplicação de eventos com seu pixel existente, do hashing correto dos dados do cliente e das tentativas automáticas para entregas que falharam.
A configuração leva cerca de cinco minutos. O painel do Converlay mostra exatamente quantos eventos estão sendo enviados, seu status de entrega e quantas conversões adicionais o TikTok está vendo agora em comparação com o rastreamento apenas por pixel.
Deduplicação de eventos: por que isso importa
Se você utiliza tanto o pixel do TikTok quanto a Events API simultaneamente, precisa de deduplicação de eventos para evitar a contagem dupla de conversões. Sem deduplicação, o TikTok pode contar a mesma compra duas vezes: uma do pixel e outra da Events API. Isso inflaria seus números de conversão e distorceria seu ROAS.
A deduplicação adequada funciona enviando um ID de evento único tanto com o evento do pixel quanto com o evento do lado do servidor. O TikTok cruza esses IDs e conta cada conversão apenas uma vez, usando o sinal que chega primeiro ou tem melhor qualidade de dados. Quando o pixel é bloqueado por um bloqueador de anúncios, apenas o evento do lado do servidor chega, garantindo que a conversão ainda seja contabilizada. O Converlay cuida da deduplicação automaticamente para que você não precise configurá-la manualmente.
Medindo o impacto
Após implementar a TikTok Events API, monitore estas métricas durante as primeiras duas semanas:
- Taxa de correspondência de eventos: Verifique no TikTok Events Manager sua taxa de correspondência de eventos. Isso indica qual porcentagem de eventos do lado do servidor o TikTok consegue vincular a um usuário em seu sistema. Uma taxa de correspondência saudável está acima de 30 por cento, e taxas acima de 50 por cento indicam excelente qualidade de dados.
- Conversões atribuídas: Compare o número de conversões que o TikTok reporta antes e depois de habilitar a Events API. A maioria dos lojistas vê um aumento de 20 a 50 por cento nas conversões atribuídas.
- Desempenho de campanhas: Com melhores dados de conversão, o algoritmo do TikTok pode otimizar a entrega de forma mais eficaz. Observe melhorias no custo por conversão e no ROAS geral nas duas a quatro semanas seguintes.
Erros comuns a evitar
- Remover o pixel completamente: A Events API funciona melhor junto ao pixel, não como substituto. Mantenha seu pixel ativo e deixe a deduplicação cuidar dos eventos sobrepostos. O pixel fornece sinais em tempo real do lado do navegador que complementam os dados do lado do servidor.
- Não enviar dados hasheados do cliente: A precisão de correspondência da Events API depende do envio de endereços de e-mail e números de telefone hasheados. Sem esses identificadores, o TikTok não consegue vincular eventos a usuários e a taxa de correspondência cai significativamente.
- Ignorar erros de entrega de eventos: Monitore o status de entrega dos seus eventos regularmente. Eventos que falharam significam dados de atribuição perdidos. O Converlay exibe os erros de entrega em seu painel para que você possa resolver problemas imediatamente.
Comece a rastrear conversões do TikTok com precisão
Se você está gastando dinheiro em anúncios do TikTok para sua loja Shopify, não pode se dar ao luxo de deixar 40 a 60 por cento das suas conversões sem reportar. A Events API não é uma otimização opcional. É um requisito fundamental para medição precisa de campanhas e alocação eficaz dos gastos com publicidade.
Pronto para corrigir seu rastreamento do TikTok? Instale o Converlay na sua loja Shopify e comece a enviar eventos do lado do servidor para o TikTok em minutos. Sem código, sem configuração de servidor, e você verá o impacto no seu TikTok Ads Manager em poucos dias.