Cookies e identificação do usuário com gtag.js

A biblioteca gtag.js usa cookies para identificar usuários únicos nas sessões de navegação. Esta página explica como personalizar as configurações de cookies.

A tabela a seguir mostra os valores padrão de campos de cookies usados pelo gtag.js:

Nome do campo Tipo de valor Valor padrão
cookie_name string _ga
cookie_domain string auto
cookie_expires integer 63072000 (dois anos, em segundos)

Para alterar esses valores, atualize o comando config da sua propriedade para especificá-los na lista de parâmetros. Por exemplo:

gtag('config', 'GA_TRACKING_ID', {
  'cookie_name': 'gaCookie',
  'cookie_domain': 'blog.example.co.uk',
  'cookie_expires': 2419200  // 28 days, in seconds
});

Por padrão, a gtag.js vem com a configuração automática de domínio de cookie ativada. Essa opção configura o _ga cookie para o domínio de nível mais alto possível. Por exemplo, se o endereço do seu site for blog.example.co.uk, a gtag.js configurará o domínio do cookie como example.co.uk. Se a gtag.js detectar que você está executando um servidor localmente (por exemplo, localhost), ela definirá automaticamente o cookie_domain como 'none'.

Para desativar a configuração automática do domínio do cookie, atualize o comando config da sua propriedade para especificar um valor para o parâmetro cookie_domain:

gtag('config', 'GA_TRACKING_ID', {
  'cookie_domain': 'blog.example.co.uk'
});

Sempre que um hit é enviado ao Google Analytics, o tempo de validade do cookie é atualizado para ficar definido como o momento atual acrescido do valor do campo cookie_expires. Ou seja, se você usar a validade padrão do cookie (cookie_expires) de dois anos e um usuário visitar seu site todos os meses, o cookie daquele usuário nunca expirará.

Se você definir a validade cookie_expires como 0 (zero) segundos, o cookie será usado por sessão, ou seja, expirará ao final da sessão atual do navegador.

Definir o User ID

O User ID é uma string de código exclusiva, persistente e sem identificação pessoal que representa um usuário. Com ele, você faz a análise de grupos de sessões em dispositivos diferentes. Para saber por que você deve implementar o User ID, consulte o artigo Vantagens de usar o recurso User ID.

Atualize o comando config da sua propriedade para definir o User ID com gtag.js.

gtag('config', 'GA_TRACKING_ID', {
  'user_id': 'USER_ID'
});