Adição do analytics.js ao seu site

A biblioteca analytics.js é uma biblioteca JavaScript para avaliar como os usuários interagem com seu website. Este documento explica como adicionar a analytics.js ao seu site.

Snippet de acompanhamento JavaScript

A adição do código a seguir (conhecido como "snippet de acompanhamento JavaScript") aos modelos do seu site é a maneira mais fácil de começar a usar a analytics.js.

O código deve ser adicionado antes da tag </head> de fechamento, e a string 'UA-XXXXX-Y' deve ser substituída pelo ID da propriedade (também chamado de "ID de acompanhamento") da propriedade do Google Analytics que você deseja acompanhar.

<!-- Google Analytics -->
<script>
(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.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

O código acima realiza quatro ações principais:

  1. Cria um elemento <script> que começa a fazer o download da biblioteca JavaScript analytics.js de maneira assíncrona a partir de https://www.google-analytics.com/analytics.js
  2. Inicializa uma função ga global (chamada de fila de comandos do ga()) que permite agendar comandos para serem executados depois que a biblioteca analytics.js é carregada e está pronta para ser usada.
  3. Adiciona um comando à fila de comandos do ga() para criar um novo objeto de acompanhamento para a propriedade especificada por meio do parâmetro 'UA-XXXXX-Y'.
  4. Adiciona outro comando à fila de comandos do ga() para enviar uma exibição de página ao Google Analytics para a página atual.

Implementações personalizadas podem exigir a modificação das duas últimas linhas do snippet de acompanhamento JavaScript (os comandos create e send) ou a adição de outro código para acompanhar mais interações. No entanto, você não deve alterar o código que carrega a biblioteca analytics.js ou inicializa a função da fila de comandos do ga().

Snippet de acompanhamento assíncrono alternativo

Embora o snippet de acompanhamento JavaScript descrito acima garanta que o script será carregado e executado de maneira assíncrona em todos os navegadores, ele tem a desvantagem de não permitir que navegadores modernos pré-carreguem o script.

O snippet de acompanhamento assíncrono alternativo abaixo acrescenta suporte para pré-carregamento. Isso proporciona uma pequena melhoria no desempenho em navegadores modernos, mas pode prejudicar o carregamento síncrono e a execução no IE 9 e em navegadores mais antigos para dispositivos móveis que não reconhecem o atributo de script async. Use esse snippet de acompanhamento somente se os visitantes usarem principalmente navegadores modernos para acessar seu site.

<!-- Google Analytics -->
<script>
window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
</script>
<script async src='https://www.google-analytics.com/analytics.js'></script>
<!-- End Google Analytics -->

Quais dados o snippet de acompanhamento captura?

Quando você adiciona um desses snippets de acompanhamento ao seu website, envia uma exibição de página para cada página que os usuários acessam. O Google Analytics processa esses dados e pode inferir uma grande quantidade de informações, incluindo:

  • O tempo total que um usuário passa no seu site.
  • O tempo que um usuário passa em cada página e em que ordem essas páginas foram acessadas.
  • Quais links internos foram clicados (com base no URL da próxima exibição de página).

Além disso, o endereço IP, a string user-agent e a inspeção inicial de página que a analytics.js faz ao criar um novo rastreador são usados para determinar:

  • A localização geográfica do usuário.
  • O navegador e o sistema operacional usados.
  • O tamanho da tela e se o Flash ou o Java está instalado.
  • O site de referência.

Próximas etapas

Para necessidades básicas de relatórios, os dados coletados por meio do snippet de acompanhamento JavaScript podem ser suficientes. No entanto, em muitos casos você quer obter respostas para dúvidas adicionais sobre seus usuários.

Os guias deste site explicam como acompanhar as interações que são importantes para você com a analytics.js. Entretanto, antes de implementar determinado recurso, é altamente recomendável ler os guias listados na seção Princípios básicos, na navegação à esquerda. Esses guias proporcionam uma visão geral de alto nível da biblioteca analytics.js e ajudam você a entender melhor os exemplos de código usados em todo o site.

O próximo guia dessa série explica como a analytics.js funciona.