← Todos os artigos

Blog

Como Verificar se o Seu Pixel do TikTok Está Disparando Corretamente

verificar pixel tiktokpixel tiktok não disparachecar pixel tiktoktiktok pixel helper

Você está rodando anúncios no TikTok e tem certeza de que instalou o pixel. Mas suas compras e contatos estão realmente sendo medidos pelo TikTok? Um pixel pode "parecer instalado" e mesmo assim não enviar nenhum evento válido ao TikTok. E, sem perceber, seus anúncios continuam otimizando para os usuários errados — esse é o padrão mais assustador de todos.

Alguma dessas situações soa familiar?

  • As conversões nunca aparecem no Events Manager (travadas em zero)
  • O pixel dispara no navegador, mas nada aparece do lado do TikTok
  • Os eventos que você envia têm value/currency vazios, então nenhum valor chega
  • Os números do TikTok não batem com o GA4 ou seu backend

Este guia organiza quatro formas de verificar seu pixel do TikTok, explica por que um evento pode disparar e não ser recebido, e como verificar tudo isso sem depender de suposições.

Antes de verificar: "funcionando" tem três níveis

Assim como no GA4 ou no pixel da Meta, "o pixel está funcionando" não é um único estado. Separar isso em três estágios torna o diagnóstico muito mais fácil.

Nível Significado Armadilha comum
① Instalado O código base ttq carrega na página Ausente na página de conversão (finalização/compra)
② Disparo Uma requisição ttq.track() é enviada pelo navegador Instalado, mas não dispara naquela ação
③ Recebido O TikTok aceita e armazena o evento Dispara, mas um nome de evento padrão incorreto ou parâmetros ausentes quebram o processamento

O ponto-chave: ② disparo e ③ recebido são coisas diferentes. O pixel do TikTok carrega o ttq no navegador e envia eventos padrão como CompletePayment, Purchase e ViewContent via ttq.track(). As requisições vão para analytics.tiktok.com — mas o fato de uma requisição sair do navegador não significa que o TikTok a processe corretamente. A maioria das verificações para no ②.

Além do pixel no navegador, o TikTok também tem uma Events API (do lado do servidor). Se você envia dados tanto pelo navegador quanto pelo servidor, confirmar o "recebido" fica mais complexo — é preciso checar se os eventos não estão sendo contados em dobro e se você não acabou ficando, sem querer, apenas com um dos dois lados.

Método 1: TikTok Pixel Helper (extensão do Chrome)

A opção mais simples é a extensão TikTok Pixel Helper.

  1. Instale-a e abra sua página em produção
  2. Clique no ícone → ele lista os pixels detectados e os eventos que dispararam
  3. Confirme se o ID do pixel corresponde ao do Events Manager e se o evento padrão desejado (CompletePayment, Purchase etc.) aparece com os parâmetros corretos

O que isso confirma: que o pixel está instalado e que os eventos disparam no navegador (① e ②). O que isso não confirma: se o TikTok realmente recebeu e armazenou os eventos (③).

Como ler as cores: o Pixel Helper usa três cores de sinalização. Verde significa que o evento disparou com todos os parâmetros necessários. Amarelo significa que o evento disparou, mas algo está errado — geralmente um campo value ou currency ausente. Vermelho indica uma falha crítica: o evento não disparou ou o ID do pixel está errado. Não pare em "está verde na página inicial" — verifique a página de conversão.

Erro comum: checar apenas a página inicial. O evento de conversão que realmente importa dispara na "página de agradecimento" ou na "página de compra concluída". Abra exatamente essa página e execute a ação.

Método 2: Events Manager → Test Events

O recurso oficial Test Events do TikTok (Events Manager → seu pixel → Test Events) mostra os eventos chegando quase em tempo real.

  • Use o código de teste gerado em Test Events e execute a ação no seu site
  • Complete a ação (compra, contato etc.)
  • Ela deve aparecer no stream do Test Events em poucos segundos

O que isso confirma: que o TikTok está recebendo o evento agora mesmo (a verificação mais próxima do ③).

