Configuração

Este documento lista todos os campos de configuração do GA4.

Observação: não use nenhum dos campos listados nesta página como nomes para seus parâmetros personalizados.

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

Observação: se você definir esse valor, o parâmetro de consulta utm_content será substituído.

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

Observação: se você definir esse valor, o parâmetro de consulta utm_id será substituído.

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

Observação: se você definir esse valor, o parâmetro de consulta utm_medium será substituído.

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

Observação: se você definir esse valor, o parâmetro de consulta utm_name será substituído.

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

Observação: se você definir esse valor, o parâmetro de consulta utm_source será substituído.

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

Observação: se você definir esse valor, o parâmetro de consulta utm_term será substituído.

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:

• campaign_id
• campaign_source
• campaign_medium
• campaign_name
• campaign_term
• campaign_content

Importante: use a versão com o prefixo campaign_ de cada valor de campanha em vez deste campo.

Nome do campo	Tipo	Valor padrão
campaign	object	undefined

Exemplo

Observação: os detalhes da campanha que você enviar vão substituir os parâmetros de consulta utm_.

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.

Atenção: se você configurar o cookie para expirar muito rapidamente, isso aumentará a contagem de usuários e diminuirá a qualidade da sua medição.

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