Configurar e personalizar cookies

Esta página é para os desenvolvedores interessados em personalizar as configurações de cookies com a tag do Google ou o Gerenciador de tags. Caso você não tenha certeza se precisa definir cookies, confira o artigo Cookies e identificação do usuário.

Por padrão, as tags do Google usam a configuração automática de domínio de cookies. Os cookies são definidos no nível mais alto possível do domínio. Por exemplo, se o endereço do site for blog.example.com, os cookies vão ser definidos no domínio example.com. Se detectarmos que você está executando um servidor localmente (por exemplo, localhost), cookie_domain será definido automaticamente como 'none', e os cookies vão usar o domínio completo do local do documento.

Se você só quer modificar a validade dos cookies ou as configurações de atualização deles, mude as definições padrão usando a interface do Google Analytics.

Para a maioria dos sites e apps, o armazenamento de cookies também precisa do consentimento do usuário. A Visão geral da privacidade do usuário apresenta as opções disponíveis para administrar esse consentimento.

Observação: se você usa a tag do Google e tem vários produtos em uma página que compartilha cookies, use os comandos gtag('set') em vez de gtag('config') nas configurações de cookies. Isso gera resultados mais consistentes.

Mudar o domínio dos cookies

Importante: o valor cookie_domain precisa ser um ancestral do domínio atual. Caso contrário, o cookie não será definido. Por exemplo, se o seu domínio for one.two.three.root.com, você poderá configurar o cookie para ser usado em root.com, mas não em someotherdomain.com. Se um domínio de cookie incorreto for definido, nenhum dado será enviado.

Quando você usa a configuração automática de domínio de cookies, a atividade é medida em todos os subdomínios, sem a necessidade de ajustes extras.

Para fazer mudanças na configuração do domínio de cookies, siga estas etapas:

gtag.js

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

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

Gerenciador de tags

Para a tag do Google

1. No espaço de trabalho, abra o menu Tags.
2. Edite uma tag do Google atual ou crie uma nova.

3. Em Configuração, adicione um novo parâmetro:

   • Nome: cookie_domain
   • Valor: my.example.com

4. Salve a tag e publique o contêiner.

   Para tags do Google Ads e do Floodlight

   As configurações do domínio podem ser modificadas na tag do Vinculador de conversões:

   1. No Gerenciador de tags, abra a tag atual do Vinculador de conversões ou, se necessário, crie uma.
   2. Em Opções do vinculador, clique em Substituir as configurações de cookies (avançado).
   3. No campo Domínio, insira o domínio de nível mais alto onde um cookie deve ser definido. Também é possível especificar um caminho específico no campo Caminho. Use essas configurações apenas se for preciso limitar cookies a um subdomínio ou subdiretório de nível inferior.

Para tags do Universal Analytics

1. No Gerenciador de tags, abra o menu Tags.
2. Edite uma tag do Universal Analytics ou crie uma.
3. Crie uma variável de configurações do Google Analytics. Selecione Configuração da variável > Mais configurações > Campos a serem definidos.
4. Quando a seção "Campos a serem definidos" abrir, clique em Adicionar linha.
5. Em Nome do campo, insira cookieDomain.
6. Em Valor, insira o valor do domínio, como my.example.com.
7. Salve e publique a tag.

Renomear cookies

Para evitar conflitos com outros cookies, talvez seja necessário mudar o nome.

Importante: se as configurações de nome de cookie mudarem depois que os usuários acessarem seu site pela primeira vez, esses visitantes vão aparecer como novos porque o contexto armazenado nos cookies não modificados serão perdidos.

gtag.js

Essa configuração vai adicionar um example ao início do cookie definido (por exemplo, _ga se torna example_ga, ou _gcl_au se torna example_gcl_au):

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

Gerenciador de tags

Para a tag do Google

1. No espaço de trabalho, abra o menu Tags.
2. Edite uma tag do Google atual ou crie uma nova.

3. Em Configuração, adicione um novo parâmetro:

   • Nome: cookie_prefix
   • Valor: example

4. Salve a tag e publique o contêiner.

Para tags do Universal Analytics

As tags do Universal Analytics no Gerenciador de tags podem substituir o nome do cookie por cookieName usando uma variável de configurações do Google Analytics.

1. No Gerenciador de tags, abra uma variável de configurações do Google Analytics e selecione Configuração da variável > Mais configurações > Campos a serem definidos.
2. Quando a seção "Campos a serem definidos" abrir, clique em Adicionar linha.
3. Em Nome do campo, insira cookieName.
4. Em Valor, insira o nome do cookie, como myCookie.
5. Salve e publique a tag.