Erro comum: o Test Events só mostra "este exato momento" no seu próprio ambiente. Falhas que só acontecem em condições específicas — um bloqueador de anúncios, um navegador diferente, um determinado estado de consentimento — podem não se reproduzir no seu único teste manual.

Método 3: DevTools do navegador (Network)

Para inspecionar ② o disparo com precisão, use o DevTools do seu navegador.

  1. Abra a página e abra a aba "Network"
  2. Filtre por analytics.tiktok.com
  3. Realize a ação e observe se uma requisição dispara
  4. Verifique o conteúdo: o ID do pixel, o nome do evento (event) e propriedades como valor e moeda (value/currency)

O que isso confirma: qual evento foi enviado e com quais parâmetros.

Erro comum: com um bloqueador de anúncios ou proteção contra rastreamento ativados, a própria requisição para analytics.tiktok.com é bloqueada e parece que "não está disparando". Verifique em um estado limpo, com esses recursos desativados.

Método 4: Reconciliar o lado do servidor (Events API)

Se você também usa a Events API, verificar apenas o navegador não é suficiente. Confirme:

  • Se os eventos do servidor chegam no Test Events junto com os eventos do navegador
  • Se o mesmo evento está sendo contado em dobro entre navegador e servidor
  • Se o Advanced Matching (informações de cliente com hash, como e-mail ou telefone) está sendo enviado, e o quão bem o TikTok consegue atribuir eventos a pessoas

O que isso confirma: não apenas se os eventos chegam, mas se estão corretamente correspondidos e não duplicados.

Bônus: verificar pelo modo Preview do GTM

Se você instalou seu pixel do TikTok pelo Google Tag Manager, o modo Preview nativo do GTM oferece uma camada adicional de verificação.

  1. No GTM, clique em Preview no canto superior direito e digite a URL do seu site
  2. Navegue pelo site e confirme que a tag base do TikTok aparece em Tags Fired em todo carregamento de página
  3. Complete uma ação de conversão e verifique se sua tag de evento (por exemplo, TikTok – Purchase) também aparece em Tags Fired
  4. Na aba Variables, confirme se value, currency e content_id mostram valores reais — não undefined

Atenção: o TikTok Pixel Helper e o GTM Preview podem entrar em conflito às vezes. Se o modo Preview parar de funcionar, desative temporariamente a extensão Pixel Helper e tente novamente.

Verifique a aba Diagnostics para padrões de produção

O Test Events (Método 2) mostra o que está acontecendo agora, na sua sessão. A aba Diagnostics (Events Manager → seu pixel → Diagnostics) mostra padrões do pixel em toda a sua base de tráfego real, ao longo do tempo.

O TikTok escaneia automaticamente os dados de eventos recebidos e sinaliza problemas com níveis de severidade — parâmetros ausentes, nomes de eventos inválidos e falhas de entrega que um único teste manual não detectaria. Verifique essa aba periodicamente, especialmente após deploys do site ou mudanças de tags.

Monitore sua pontuação de Event Match Quality (EMQ)

Mesmo quando os eventos são recebidos (③), o TikTok pode não conseguir atribuí-los a uma pessoa. A pontuação Event Match Quality (EMQ) no Events Manager indica o quão bem os dados dos seus eventos correspondem aos perfis de usuário do TikTok.

  • Um EMQ abaixo de 4 limita seriamente a otimização — o TikTok não consegue conectar eventos a usuários
  • Busque 6+ em todos os eventos de conversão e 8+ no seu principal evento de otimização
  • Um EMQ baixo geralmente indica ausência de chaves de correspondência: e-mail, telefone ou external_id com hash

Se o seu EMQ estiver baixo, adicionar parâmetros de Advanced Matching ou implementar a Events API é a correção padrão. O EMQ é atualizado com dados de tráfego real, então verifique-o após pelo menos 24 horas de eventos ao vivo.

Por que um evento "dispara mas não é recebido"

