Há duas maneiras de enviar uma visualização de página ao Google Analytics:
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:
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>'
})