Como disparo tags do GTM no evento de atualização do consentimento?

Todos os artigos

cookie_consent_update é um evento da camada de dados que uma plataforma de consentimento envia quando a escolha do visitante entra em vigor, para que o Tag Manager possa executar as tags que tinha retido. Para disparar tags nele, crie um gatilho Custom Event com esse nome de evento, adicione a condição de que a categoria de que a tag precisa esteja concedida, lida de uma variável da camada de dados ou do cookie da plataforma, e use-o no lugar do All Pages.

O gatilho em si é rápido de montar. Os problemas costumam vir depois, como uma visualização de página contada duas vezes ou uma tag que dispara quando o visitante disse não. Aqui está para que serve o evento, como ligá-lo e como manter os números confiáveis.

O que é o evento cookie_consent_update?

É um evento personalizado, do mesmo tipo que o seu próprio site envia com dataLayer.push({event: '…'}). O Google não o define. A plataforma de consentimento escolhe o nome, e várias plataformas usam cookie_consent_update nos seus guias do Tag Manager; pelo menos uma diz que envia esse nome para que contêineres configurados para outra plataforma continuem funcionando. O Velo envia velo_consent_update, com a decisão ao lado num objeto velo_categories que contém analytics, ads, functional e personalization, cada um true ou false.

Não é a mesma coisa que o comando de atualização de consentimento do Google. Esse comando muda o estado de consentimento que as tags do Google e as verificações de consentimento do Tag Manager leem. O evento personalizado é o sinal para os seus gatilhos: é algo que um gatilho do tipo Custom Event consegue detectar. Uma boa plataforma de consentimento envia os dois, nessa ordem, para que o estado já esteja atualizado quando a sua tag for avaliada.

Por que as tags precisam de um segundo gatilho depois do consentimento?

Porque o Tag Manager verifica o consentimento uma única vez, no momento em que o gatilho da tag dispara. A ajuda do Google sobre as configurações de consentimento diz que uma tag com requisitos de consentimento adicionais só dispara se todos os tipos de consentimento listados estiverem concedidos quando a tag é acionada. Numa primeira visita, o gatilho All Pages dispara antes de o visitante escolher qualquer coisa, então uma tag que exige analytics_storage fica retida. Quando o visitante aceita alguns segundos depois, nada no contêiner volta para buscá-la. A tag precisa de um gatilho que dispare depois da escolha, e esse é o evento de atualização do consentimento.

Isso vale para tags que não tratam o consentimento por conta própria: uma tag da Meta ou do Hotjar com a opção Require additional consent, ou as tags do Google no modo básico de consentimento, que não devem carregar até o visitante aceitar. As tags do próprio Google no modo avançado leem o estado do consentimento sozinhas, então ficam nos gatilhos de sempre. Nosso artigo sobre bloquear ou não as tags do Google até o consentimento explica essa divisão.

Como disparo uma tag do GTM no evento de atualização do consentimento?

1. Descubra o nome do evento que sua plataforma envia

   Abra o Preview do Tag Manager no seu site, aceite no banner e veja a lista de eventos à esquerda. Copie o nome exatamente como aparece. Com o Velo, é velo_consent_update.

2. Crie uma variável para a categoria

   Adicione uma variável da camada de dados que leia a categoria da qual a tag depende. Com o Velo, é velo_categories.analytics para tags de análise e velo_categories.ads para tags de publicidade. Outras plataformas guardam o estado em outro lugar, às vezes num cookie próprio, então confira onde a sua o coloca.

3. Crie o gatilho com uma condição

   Crie um gatilho Custom Event com o nome do evento e configure-o para disparar em alguns eventos personalizados, quando a variável for igual a true. Sem a condição, o gatilho também dispara quando o visitante recusa, e uma tag sem configurações de consentimento próprias dispara mesmo assim.

4. Coloque-o no lugar do All Pages

   Na tag, remova o gatilho All Pages e adicione o novo. Se você mantiver os dois, a tag dispara duas vezes para visitantes recorrentes, porque o evento de atualização também dispara nas visualizações de página deles.

5. Configure as tags de visualização de página uma vez por página

   Em Advanced Settings, depois Tag firing options, escolha Once per page. Um visitante que abre o banner de novo e salva uma nova escolha envia o evento uma segunda vez na mesma página.

6. Deixe as tags de conversão nos próprios gatilhos

   Uma tag de compra ou de lead deve disparar na compra ou no formulário, nunca no evento de consentimento. No evento de consentimento, ela contaria uma conversão cada vez que um visitante faz uma escolha.

7. Teste no Preview e depois no site publicado

   Faça as quatro verificações abaixo numa sessão nova do navegador a cada vez e depois publique o contêiner.

Por que minha tag dispara duas vezes depois do consentimento?

Três configurações fazem uma tag contar duas vezes:

• Dois gatilhos numa tag. Um visitante recorrente já tem uma escolha salva, então a tag pode passar na verificação de consentimento no All Pages e disparar de novo no evento de atualização um instante depois. Uma visualização de página vira duas.
• Uma escolha alterada na mesma página. Cada escolha salva envia o evento de novo. Once per page evita a segunda visualização de página.
• Uma tag de conversão no gatilho de consentimento. Cada aceite parece um lead. Devolva a tag de conversão ao evento que define a conversão.

Se os números saltaram na semana em que você instalou uma plataforma de consentimento, confira estes pontos antes de culpar a plataforma ou os visitantes.

Quando o Velo envia velo_consent_update?

Toda vez que uma decisão de consentimento entra em vigor numa página, não só quando alguém clica:

• quando um visitante aceita, recusa ou salva as escolhas no banner;
• em cada visualização de página de um visitante recorrente, quando a escolha salva é aplicada de novo;
• quando um visitante de uma região com regras de opt-out envia um sinal Global Privacy Control, que o Velo registra como recusa;
• quando um visitante novo chega de uma região com regras de opt-out e o Velo aplica o padrão de tudo permitido, que o banner ainda permite recusar.

É por isso que o gatilho pode substituir o All Pages: depois que um visitante permite uma categoria, as tags dessa categoria disparam em cada página que ele vê. Nossa página de ajuda sobre o modo básico e o modo avançado de consentimento traz a mesma configuração como uma lista curta, e instalar um banner de cookies com o Google Tag Manager cobre a parte do Consent Initialization, que vem antes.

Como confiro se o gatilho funciona?

• Primeira visita, antes de escolher: a tag aparece como não disparada, e o painel Network não mostra nenhuma requisição dela.
• Depois de aceitar: a tag dispara uma vez, no evento de atualização.
• Depois de recarregar: a tag dispara uma vez por página, ainda no evento de atualização, nunca uma segunda vez no Container Loaded.
• Depois de recusar: numa sessão nova, navegue por duas páginas. A tag nunca dispara.

O Preview mostra o que o Tag Manager decidiu. O painel Network mostra o que de fato saiu do navegador, então confira os dois. Nossa rotina para testar um banner de cookies antes de publicar tem a lista completa de verificações no navegador.

O Velo envia velo_consent_update em cada um desses casos, então um único gatilho por categoria cobre primeiras visitas, visitantes recorrentes e quem muda de ideia.