Você confirmou o disparo (②), mas as conversões não aparecem (o ③ nunca acontece). Motivos comuns:

  • Sem pixel na página de finalização: você achava que estava em todas as páginas, mas a página de compra concluída usa um template diferente onde ele está ausente
  • Nome de evento padrão incorreto: o que você pretendia ser Purchase é, na verdade, um nome customizado, então não é tratado como evento padrão
  • value/currency ausentes: valor e moeda não são enviados, então o ROAS e a otimização baseada em valor não funcionam
  • Advanced Matching não configurado: os eventos chegam, mas não são vinculados a uma pessoa, então a otimização não consegue usá-los plenamente
  • ID do pixel errado: você está enviando para um destino diferente ou inválido

Em resumo, confirmar que você consegue "enviar" pelo navegador não é prova de que o TikTok armazenou e correspondeu o evento em produção. Para lacunas de mensuração específicas do TikTok, veja Por Que Suas Conversões do TikTok Não Estão Sendo Rastreadas.

O que a verificação na sua própria máquina não consegue revelar

Verificar uma única vez, manualmente, na sua própria máquina tem duas limitações estruturais.

  1. Seu ambiente não é o ambiente dos seus visitantes. Estado de login, extensões e IP podem fazer com que tudo pareça correto na sua máquina, mas esteja ausente nas condições reais dos visitantes. Sobre pixels bloqueados por bloqueadores de anúncios, veja Como Bloqueadores de Anúncios Impedem Seu Pixel.
  2. Conversões que envolvem um clique em anúncio são difíceis de verificar. Para realmente ver "se o rastreamento funciona via anúncio", você precisaria clicar em um anúncio ao vivo para recriar o caminho — o que carrega o risco de uma violação de política por autoclique.

Um checklist para verificar com confiança

  • O ttq base está presente em todas as páginas (especialmente na página de conversão)?
  • O evento alvo dispara no Pixel Helper ou no DevTools?
  • Ele chega no Test Events?
  • Os nomes de eventos padrão (CompletePayment, Purchase etc.) estão corretos?
  • value e currency estão configurados corretamente no evento de compra?
  • Com a Events API em uso, os eventos do navegador e do servidor não estão sendo contados em dobro?
  • Há algo ausente nas condições reais de usuários em produção, e não apenas no seu único teste manual?

Para auditar várias plataformas de uma vez, o Checklist de Verificação de Rastreamento de Conversões também ajuda.

Perguntas frequentes

P. Se o Pixel Helper mostra o disparo, já está tudo certo? R. Isso é apenas o "disparo (②)". Você só está seguro depois de confirmar também que o evento chega de fato no Test Events (③) e que não some em condições de produção.

P. O evento aparece, mas nenhum valor é registrado. R. Verifique no DevTools se as propriedades value e currency estão sendo enviadas. Mesmo com o nome de evento padrão correto, a ausência delas impede que a otimização baseada em valor funcione.

P. O Advanced Matching é obrigatório? R. Não é obrigatório, mas enviar informações de cliente com hash, como e-mail ou telefone, ajuda o TikTok a atribuir eventos a pessoas, geralmente melhorando a mensuração e a precisão da correspondência.

P. Clicar no meu próprio anúncio não é uma forma mais confiável de verificar? R. Não. Clicar no seu próprio anúncio é tratado como violação de política (autoclique) e traz o risco de revisão ou suspensão da conta. Verifique a partir de fora da sua própria conta — um ambiente independente.

P. Posso verificar o pixel da Meta da mesma forma? R. Sim, a lógica é a mesma. Veja Como Verificar se o Seu Pixel da Meta Está Disparando Corretamente. No DevTools, você observaria facebook.com/tr em vez de analytics.tiktok.com.

Conclusão: não pare no disparo — verifique se o TikTok recebeu

Os Métodos 1 a 4 permitem confirmar o disparo e — com o Test Events e a reconciliação da Events API — a recepção. O que importa é o panorama completo: se o evento é recebido, correspondido, não duplicado e registrado no caminho real que seus visitantes percorrem em produção.

O ConversionOK executa sua página em produção em um navegador independente e isolado e intercepta os eventos do pixel do TikTok realmente enviados, verificando-os em seguida — sem precisar clicar no seu próprio anúncio e sem interferência do ambiente do seu escritório. Comece com uma checagem estática gratuita para confirmar o ponto de entrada da sua mensuração.