Este guia explica como usar a versão de depuração da biblioteca do analytics.js para garantir o funcionamento correto das suas implementações.
A versão de depuração da biblioteca analytics.js
O Google Analytics fornece uma versão de depuração da biblioteca analytics.js que registra mensagens detalhadas para o Console JavaScript à medida que é executada. Essas mensagens incluem os comandos executados com êxito, bem como avisos e mensagens de erro que informam quando sua tag está configurada incorretamente. Elas também fornecem um detalhamento de cada hit enviado ao Google Analytics para que você saiba quais dados estão sendo coletados.
É possível ativar a versão de depuração da analytics.js alterando o URL na tag JavaScript de https://www.google-analytics.com/analytics.js para https://www.google-analytics.com/analytics_debug.js:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Como testar sua implementação sem enviar hits
A versão de depuração da analytics.js envia dados ao Google Analytics exatamente como a versão que não é de depuração. Você pode acessar um site que executa o código da analytics.js e inspecionar a implementação sem interferir na coleta de dados.
Se não quiser enviar dados ao Google Analytics em casos específicos (por exemplo, em ambientes de desenvolvimento ou teste), desative a tarefa sendHitTask.
Ao ser executado em um localhost, o código a seguir impedirá o envio de hits para o Google Analytics:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
if (location.hostname == 'localhost') {
ga('set', 'sendHitTask', null);
}
ga('send', 'pageview');
Depuração de rastros
A ativação da depuração de rastros gera mais informações detalhadas para o Console.
Para ativá-la, carregue a versão de depuração da analytics.js conforme descrito acima e adicione a seguinte linha de JavaScript antes de qualquer chamada para a fila de comandos do ga().
window.ga_debug = {trace: true};
Veja a seguir a tag completa com depuração de rastros ativada:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
window.ga_debug = {trace: true};
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Extensão do depurador do Google Analytics para Chrome
O Google Analytics também oferece uma extensão do Chrome que pode ativar a versão de depuração da analytics.js sem que você precise mudar sua tag. Desse modo, é possível depurar seus próprios sites e ver como outros sites implementaram o Google Analytics com a analytics.js.
Assistente de tags do Google
O Assistente de tags do Google é uma extensão do Chrome que ajuda a validar a tag no seu site e resolver problemas comuns. Ele é a ferramenta ideal para depurar e testar as implementações da analytics.js localmente e verificar se tudo está correto antes de implantar seu código na produção.
O Assistente de tags permite que você registre o fluxo típico de usuários. Ele coleta todos os hits enviados, verifica se há problemas e gera um relatório completo das interações. Além disso, a ferramenta informará você caso detecte algum problema ou oportunidades de melhoria.
Para saber mais, acesse a Central de Ajuda e leia Sobre o Assistente de tags e Sobre os Registros do Assistente de tags. Você também pode assistir a este vídeo de demonstração que mostra o Assistente de tags sendo usado para detectar erros e verificar a validade de implementações avançadas, como medição de vários domínios.