Medir as visualizações de página

Sempre que alguém carrega uma página do seu site ou o estado do histórico de navegação é alterado pelo site ativo, um evento de medição otimizada chamado page_view é enviado do seu site para o Google Analytics. Como o evento é enviado automaticamente, não é necessário enviar de maneira manual os dados de visualização de página ao Google Analytics.

No entanto, quando você quiser controlar manualmente o envio de visualizações de página (por exemplo, aplicativos de página única ou rolagem infinita), desative as visualizações de página e envie manualmente do seu site. Saiba como medir aplicativos de página única.

Neste documento, descrevemos o comportamento padrão e como enviar as próprias visualizações de página manualmente.

Para saber como medir exibições de tela em um app para dispositivos móveis, consulte Medir as exibições de tela.


Antes de começar

Para seguir este guia, você precisa ter concluído as seguintes etapas:

Você também precisa ter o seguinte:

  • Acesso ao código-fonte do site
  • Função de editor (ou superior) na conta do Google Analytics

Comportamento padrão

Quando você adiciona a tag do Google (gtag.js) ao seu site, o snippet inclui um comando config que envia uma visualização de página por padrão. Você pode incluir outros parâmetros <parameters> com informações sobre a visualização de página para especificar como o Google Analytics é inicializado:

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

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.

Se você modificar page_location, o valor precisará começar com o protocolo seguido pelo URL completo. Por exemplo, https://www.example.com/contact-us-submitted.

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

Por exemplo, o código a seguir substitui os valores de "page_title":

gtag('config', 'TAG_ID', {
  'page_title' : 'homepage'
});

Visualizações de página manuais

Quando 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. Desativar 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 evento page_view padrão, defina o parâmetro send_page_view como false no snippet de tag do Google.

gtag('config', 'TAG_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.

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