Medir as visualizações de página

Há duas maneiras de enviar uma visualização de página ao Google Analytics:

  1. Usar o comportamento padrão do snippet da gtag.js
  2. Enviar eventos page_view manuais

Comportamento padrão

Quando você adiciona a gtag.js ao seu site, o snippet inclui um comando "config" que, por padrão, envia uma visualização de página. Você pode incluir outros parâmetros para definir esse comportamento:

gtag('config', 'GA_MEASUREMENT_ID', <parameters>);

em que <parameters> é um objeto usado para definir como o Google Analytics é inicializado. Ao personalizar o comportamento de visualização de página, as seguintes chaves podem ser usadas:

Nome Tipo Obrigatório Valor padrão Descrição
page_title string Não document.title Título da página.
page_location string Não location.href URL da página.
page_path string Não location.pathname

Caminho para a página. Se esse valor for substituído, ele precisará começar com um caractere /.

send_page_view boolean Não true Se uma visualização de página deve ou não ser enviada.

Por exemplo, o comportamento a seguir substitui os valores page_title e page_path:

gtag('config', 'GA_MEASUREMENT_ID', {
  'page_title' : 'homepage',
  'page_path': '/home'
});

Várias propriedades

Para enviar visualizações de página a várias propriedades do Google Analytics, especifique cada propriedade em uma chamada gtag('config'):

gtag('config', 'GA_MEASUREMENT_ID_1');
gtag('config', 'GA_MEASUREMENT_ID_2');

Essa não é uma configuração permanente e precisa ser repetida em todas as páginas do seu site que usam o snippet gtag.js.

Visualizações de página manuais

Para a maioria das implementações do Google Analytics, o snippet padrão não precisa ser modificado. No entanto, se você quiser controlar manualmente como as visualizações de página são enviadas (por exemplo, aplicativos de página única ou rolagem infinita), faça o seguinte:

  1. Desative a medição de visualizações de página.
  2. Envie o evento page_view quando apropriado.

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

Para desativar o hit de visualização de página padrão, defina o parâmetro send_page_view como false no snippet da gtag.js.

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

A configuração send_page_view não é aplicada a todas as páginas. Essa definição precisa ser repetida em todas as páginas do site em que você quer desativar as visualizações automáticas.

Se o snippet estiver configurado para várias propriedades, desative a visualização de página para cada comando "config":

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

Enviar eventos page_view manualmente

Quando apropriado, faça a seguinte chamada gtag, substituindo os valores do marcador conforme necessário:

gtag('event', 'page_view', {
  page_title: '<Page Title>',
  page_location: '<Page Location>',
  page_path: '<Page Path>',
  send_to: '<GA_MEASUREMENT_ID>'
})