O teu rastreio de conversões deixa de disparar. O tráfego desaparece. Um evento deixa de ser acionado. Algo avariou, mas não sabes o quê. Depurar é o processo de encontrar e corrigir o problema.
A maioria dos problemas de rastreio tem causas óbvias quando sabes onde procurar. Aprender a depurar poupa horas de tentativas às cegas.
O processo de depuração
Passo 1: Confirma que o problema existe
O rastreio está mesmo avariado ou leste mal os dados? Verifica várias vistas. Verifica intervalos de datas diferentes. Confirma que o problema é real e persistente.
Passo 2: Identifica quando começou
Quando parou o rastreio? Ontem? Na semana passada? Consegues apontar o dia? Olha para os dados históricos. Quando aconteceu a queda? Isto reduz o âmbito das causas.
Passo 3: Verifica se algo mudou
Fizeste uma atualização de código recentemente? Mudaste a configuração? Lançaste uma nova funcionalidade? As alterações causam muitas vezes problemas. O que mudou por volta da altura em que o rastreio avariou?
Passo 4: Usa ferramentas de depuração
Usa o modo de depuração da tua ferramenta de análise. Usa as ferramentas de programador do navegador. Usa a monitorização de rede. Vê os pedidos a acontecer em tempo real para perceberes onde falham.
Passo 5: Testa manualmente
Cria tráfego de teste. Testa a conversão. Testa o evento. Se o teu teste dispara o rastreio mas o tráfego real não, o problema está na produção. Se o teste também não funciona, o problema está na implementação.
Passo 6: Corrige e verifica
Aplica a correção. Testa outra vez. Confirma que a correção funciona antes de a dares por concluída.
Problemas de rastreio comuns e como depurá-los
O código de rastreio não dispara
Abre as ferramentas de programador do navegador. Vai ao separador Rede. Procura pedidos ao domínio da tua análise. Vês algum? Se não, o código não está a disparar.
Verifica a consola do navegador à procura de erros de JavaScript. Os erros impedem o código de rastreio de correr. Corrige o erro e o rastreio vai disparar.
O código de rastreio carrega mas os dados não aparecem nos relatórios
O pedido está a ser enviado (vês no separador Rede), mas não aparece nos relatórios. Causas possíveis: uma firewall a bloquear o pedido, um bloqueador de anúncios a bloqueá-lo, ID de propriedade errado, objetivo de conversão mal configurado.
Confirma que estás a rastrear a propriedade certa. Confirma que nenhum filtro está a excluir os dados de teste. Confirma que a filtragem de bots não está a apanhar o teu teste.
O rastreio dispara umas vezes mas não de forma consistente
Os problemas intermitentes são mais difíceis de depurar. Podem ser condições de corrida (o rastreio dispara antes de os dados estarem prontos). Podem ser tempos limite de rede. Pode ser código condicional que nem sempre corre.
Olha para o código. Há condições que por vezes impedem o rastreio de disparar? Há tempos limite? O rastreio está a acontecer no momento certo?
O rastreio de conversões dispara mas as conversões não aparecem
O código de rastreio dispara. O pedido chega ao servidor. Mas as conversões não aparecem nos relatórios. Causas possíveis: o objetivo de conversão não está configurado, o URL do objetivo não coincide com a página de conversão real, o objetivo dispara várias vezes por sessão (contado como um).
Verifica a configuração do teu objetivo de conversão. O URL coincide? O objetivo dispara no evento certo? Está configurado para contar uma vez ou várias vezes?
O rastreio de eventos dispara mas os dados estão incompletos
Os eventos disparam, mas faltam alguns parâmetros do evento. A receita aparece como 0 $. O ID do produto está em branco. O evento é rastreado, mas de forma incompleta.
Verifica o teu código de rastreio. Os parâmetros estão a ser captados corretamente? Estão a ser passados à chamada de rastreio? Os dados estão disponíveis no momento do rastreio?
Ferramentas de depuração
Ferramentas de programador do navegador
Separador Rede: vê os pedidos a serem enviados. Separador Consola: vê os erros de JavaScript. Ambos são essenciais para depurar o rastreio do lado do cliente.
Modo de depuração da análise
A maioria das ferramentas tem um modo de depuração. O Google Analytics tem o DebugView. As plataformas de análise de produto têm uma vista de eventos em direto. Mostram os eventos em tempo real à medida que disparam.
Extensões de navegador
Extensões como o Tag Assistant e outras extensões de depuração ajudam a inspecionar o código de rastreio e a depurar problemas.
Registos do servidor
Os registos do servidor mostram todos os pedidos, incluindo os pedidos de rastreio. Consulta-os para ver se os pedidos de rastreio sequer chegam ao teu servidor.
Evitar problemas de rastreio
Testa antes de publicar
Não publiques alterações ao código de rastreio em produção sem testar. Testa primeiro num ambiente de testes. Confirma que o rastreio funciona aí antes de ires para o ar.
Monitoriza depois de publicar
Depois de publicares alterações, monitoriza durante 24 horas. Fica atento a quedas de tráfego ou de conversões. Apanha os problemas depressa.
Mantém registos de alterações
Documenta todas as alterações que fazes ao código de rastreio. Quando foi alterado, o que mudou, porquê. Isto ajuda-te a seguir os problemas até à causa.
Usa controlo de versões
Mantém o código de rastreio sob controlo de versões. Assim consegues comparar versões se algo avariar. Podes voltar à versão anterior se for preciso.
Perguntas frequentes
Como sei se o meu rastreio está avariado ou se é apenas pouco tráfego?
Compara com os padrões normais. Se o tráfego costuma ter uma média de 1000 e cai de repente para 100, algo está errado. Se cair para 800 e não correste campanhas nessa semana, provavelmente está tudo bem. Com o criador de websites da WEMASY, podes configurar isto diretamente no teu website.
Posso depurar o rastreio sem ferramentas de programador?
Não com facilidade. As ferramentas de programador são essenciais. Se não te sentes à vontade para as usar, pede ajuda a um programador ou usa as funcionalidades de depuração integradas da tua ferramenta de análise.
Quanto tempo deve demorar a depuração?
Problemas simples (ID de propriedade errado, objetivo mal configurado): 15-30 minutos. Problemas complexos (condições de corrida, problemas de rede): 1-4 horas. Tem um programador disponível se a depuração demorar mais de uma hora.
E se não conseguir encontrar o problema?
Documenta o que já verificaste. Pede ajuda ao fornecedor da tua análise ou a um consultor. Por vezes um olhar novo apanha o problema.
Devo reverter as alterações se o rastreio avariar depois de uma publicação?
Se acabaste de publicar e o rastreio avaria, sim. Reverte logo. Depois depura no ambiente de testes antes de publicar de novo.
Os bloqueadores de anúncios podem estragar o meu rastreio permanentemente?
Os bloqueadores de anúncios não estragam o rastreio para os utilizadores sem bloqueadores. Só o bloqueiam para quem os tem. O teu rastreio funciona bem para a maioria dos utilizadores sem bloqueadores.