Adicionar a gtag.js ao seu site

A tag do Google (gtag.js) é uma API e estrutura de inclusão de tags JavaScript que permite enviar dados de eventos para o Google Analytics, o Google Ads e o Google Marketing Platform. Nesta página, você vai aprender a usar a gtag.js para configurar o Google Analytics em um site. Confira a documentação geral (ou seja, não específica de um produto) da gtag.js no guia para desenvolvedores.

Instalar a tag do Google

Para instalar a tag do Google, copie o código a seguir e cole logo após <head> em todas as páginas do site. Substitua GA_TRACKING_ID pelo ID da propriedade do Google Analytics a que você gostaria de enviar dados. É preciso implementar apenas um snippet por página.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_TRACKING_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){window.dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'GA_TRACKING_ID');
</script>

Esse snippet carrega a biblioteca da gtag.js, define GA_TRACKING_ID como o ID padrão da propriedade do Google Analytics e envia um hit de visualização de página para o Analytics.

Desativar a medição de visualizações de página

O comportamento padrão do snippet é enviar um hit de visualização de página ao Google Analytics. Na maioria dos casos, o comportamento esperado quando você adiciona o snippet a cada página do seu site é o registro automático das exibições. No entanto, se você não quiser que o snippet envie um hit de visualização de página ao Analytics, defina o parâmetro send_page_view como false:

gtag('config', 'GA_TRACKING_ID', { 'send_page_view': false });

Configurar mais propriedades do Google Analytics

Por padrão, o snippet configura uma única propriedade do Google Analytics. Para definir uma segunda propriedade com o ID de acompanhamento GA_TRACKING_ID_2, adicione outro comando config:

gtag('config', 'GA_TRACKING_ID_2');