Avaliar as visualizações de página

Há duas maneiras de enviar uma exibiçã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 exibiçã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 exibiçã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 modificado, ele precisará começar com um caractere /.

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

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

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

Várias propriedades

Para enviar exibiçõ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.

Exibiçõ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 exibições de página serão enviadas (por exemplo, aplicativos de página única ou rolagem infinita), faça o seguinte:

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

Desativar a avaliação de exibições de página

Para desativar o hit de exibição de página padrão, defina o parâmetro send_page_view como false no snippet 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 exibições automáticas.

Se o snippet estiver definido para várias propriedades, desative a exibição de página para cada comando de configuração:

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>'
})