Depuração

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 do analytics.js

O Google Analytics fornece uma versão de depuração da biblioteca do analytics.js que registra mensagens detalhadas para o console Javascript à medida que é executada. Essas mensagens incluem comandos executados, bem como avisos e mensagens de erro que podem informar quando seu código de acompanhamento está configurado incorretamente. Elas também fornecem detalhes de cada hit enviado ao Google Analytics para que você possa ver exatamente quais dados estão sendo acompanhados.

É possível ativar a versão de depuração do analytics.js. Para fazer isso, altere o URL no snippet de acompanhamento 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 do analytics.js envia dados ao Google Analytics exatamente como a versão que não é de depuração. Assim, você pode acessar um website executando o código do analytics.js e inspecionar a implementação sem interferir nos dados que estão sendo acompanhados.

Se você não quiser enviar dados para o Google Analytics em alguns casos (por exemplo, em ambientes de desenvolvimento ou testes), desative a tarefa sendHitTask para que nada seja enviado.

Ao executar em 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 rastreio

A ativação da depuração de rastreio gera mais informações detalhadas para o console.

Para ativar a depuração de rastreio, carregue a versão de depuração do analytics.js conforme descrito acima e adicione a linha de código JavaScript a seguir ao snippet de acompanhamento antes de qualquer chamada para a fila de comandos do ga().

window.ga_debug = {trace: true};

O snippet de acompanhamento completo com depuração de rastreio ativada tem esta aparência:

(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 fornece uma extensão para Chrome que pode ativar a versão de depuração do analytics.js sem exigir que você altere seu código de acompanhamento. Desse modo, você pode depurar seus próprios sites e também ver como outros sites implementaram o acompanhamento do Google Analytics com o analytics.js.

Assistente de tags do Google

O assistente de tags do Google é um extensão do Chrome que ajuda a validar o código de acompanhamento no seu website e resolver problemas comuns. É a ferramenta ideal para depurar e testar as implementações do analytics.js localmente e verificar se tudo está correto antes de implementar seu código para a produção.

O assistente de tags permite que você registre o fluxo típico dos usuários. Ele registra todos os hits enviados, verifica se há algum problema com eles e fornece um relatório completo sobre as interações. Se ele detectar algum problema ou oportunidades de melhoria, você será informado.

Para saber mais, acesse a Central de Ajuda e meia 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 de acompanhamento avançadas, como acompanhamento em vários domínios.