Observação: o modelo de tag do Universal Analytics no Gerenciador de tags muda todo o nome do cookie. Esse comportamento é diferente da propriedade cookie_prefix da tag do Google, que adiciona texto ao início do nome do cookie padrão.

Para tags do Google Ads e do Floodlight

As configurações de prefixo de nome podem ser modificadas na tag do Vinculador de conversões:

1.  In Tag Manager, open your existing Conversion Linker tag, or create
    one if the tag doesn't yet exist in your container.

1. Em Opções do vinculador, clique em Substituir as configurações de cookies (avançado).
2. No campo Prefixo do nome, digite o prefixo do nome desejado. Todas as tags que usam esses cookies (por exemplo, tags de conversão do Google Ads) também precisam ser configuradas para usar o mesmo prefixo.

Validade do cookie

O prazo de validade do cookie é atualizado em cada carregamento de página para a hora atual mais o valor de validade do cookie definido pela tag do Google. Isso significa que, se o cookie expirar em uma semana (604800 segundos) e um usuário acessar a página com o mesmo navegador em cinco dias, o cookie vai ficar disponível por mais uma semana, e esse usuário vai aparecer como o mesmo visitante nos seus relatórios. Mas se ele acessar a página após a validade do cookie original, um novo cookie será criado, e a primeira e a segunda visitas vão ser consideradas acessos de usuários diferentes nos relatórios.

Ao definir o prazo de validade do cookie como 0 (zero) segundos, você criará um cookie com base na sessão, que vai expirar quando a sessão atual do navegador terminar.

gtag.js

gtag('config', 'TAG_ID', {
  cookie_expires: 28 * 24 * 60 * 60 // 28 days, in seconds
});

Gerenciador de tags

Para a tag do Google

1. No espaço de trabalho, abra o menu Tags.
2. Edite uma tag do Google atual ou crie uma nova.

3. Em Configuração, adicione um novo parâmetro:

   • Nome: cookie_expires
   • Valor: 2419200
   Observação: o valor de 2419200 é 28 dias, mas você pode definir a duração que quiser.

4. Salve a tag e publique o contêiner.

Para tags do Universal Analytics

1. No espaço de trabalho, abra o menu Tags.
2. Edite uma tag Universal Analytics.
3. Crie uma variável de configurações do Google Analytics. Selecione Configuração da variável > Mais configurações > Campos a serem definidos.
4. Quando a seção "Campos a serem definidos" abrir, clique em Adicionar linha.
5. Em Nome do campo, insira cookieExpires.
6. Em Valor, insira o número de segundos antes que o cookie expire. Por exemplo, para 28 dias, insira 2419200.
7. Salve a tag e publique o contêiner.

Observação: os cookies do Google Ads e do Floodlight definidos pela tag do Vinculador de conversões não são compatíveis com cookie_expires por enquanto. Se cookie_expires for necessário, use a gtag.js nessa configuração de tag.

Atualização de cookies

Quando a sinalização cookie_update é definida como true (o valor padrão), as tags do Google podem atualizar os cookies em cada carregamento de página e atualizar a validade para ser definida em relação à visita mais recente ao site. Por exemplo, se o cookie expirar em uma semana e a pessoa 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.

gtag.js

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

Gerenciador de tags

Para a tag do Google

1. No espaço de trabalho, abra o menu Tags.
2. Edite uma tag do Google atual ou crie uma nova.

3. Em Configuração, adicione um novo parâmetro:

   • Nome: cookie_update
   • Valor: false

4. Salve a tag e publique o contêiner.

   Observação: os cookies do Google Ads e do Floodlight definidos pela tag do Vinculador de conversões não são compatíveis com cookie_updateno momento. Se cookie_update for necessário, use a gtag.js nessa configuração de tag.

Para tags do Universal Analytics

1. No espaço de trabalho, abra o menu Tags.
2. Edite uma tag Universal Analytics.
3. Crie uma variável de configurações do Google Analytics. Selecione Configuração da variável > Mais configurações > Campos a serem definidos.
4. Quando a seção "Campos a serem definidos" abrir, clique em Adicionar linha.
5. Em Nome do campo, insira cookieUpdate.
6. Em Valor, insira um valor booleano, como false.
7. Salve a tag e publique o contêiner.