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_domain string auto
cookie_expires integer 63072000 (dois anos, em segundos)
cookie_prefix string _ga
cookie_update boolean true

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

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

Por padrão, a configuração automática de domínio de cookies da gtag.js fica ativada. Nesse caso, a gtag.js define os cookies no domínio de nível mais alto que puder. Por exemplo, se o endereço do site for blog.example.com, a gtag.js definirá cookies no domínio example.com. Se a biblioteca detectar que um servidor está sendo executado no local (por exemplo, localhost), ela irá configurar o cookie_domain automaticamente como 'none'. Com isso, os cookies serão definidos usando o domínio completo do local do documento.

Para desativar a configuração automática de domínio de cookies, atualize o comando config da sua propriedade especificando um valor no parâmetro cookie_domain:

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

Para evitar conflitos com outros cookies, é recomendável alterar o prefixo que será adicionado antes dos cookies definidos pela gtag.js. Por exemplo, o nome padrão do cookie de ID usado pelo Google Analytics é _ga, O código abaixo fará com que o cookie seja nomeado como example_ga:

gtag('config', 'GA_MEASUREMENT_ID', {
  cookie_prefix: 'example'
});

O tempo de validade do cookie é atualizado em cada carregamento de página para a hora atual mais o valor do campo cookie_expires. Isso significa que, se cookie_expires expirar em uma semana e um usuário acessar a página com o mesmo navegador em cinco dias, o cookie ficará disponível por mais uma semana, e esse usuário aparecerá como o mesmo visitante no Google Analytics. No entanto, se ele acessar a página depois da expiração do cookie original, um novo cookie será criado, e a primeira e a segunda visitas serão consideradas acessos de usuários diferentes.

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

gtag('config', 'GA_MEASUREMENT_ID', {
  cookie_expires: 0
});

Quando cookie_update é definido como true (valor padrão), a gtag.js atualiza os cookies em cada carregamento de página. Dessa forma, a expiração é 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 irá expirar.

Quando definidos como false, os cookies não são atualizados em cada carregamento de página. Dessa forma, a expiração é definida em relação à primeira visita do usuário ao site.

gtag('config', 'GA_MEASUREMENT_ID', {
  cookie_update: false
});

Definir o User ID

Um 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 é importante implementar o User ID, consulte o artigo que explica as vantagens desse recurso.

Se você quiser implementar o User ID com a gtag.js, atualize a config da propriedade da seguinte forma:

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