Quando os eventos não chegam
Se os seus eventos não aparecem em algum destino conectado (Meta Ads, Google Analytics, Google Ads, LinkedIn Ads, TikTok Ads ou Pinterest Ads), ou os números parecem menores do que deveriam, percorra este checklist do topo para baixo.
Comece pela Visão geral do rastreamento
Antes do checklist, abra Rastreamento › Visão geral na barra lateral. No topo fica a tendência dos eventos (como Eventos recebidos, Eventos com erro e Taxa de erro), com seletor de período; o botão Editar visão geral escolhe quais números aparecem.
Para o diagnóstico, olhe os dois cards abaixo dela. O card Pixels mostra a saúde de cada plataforma: Com erros quando 1% ou mais dos eventos da última hora falharam, Sem eventos quando a última hora não teve nenhum e a mesma hora de ontem teve 10 ou mais, e Saudável no resto. Quando há problema, um Motivo acompanha o estado, e Ver todos os pixels leva à tela de Pixels. O card Subdomínios e regras marca cada subdomínio como Com erro ou No ar e traz a contagem de Situação das regras; os certificados renovam sozinhos. Numa conta nova, a tela também mostra um checklist de configuração.
Se um dos cards já aponta a causa, vá direto ao item correspondente abaixo. A tela está descrita em Funcionalidades.
1. O subdomínio está ativo?
Na lista de subdomínios, o selo de status mostra um de três estados: Ativo, Emitindo (o SSL ainda está sendo emitido) ou Erro. Enquanto o subdomínio não está ativo, os eventos não têm por onde entrar.
Aviso
O subdomínio é apontado por um registro DNS: A / AAAA (a aba padrão, com os endereços que o app mostra) ou CNAME (para tgsr.cc). Um novo registro pode levar de minutos a horas para propagar no DNS. Assim que o DNS resolve, o SSL é emitido automaticamente em alguns segundos. Evite testar antes de o subdomínio aparecer como Ativo.
Quando um subdomínio está em Erro, a tela de Subdomínios exibe um banner de saúde ("1 subdomínio com problema" ou "N subdomínios com problema") com a mensagem de erro daquele subdomínio, os dias até o certificado vencer e dois botões de autoatendimento: Reverificar DNS e Renovar agora. Tente os dois antes de acionar o suporte; o restante do processo está em criação e gerenciamento de subdomínios.
2. Os pixels estão configurados corretamente?
Confirme que as credenciais de cada pixel estão corretas e atuais. Cada destino tem as suas:
| Destino | Credenciais |
|---|---|
| Meta Ads | Pixel ID (só dígitos) e Access Token |
| Google Analytics | Measurement ID (G-XXXXXXXXXX) e API Secret |
| Google Ads | Customer ID da conta (só dígitos, MCC opcional) e, depois, as ações de conversão (nome, tipo e Conversion ID, que é o número da tag AW-) |
| LinkedIn Ads | Conversion Rule ID (só dígitos) |
| TikTok Ads | Pixel Code e Access Token |
| Pinterest Ads | Ad Account ID (só dígitos) e Access Token |
Não há tela de edição de pixel. As ações da linha são Inspecionar (botão com rótulo) e Excluir, além de um botão para copiar o ID do pixel; para membros somente leitura, o Excluir fica desabilitado ("Somente Leitura: peça ao proprietário da conta para excluir pixels."). Para trocar um Access Token ou API Secret, adicione o pixel de novo com o mesmo identificador (Pixel ID, Measurement ID, Pixel Code, Ad Account ID, Conversion Rule ID ou Customer ID, conforme o destino), e o TagServer substitui a credencial anterior. Se preferir, exclua e crie outra vez. O cadastro de cada destino está em criação e gerenciamento de pixels.
3. A coleta está disparando no site?
Pelo GTM: confirme que a tag está disparando e que ela aponta para o seu subdomínio do TagServer. Uma tag ausente ou mal configurada significa que nada é enviado. A configuração está em Configurações Adicionais.
Pelas Regras de tag: um <script> colado dentro do <head> do site (instruções em "Como instalar o script") carrega todas as regras criadas para aquele subdomínio. Confira se o snippet está instalado e veja a saúde das regras em três lugares: a contagem de regras que não medem aparece em Situação das regras, na Visão geral; o painel de cada regra tem um bloco Saúde com os achados dela (como um seletor inválido); e o editor da regra tem a faixa Confira na página. Mais em Regras de tag.
4. O event_id está presente (deduplicação)?
Se os eventos aparecem mas parecem duplicados ou faltando, confirme que o mesmo event_id sai tanto do pixel do navegador quanto da tag do servidor.
Importante
Na Meta, é o event_id igual nos dois envios que permite à plataforma deduplicar o evento do navegador e o do servidor. Com valores diferentes, ela não reconhece os dois como o mesmo evento.
A tela de Pixels tem duas ferramentas para isso:
- Inspecionar, na linha do pixel (disponível nas seis plataformas), abre um modal que transmite ao vivo os eventos daquele pixel, com o status da conexão: Desconectado, Conectando, Aguardando eventos, Recebendo eventos ou Erro na conexão. Ele só mostra o que acontece enquanto está aberto.
- Para o que já aconteceu, a seção Eventos mostra sucessos × erros por plataforma e canal num período. Com a Meta selecionada, aparece também a tabela Eventos com erros, agrupada por tipo de evento, com as mensagens de erro devolvidas pela plataforma e a opção Baixar relatório em CSV.
O uso dessas ferramentas está detalhado em Testando Eventos.
5. E se forem os números do dashboard que estão errados?
Os números do dashboard e o envio de eventos são coisas diferentes. O dashboard tem quatro plataformas. Google Ads, Google Analytics 4 e Meta Ads trazem dados sincronizados via OAuth das contas conectadas. Já Site (TagServer) é o rastreamento first-party do próprio TagServer no seu site: não há OAuth por trás, e um servidor cadastrado já conta como fonte conectada.
Se o dashboard de uma plataforma OAuth aparece desatualizado ou vazio, há duas causas distintas:
- A sincronização OAuth precisa de atenção. A reconexão está em Sincronização de dados.
- A conta não tem o recurso DataAnalytics. Nesse caso a tela de Dashboards mostra um bloqueio no lugar dos dashboards, e reconectar o OAuth não resolve. O texto do bloqueio indica a situação:
- "Análise não está no seu plano": o plano atual não inclui o recurso, e a tela indica o plano necessário ("Contrate o plano Tag Pro para montar dashboards e conectar suas fontes de dados.").
- "Pagamento confirmado": a conta já paga e o acesso está sendo liberado. A tela verifica de novo a cada 30 segundos e abre sozinha; aqui basta esperar.
- "Recurso não habilitado nesta conta": a conta é gerenciada pela equipe TagServer.
Ainda não resolveu?
Antes de acionar o suporte, valide o envio com as ferramentas de teste em tempo real para ter um resultado concreto para compartilhar. Depois, no app, abra o menu do perfil e clique em Suporte: o formulário Solicitar Suporte pede o assunto (Problema Técnico, Questão de Faturamento, Problema de Conta, Solicitação de Funcionalidade, Problema de Integração ou Outro), além de e-mail e telefone. Descreva o que você já verificou e o resultado dos testes. Se preferir, mande um e-mail para contato@tgsr.com.br.
Veja também
- Pixels: Plataformas e Credenciais: campos e tokens de cada plataforma.
- Testando Eventos: validar o disparo em tempo real.
- Sincronização de dados: reconectar e atualizar o OAuth do dashboard.