Cookies e identificação do usuário

A gtag.js usa cookies para identificar usuários únicos nas sessões de navegação. Nesta página, veremos 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 Valores padrão
cookie_domain string Automático
cookie_expires número inteiro 63072000 (dois anos, em segundos)
cookie_prefix string nenhum
cookie_update booleano true
cookie_flags string

Se você quiser alterar esses valores, atualize as configurações da sua propriedade para especificá-los na lista de parâmetros. Por exemplo:

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

A configuração automática de domínio de cookies da gtag.js fica ativada por padrão. 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, ela 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 a configuração da sua propriedade especificando um valor no parâmetro cookie_domain:

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

Para evitar conflitos com outros cookies, talvez seja necessário alterar o prefixo. Este prefixo será adicionado no início dos cookies definidos pela gtag.js. Por exemplo, o nome padrão do cookie de código usado pelo Google Analytics é _ga. Então, se você definir o valor de parâmetro cookie_prefix como “example”, o nome do cookie será example_ga:

gtag('config', '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 no final da sessão atual do navegador.

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

Quando cookie_update for definido como true (o valor padrão), a gtag.js atualizará os cookies em cada carregamento de página. Dessa forma, a expiração é definida em relação à visita mais recente ao site.

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.

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

Quando definidas, anexam sinalizações adicionais ao cookie. Elas devem ser separadas por ponto e vírgula.

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

Definir o User ID

Um User ID é uma string de código exclusiva, persistente e sem identificação pessoal que o Google Analytics usa para representar um usuário. Com ele, você faz a análise de grupos de sessões em dispositivos diferentes.

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

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

Você pode configurar a gtag.js para não ler ou gravar cookies antes de ter o consentimento do usuário. Para saber mais, consulte Ajustar o comportamento da tag com base no consentimento.