Configuração

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 true

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 true

Exemplo

Definir globalmente

gtag('set', 'allow_ad_personalization_signals', true);

Definir para um único fluxo

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

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

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 usaria example.com para o domínio, e https://subdomain.example.com também usaria example.com para o domínio.

Nome do campo Tipo Valor padrão
cookie_domain string 'auto'

Definir globalmente

gtag('set', 'cookie_domain', 'example.com');

Definir para um único fluxo

gtag('config', 'STREAM_ID', {
  'cookie_domain': 'example.com'
});

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 string 63072000

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 */
});

Quando definidas, anexam mais sinalizações ao cookie. Elas devem ser separadas por ponto e vírgula. Consulte Escrever um novo cookie para ver alguns exemplos de sinalizações a serem definidas.

Nome do campo Tipo Valor padrão
cookie_flags string

Definir globalmente

gtag('set', 'cookie_flags', 'SameSite=None;Secure');

Definir para um único fluxo

gtag('config', 'STREAM_ID', {
  'cookie_flags': 'SameSite=None;Secure'
});

Especifica o subcaminho usado para armazenar o cookie do Google Analytics.

Nome do campo Tipo Valor padrão
cookie_path string '/'

Definir globalmente

gtag('set', 'cookie_path', '/example_path');

Definir para um único fluxo

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

Especifica um prefixo para anexar aos nomes de cookies do Google Analytics.

Nome do campo Tipo Valor padrão
cookie_prefix string

Definir globalmente

gtag('set', 'cookie_prefix', 'prefix');

Definir para um único fluxo

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

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

Definir globalmente

gtag('set', 'cookie_update', true);

Definir para um único fluxo

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

language

Especifica a preferência de idioma do usuário. O padrão é o valor navigator.language do usuário.

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
page_location string O valor padrão será document.location.

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
page_referrer string O valor padrão será document.referrer.

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

O título da página ou do documento. O padrão é o valor document.title do usuário.

Nome do campo Tipo Valor padrão
page_title string O valor padrão será document.title.

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 "false" para impedir que o snippet padrão envie um page_view.

Nome do campo Tipo Valor padrão
send_page_view boolean true

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.

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 (PIIs). 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
user_id string

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
user_properties object

Exemplo

Definir globalmente

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

Definir para um único fluxo

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});