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 aplicativos.
Este documento descreve o comportamento padrão de visualização de página e como enviar suas 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:
- Criar uma conta e uma propriedade do Google Analytics. Esta etapa cria uma tag do Google automaticamente para você.
- Criar um fluxo de dados da Web para seu site
- Colocar o snippet de tag do Google no seu site
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 |
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:
Desativar a medição de visualizações de página
Para desativar o evento page_view padrão enviado pelo comando config
quando a tag do Google é carregada, 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 no comando config não é mantida em todas as páginas. Essa configuração precisa ser repetida em todas as páginas do seu site em que você quer desativar a visualização de página automática no carregamento da tag.
Desativar mudanças de página com base em eventos do histórico de navegação
Se a medição otimizada estiver ativada, o Google Analytics
vai enviar eventos page_view com base nas mudanças do histórico de navegação, mesmo que você defina
send_page_view: false. Por padrão, a medição otimizada detecta eventos de histórico, como os usados em aplicativos de página única, e envia page_view
eventos independentemente do send_page_view parâmetro no config comando.
Para evitar que eventos page_view sejam enviados devido a mudanças no histórico, você também precisa configurar as definições de medição otimizada na sua propriedade do Google Analytics.
Você pode desativar a opção "Mudanças na página com base em eventos do histórico de navegação" nas definições de medição otimizada do seu fluxo de dados da Web. Saiba mais sobre
os eventos de medição otimizada.
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>'
});