Problemas Comuns e Soluções
"Respostas rápidas para os problemas mais frequentes de instalação, verificação e visualização de dados."
Se algo não parece estar funcionando como esperado, não entre em pânico. A maioria dos problemas de rastreamento tem causas simples relacionadas a cache ou tempo de processamento.
Aqui estão as soluções para os cenários mais comuns.
1. A Verificação da Instalação Falhou
Você colou o código, salvou, clicou em verificar, mas o sistema diz que o script não foi encontrado.
Causa A: Cache (A mais comum)
Seu site (ou serviço de hospedagem) salva uma versão antiga da página para carregar mais rápido. Quando nosso robô visita seu site, ele recebe essa versão velha que ainda não tem o script.
- Solução: Limpe o cache do seu site/plugin de cache (ex: WP Rocket, Cloudflare) e tente novamente.
Causa B: Bloqueio de Robôs (Firewall)
Alguns sites possuem proteção contra bots que bloqueiam nossa verificação automática "Headless".
- Solução: O Intentyon detectará isso e ativará a Verificação em Tempo Real. Abra seu site em uma nova aba quando solicitado. Isso usará seu navegador real para confirmar a instalação.
Causa C: Instalação no Local Errado
O script deve estar dentro da tag <head>. Se estiver no rodapé (<footer>) ou dentro do <body>, a verificação pode falhar ou o rastreamento ficará impreciso.
2. Dados não aparecem no Facebook/Google
Você configurou o evento, ele disparou no Intentyon, mas não aparece no Gerenciador de Anúncios.
Causa A: Tempo de Processamento da Plataforma
O Intentyon envia o evento quase instantaneamente (Server-Side). Porém, o Facebook e o Google levam tempo para processar, desduplicar e exibir esse dado nos relatórios.
- Meta Ads: Pode levar de 20 minutos a 1 hora para aparecer no Gerenciador de Eventos.
- GA4: Pode levar até 24 horas para aparecer nos relatórios padrão (mas aparece rápido na visão "Tempo Real").
Causa B: Deduplicação
Se você tem o Pixel instalado no site (via navegador) e também usa o Intentyon (via servidor), o Facebook tentará juntar os dois eventos. Se ele conseguir, ele mostrará apenas 1 evento (o desduplicado). Isso é bom! Significa que o dado foi enriquecido, não duplicado.
3. Discrepância de Números (Intentyon vs. Analytics)
"O Google Analytics diz que tive 1.000 visitas, mas o Intentyon diz 950."
Pequenas diferenças (até 10-15%) são normais e esperadas no mercado de analytics. Cada ferramenta usa uma metodologia diferente:
- Google Analytics: Baseia-se fortemente em cookies de terceiros e amostragem.
- Intentyon: Baseia-se em Sessões Únicas e armazenamento local. Nós filtramos interações muito breves ou bots que não executam JavaScript corretamente.
Se a diferença for drástica (> 30%), verifique se o script do Intentyon está instalado em todas as páginas do site (incluindo checkout e páginas de obrigado, mas isso é praticamente nulo, considerando que o snippet é sempre instalado globalmente, a não ser que algumas páginas foram incluídas para exclusão de rastreamento nas configurações do projeto ou evento).
4. Modo de Depuração (Debug Mode)
Se você é um usuário avançado e quer ver exatamente o que o script está fazendo no seu site, incluímos uma ferramenta de diagnóstico oculta.
- Acesse seu site.
- Adicione
?debug=trueao final da URL (ex:meusite.com/?debug=true). - Abra o Console do Desenvolvedor do navegador (F12 > Console).
- O Intentyon começará a exibir logs detalhados:
[INTENTYON] Configuração carregada...[INTENTYON] Evento na fila: SCROLL_DEPTH...[INTENTYON] Enviando lote...
Isso ajuda a confirmar se o script está carregando e se as regras estão sendo detectadas localmente.
Ainda com problemas?
Se você tentou os passos acima e ainda enfrenta dificuldades, nossa equipe de suporte está pronta para ajudar.
Ao abrir um ticket, por favor informe:
- O ID do Projeto.
- A URL exata onde o problema ocorre.
- Se possível, um print da tela de erro ou do console de depuração.