A tag do Google (gtag.js) é uma API e estrutura de inclusão de tags JavaScript que permite enviar dados de eventos para o 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. Veja 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');