Este documento lista todos os campos de configuração do GA4.
allow_google_signals
Para desativar todos os Recursos de publicidade, defina allow_google_signals
como false
.
Nome do campo | Tipo | Valor padrão |
---|---|---|
allow_google_signals |
boolean |
verdadeiro |
Exemplo
Definir globalmente
gtag('set', 'allow_google_signals', true);
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'allow_google_signals': true
});
allow_ad_personalization_signals
Defina como false
para desativar os recursos de personalização de publicidade.
Nome do campo | Tipo | Valor padrão |
---|---|---|
allow_ad_personalization_signals |
boolean |
verdadeiro |
Exemplo
Definir globalmente
gtag('set', 'allow_ad_personalization_signals', true);
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'allow_ad_personalization_signals': true
});
campaign_content
Usado para testes A/B e anúncios com segmentação por conteúdo. Use campaign_content
para diferenciar anúncios ou links que levam ao mesmo URL.
Nome do campo | Tipo | Valor padrão |
---|---|---|
campaign_content |
string |
undefined |
Exemplo
Definir globalmente
gtag('set', 'campaign_content', 'logolink');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'campaign_content': 'logolink'
});
campaign_id
Usado para identificar a campanha associada a essa referência. Use campaign_id
para identificar uma campanha específica.
Nome do campo | Tipo | Valor padrão |
---|---|---|
campaign_id |
string |
undefined |
Exemplo
Definir globalmente
gtag('set', 'campaign_id', 'abc.123');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'campaign_id': 'abc.123'
});
campaign_medium
Use campaign_medium
para identificar uma mídia, como e-mail ou custo por clique.
Nome do campo | Tipo | Valor padrão |
---|---|---|
campaign_medium |
string |
undefined |
Exemplo
Definir globalmente
gtag('set', 'campaign_medium', 'cpc');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'campaign_medium': 'cpc'
});
campaign_name
Usado para análise de palavras-chave. Use campaign_name
para identificar uma campanha estratégica ou de promoção de produto específica.
Nome do campo | Tipo | Valor padrão |
---|---|---|
campaign_name |
string |
undefined |
Exemplo
Definir globalmente
gtag('set', 'campaign_name', 'spring_sale');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'campaign_name': 'spring_sale'
});
campaign_source
Use campaign_source
para identificar um mecanismo de pesquisa, o nome da newsletter ou outra fonte.
Nome do campo | Tipo | Valor padrão |
---|---|---|
campaign_source |
string |
undefined |
Exemplo
Definir globalmente
gtag('set', 'campaign_source', 'google');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'campaign_source': 'google'
});
campaign_term
Usado para pesquisa paga. Use campaign_term
para indicar as palavras-chave do anúncio.
Nome do campo | Tipo | Valor padrão |
---|---|---|
campaign_term |
string |
undefined |
Exemplo
Definir globalmente
gtag('set', 'campaign_term', 'running+shoes');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'campaign_term': 'running+shoes'
});
campaign
Um objeto que contém todos os valores da campanha que podem ser definidos.
O objeto campaign
oferece suporte a implementações legadas e não é recomendado na maioria dos casos. Em vez disso, use a versão com o prefixo campaign
de cada campo:
Nome do campo | Tipo | Valor padrão |
---|---|---|
campaign |
object |
undefined |
Exemplo
Definir globalmente
gtag('set', 'campaign', {
'id': 'abc.123',
'source': 'google',
'medium': 'cpc',
'name': 'spring_sale',
'term': 'running+shoes',
'content': 'logolink'
});
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'campaign': {
'id': 'abc.123',
'source': 'google',
'medium': 'cpc',
'name': 'spring_sale',
'term': 'running+shoes',
'content': 'logolink'
}
});
client_id
Identifica pseudonimamente uma instância do navegador. Por padrão, esse valor é armazenado como parte do cookie primário do Google Analytics com uma validade de dois anos.
Nome do campo | Tipo | Valor padrão |
---|---|---|
client_id |
string |
Um valor gerado aleatoriamente para cada usuário. |
Exemplo
Definir globalmente
gtag('set', 'client_id', 'aaa.bbb');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'client_id': 'aaa.bbb'
});
content_group
Nome do campo | Tipo | Valor padrão |
---|---|---|
content_group |
string |
Exemplo
Definir globalmente
gtag('set', 'content_group', '/news/sports');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'content_group': '/news/sports'
});
cookie_domain
Especifica o domínio usado para armazenar o cookie do Google Analytics.
Defina como 'none'
para configurar o cookie sem especificar um domínio.
Defina como 'auto'
(o valor padrão) para configurar o cookie como o domínio de nível superior mais um subdomínio (eTLD +1). Por exemplo, se cookie_domain
estiver definido como 'auto'
, https://example.com
usará example.com
para o domínio, e https://subdomain.example.com
também usará example.com
para o domínio.
Nome do campo | Tipo | Valor padrão |
---|---|---|
cookie_domain |
string |
'auto' |
Exemplo
Definir globalmente
gtag('set', 'cookie_domain', 'example.com');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'cookie_domain': 'example.com'
});
cookie_expires
Sempre que um hit é enviado ao Google Analytics, o prazo de validade do cookie é atualizado para a hora atual mais o valor do campo cookie_expires
.
Isso significa que, se você usar o tempo padrão de dois anos (63.072.000 segundos), e um usuário acessar seu site todos os meses, o cookie dele nunca vai expirar.
Se você definir o tempo de cookie_expires
como 0 (zero) segundos, o cookie vai usar a sessão como base e expirar quando a sessão atual do navegador terminar.
Nome do campo | Tipo | Valor padrão |
---|---|---|
cookie_expires |
number |
63072000 |
Exemplo
Definir globalmente
gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});
cookie_flags
Quando definidas, anexam mais sinalizações ao cookie. Elas devem ser separadas por ponto e vírgula. Consulte Escrever um novo cookie (em inglês) para ver alguns exemplos de sinalizações a serem definidas.
Nome do campo | Tipo | Valor padrão |
---|---|---|
cookie_flags |
string |
Exemplo
Definir globalmente
gtag('set', 'cookie_flags', 'SameSite=None;Secure');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'cookie_flags': 'SameSite=None;Secure'
});
cookie_path
Especifica o subcaminho usado para armazenar o cookie do Google Analytics.
Nome do campo | Tipo | Valor padrão |
---|---|---|
cookie_path |
string |
'/' |
Exemplo
Definir globalmente
gtag('set', 'cookie_path', '/example_path');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'cookie_path': '/example_path'
});
cookie_prefix
Especifica um prefixo para anexar aos nomes de cookies do Google Analytics.
Nome do campo | Tipo | Valor padrão |
---|---|---|
cookie_prefix |
string |
Exemplo
Definir globalmente
gtag('set', 'cookie_prefix', 'prefix');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'cookie_prefix': 'prefix'
});
cookie_update
Quando cookie_update
for definido como true
, a gtag.js atualizará os cookies em cada carregamento de página. Dessa forma, a validade é definida em relação à visita mais recente ao site. Por exemplo, se o cookie expirar em uma semana, e o usuário acessar a página com o mesmo navegador a cada cinco dias, a validade será atualizada em cada visita e, portanto, nunca vai expirar.
Quando for definido como false
, os cookies não serão atualizados em cada carregamento de página. Dessa forma, a expiração terá como base a primeira visita do usuário.
Nome do campo | Tipo | Valor padrão |
---|---|---|
cookie_update |
boolean |
true |
Exemplo
Definir globalmente
gtag('set', 'cookie_update', true);
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'cookie_update': true
});
ignore_referrer
Defina como true
para indicar ao Analytics que o referenciador não deve ser exibido como uma origem de tráfego.
Saiba quando usar esse campo
Nome do campo | Tipo | Valor padrão |
---|---|---|
ignore_referrer |
boolean |
falso |
Exemplo
Definir globalmente
gtag('set', 'ignore_referrer', true);
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'ignore_referrer': true
});
language
Especifica a preferência de idioma do usuário. O padrão é o valor navigator.language
do usuário (link em inglês).
Nome do campo | Tipo | Valor padrão |
---|---|---|
language |
string |
O valor padrão será navigator.language . |
Exemplo
Definir globalmente
gtag('set', 'language', 'en-us');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'language': 'en-us'
});
page_location
Especifica o URL completo da página. O padrão é o valor document.location
do usuário.
Nome do campo | Tipo | Valor padrão | Limite de caracteres |
---|---|---|---|
page_location |
string |
O valor padrão é document.location |
1.000 |
Exemplo
Definir globalmente
gtag('set', 'page_location', 'https://example.com/page1');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'page_location': 'https://example.com/page1'
});
page_referrer
Especifica qual origem de referência gerou tráfego para uma página. Esse valor também é usado para calcular a origem do tráfego. O formato desse valor é um URL.
O padrão é o valor document.referrer
do usuário.
Nome do campo | Tipo | Valor padrão | Limite de caracteres |
---|---|---|---|
page_referrer |
string |
O valor padrão será document.referrer . |
420 |
Exemplo
Definir globalmente
gtag('set', 'page_referrer', 'https://example.com');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'page_referrer': 'https://example.com'
});
page_title
Refere-se ao título da página ou do documento. O padrão é o valor document.title
do usuário (link em inglês).
Nome do campo | Tipo | Valor padrão | Limite de caracteres |
---|---|---|---|
page_title |
string |
O valor padrão será document.title . |
300 |
Exemplo
Definir globalmente
gtag('set', 'page_title', 'Settings');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'page_title': 'Settings'
});
send_page_view
Defina como falso para impedir que o snippet padrão envie um "page_view".
Nome do campo | Tipo | Valor padrão |
---|---|---|
send_page_view |
boolean |
verdadeiro |
Exemplo
Definir globalmente
gtag('set', 'send_page_view', false);
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'send_page_view': false
});
screen_resolution
Especifica a resolução da tela. É preciso ter dois números inteiros positivos separados por um x
. Por exemplo, para uma tela de 800 x 600 pixels, o valor é 800x600
. Calculado com base no valor window.screen
do usuário (link em inglês).
Nome do campo | Tipo | Valor padrão |
---|---|---|
screen_resolution |
string |
O valor padrão será calculado com base em window.screen .
|
Exemplo
Definir globalmente
gtag('set', 'screen_resolution', '800x600');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'screen_resolution': '800x600'
});
user_id
Especifica um identificador conhecido para um usuário disponibilizado pelo proprietário do site/usuário da biblioteca. Ele não pode conter informações de identificação pessoal (PII). O valor não pode ser mantido nos cookies nem em outra opção de armazenamento do Google Analytics.
Nome do campo | Tipo | Valor padrão | Limite de caracteres |
---|---|---|---|
user_id |
string |
256 |
Exemplo
Definir globalmente
gtag('set', 'user_id', 'id');
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'user_id': 'id'
});
user_properties
As propriedades do usuário são atributos que podem ser utilizados para descrever segmentos da sua base de usuários, como preferência de idioma ou localização geográfica. É possível configurar até 25 propriedades do usuário adicionais por projeto.
Nome do campo | Tipo | Valor padrão | Limite de caracteres |
---|---|---|---|
user_properties |
object |
property name=24 property value=36 |
Exemplo
Definir globalmente
gtag('set', 'user_properties', {
'favorite_color': 'blue'
});
Definir para um único fluxo
gtag('config', 'STREAM_ID', {
'user_properties': {
'favorite_color': 'blue'
}
});