Adicionar gtag.js ao seu site

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

Instalar a tag global do site

Para instalar a tag global, copie o código a seguir e cole-o imediatamente após a tag <head> de todas as páginas do seu site. Substitua GA_MEASUREMENT_ID pelo código da propriedade do Google Analytics à qual você quer enviar os dados. É preciso implementar apenas um snippet global por página.

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

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

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

Desativar a avaliação de visualização 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 desejado quando você adiciona o snippet a cada página do seu site é o registro automático das visualizações. No entanto, se você não quiser que o snippet envie o hit ao Google Analytics, defina o parâmetro send_page_view como false:

gtag('config', 'GA_MEASUREMENT_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 código de avaliação GA_MEASUREMENT_ID_2, adicione outro comando config:

gtag('config', 'GA_MEASUREMENT_ID_2');