Consentl com o Google Tag Manager
Modelo para o Google Tag Manager, importado manualmente, que define as predefinições do Consent Mode v2 por região e, no Pro e superiores, transmite cada escolha.
- Loader em primeiro lugar no <head>
- Depende do método
- Transferir
- consentl-gtm-template-1.2.1.tpl · Versão 1.2.1 · 41 KB · SHA-256
O modelo Consentl para o Google Tag Manager (GTM) assume o Google Consent Mode v2 do seu site:
- Define as predefinições do Google Consent Mode v2 por região, antes de qualquer outra tag ser executada.
- Carrega o banner do Consentl (opcional) e transmite as escolhas do visitante ao Consent Mode: a escolha de um visitante que regressa logo que o banner tenha sido executado e, depois, cada alteração.
O Consent Mode exige o plano Pro ou superior. O modelo lê, a partir do banner, o seu plano e o interruptor Google Consent Mode v2 do painel: só transmite as escolhas do visitante quando o seu plano inclui o Consent Mode e o interruptor está ativado. No plano Free, continua a definir as suas predefinições, mas nunca envia uma atualização (consulte Planos).
Que configuração escolher
| Configuração | Retém rastreadores que não são da Google (plano Business) | Consent Mode (plano Pro) |
|---|---|---|
Fragmento de código em primeiro lugar no <head>, sem modelo (recomendado, consulte Qualquer site) |
Sim, desde o início da página | Definido pelo banner |
Fragmento de código no <head> com &gcm=ext e este modelo com «Load the banner» desmarcado |
Sim | Definido pelo modelo; útil quando o GTM é a sua única fonte de configuração de tags |
| Apenas este modelo (sites onde só pode acrescentar o GTM) | Apenas as tags acrescentadas depois de o banner ter carregado | Definido pelo modelo |
Quando o modelo carrega o banner, o GTM injeta-o de forma assíncrona, pelo que os rastreadores inseridos diretamente no HTML da página são executados, e pedidos, antes dele. As tags geridas dentro do GTM não têm problema: aguardam o Consent Mode.
Uma única fonte de Consent Mode (gcm=ext)
Quando o modelo carrega o banner, acrescenta gcm=ext ao URL do banner: o banner deixa então de
enviar comandos próprios do Consent Mode e nunca retém tags Google. Se o fragmento de código também
estiver na sua página, acrescente pessoalmente &gcm=ext ao respetivo URL:
<script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=LANG&gcm=ext"></script>
Sem isso, a página recebe dois conjuntos de predefinições, e as definições do Consent Mode do banner no painel também se aplicam.
Instalação
- Acrescente o modelo ao seu contentor:
- Community Template Gallery (quando for publicado): Templates → Tag Templates → Search Gallery → «Consentl» → Add to workspace.
- Importação manual (disponível já): transfira o ficheiro do modelo a partir de
Transferências e, depois, Templates → Tag Templates → New → ⋮ → Import
→ escolha o ficheiro
.tpl→ Save.
- Crie a tag: Tags → New → Tag configuration → Consentl Cookie Consent (Consent Mode v2).
- Site key: a partir da página Configuração do seu site no painel do Consentl.
- Banner language: opcional, por exemplo
{{Page Language}}. - Load the Consentl banner from this tag: desmarque-a se o fragmento de código já estiver no
<head>(com&gcm=ext). - Consent Mode defaults: uma linha por grupo de regiões, espelhando as suas regras por região
no painel, incluindo a regra para todas as outras regiões. Utilize códigos ISO 3166 (os
estados dos EUA escrevem-se
US-CA). Os atalhosEU(os 27 Estados-Membros),EEA(a UE mais a Islândia, o Liechtenstein e a Noruega) eUK(o mesmo queGB) também funcionam. Exemplo:EEA, GB, CHtudo recusado, mais uma linha com a região vazia para o resto do mundo. Sem linhas, tudo é recusado em todo o lado, o que é a opção mais segura.
- Acionamento: Consent Initialization – All Pages. É o único acionador executado antes de todas as outras tags.
- Em Admin → Container settings, ative Consent overview e certifique-se de que cada tag tem as
verificações de consentimento incorporadas corretas ou as definições Additional consent (por
exemplo,
ad_storagepara a Meta, o TikTok e outros píxeis de publicidade). - Preview (Tag Assistant) → separador Consent: deve ver as predefinições em Consent Initialization (uma vez) e uma atualização depois de aceitar.
- Submit / Publish.
Eventos em que pode acionar tags
| Evento | Quando |
|---|---|
consentl_consent |
Em cada visualização de página depois de a região do visitante ser conhecida, e após cada escolha |
consentl_update |
Apenas quando o visitante faz ou altera uma escolha |
Ambos contêm consentl.preferences, consentl.analytics, consentl.marketing, consentl.sale,
consentl.stored (o visitante já decidiu) e consentl.region. Para acionar uma tag depois de o
visitante dar o seu acordo, utilize consentl_update, ou consentl_consent com uma condição em
consentl.stored.
Planos
O banner indica ao modelo se o seu plano inclui o Consent Mode (Pro e superiores) e se o
interruptor Regiões e leis → Google Consent Mode v2 → enviar sinais de consentimento às tags Google
está ativado. Com gcm=ext, o interruptor não altera mais nada, pelo que deve mantê-lo ativado
quando utiliza este modelo.
| Situação | O que o modelo faz | O que recebem as tags Google do seu contentor |
|---|---|---|
| Pro e superiores, interruptor ativado | Predefinições e, depois, as escolhas do visitante | A escolha do visitante |
| Free (fragmento de código em primeiro lugar, ou banner carregado pelo modelo) | As suas predefinições (sem linhas: tudo recusado), nunca uma atualização; a consola do Tag Assistant mostra uma indicação | As suas predefinições em definitivo, também depois de o visitante aceitar: onde as suas linhas recusam, as tags com verificações de consentimento não são acionadas, e as tags Google em modo avançado só enviam pings sem cookies |
| Pro e superiores, interruptor desativado, fragmento de código em primeiro lugar | Nada; a consola do Tag Assistant mostra uma indicação | Nenhum estado de consentimento, a menos que defina pessoalmente as predefinições do Consent Mode: as tags Google são então executadas como se o consentimento tivesse sido concedido, também na UE, no Reino Unido e na Suíça |
| Pro e superiores, interruptor desativado, banner carregado pelo modelo | Predefinições de imediato (o interruptor ainda não é conhecido) e, depois, nada | As suas predefinições em definitivo |
No plano Free, as predefinições são intencionais: as tags Google nunca são executadas numa região
com opt-in sem um estado de consentimento. Para executar tags depois de o visitante dar o seu acordo
no plano Free, acione-as no evento consentl_update ou consentl_consent com uma condição em
consentl.analytics ou consentl.marketing, ou mude para o plano Pro.
Com o interruptor desativado e o fragmento de código em primeiro lugar, o modelo respeita a sua
escolha e não envia qualquer comando do Consent Mode. As tags Google do seu contentor são então
executadas sem qualquer estado de consentimento, a menos que defina pessoalmente as
predefinições (o seu próprio gtag('consent', 'default', …) antes do GTM, ou outra ferramenta), e a
Google trata um estado em falta como concedido. Se depender deste modelo para o Consent Mode, mantenha
o interruptor ativado.
Enquanto a informação do plano estiver a ser disponibilizada a todos os banners, um site Pro com o interruptor desativado pode ainda ser tratado como Free (predefinições, sem atualizações).
Visitantes que regressam e «Repor todos os consentimentos»
O modelo não lê ele próprio o cookie consentl. Obtém a escolha do visitante a partir do banner,
que já verificou a revisão do consentimento («Repor todos os consentimentos» volta a perguntar a
todos), a expiração, as escolhas implícitas de regiões com informação ou opt-out (não contam em
regiões com opt-in) e o Global Privacy Control. Nada é concedido antes de a escolha atual do
visitante ser conhecida. «Wait for update» (500 ms por predefinição) faz as tags Google aguardarem
pelo banner.
Evitar predefinições duplicadas
- Com o fragmento de código na página, acrescente
&gcm=extao respetivo URL. - Não acrescente também
gtag('consent', 'default', …)à página. - O banner aplica a sua regra para o país do visitante, que o Consentl determina a partir do
endereço IP (em memória, nada é guardado); a Google aplica as linhas do modelo segundo a sua
própria geolocalização. Faça as linhas corresponder às suas regras: recusado onde uma regra é
opt-in, e a linha de região vazia igual à sua regra para todas as outras regiões. O banner não
distingue os estados dos EUA: todos os visitantes dos EUA recebem a sua regra para todos os EUA
ou, se não existir, a sua primeira regra para um estado dos EUA, pelo que deve atribuir aos EUA uma
única linha (
US) com as predefinições dessa regra.
Correspondência entre categorias e Consent Mode
| Consentl | Consent Mode |
|---|---|
| marketing | ad_storage, ad_user_data |
| marketing + sale | ad_personalization |
| analytics | analytics_storage |
| preferences | functionality_storage, personalization_storage |
| sempre | security_storage = granted |
Permissões apresentadas no GTM
| Permissão | Porquê |
|---|---|
| Accesses consent state | Escreve os tipos de consentimento e wait_for_update |
| Injects scripts | https://api.consentl.com/v1/* (o loader do banner) |
| Accesses global variables | Chama Consentl.on, Consentl.get, Consentl.region, Consentl.stored; lê Consentl.version, consentl.c.gcm.plan (o seu plano) e consentl.c.gcm.on (o interruptor do Consent Mode) |
| Writes to the data layer | ads_data_redaction, url_passthrough |
| Logs to console | Apenas no modo de depuração |
Dados recolhidos pelo banner
O modelo, por si só, não envia dados. O Consentl trata o seguinte por sua conta, enquanto proprietário do site:
- Em cada visualização de página, pedidos a
api.consentl.compara o script do banner, a sua interface (quando apresentada) e a consulta da região. Como qualquer pedido web, contêm o endereço IP e o agente de utilizador do navegador do visitante. - A cada escolha, um registo de consentimento como prova do consentimento: um ID de consentimento
aleatório (também guardado no cookie
consentl), a ação e as escolhas, o código da região quando conhecido, o idioma, a revisão do consentimento, o caminho da página, o nome do seu anfitrião, o sinal Global Privacy Control e, durante um teste A/B, a variante do banner. O Consentl acrescenta a hora, o endereço IP encurtado (IPv4 /24, IPv6 /48) e o agente de utilizador. - Quando o banner é apresentado pela primeira vez, uma contagem anónima de visualizações.
- Os registos de consentimento são conservados durante 425 dias (Free, Pro), 730 dias (Business) ou 1825 dias (Enterprise). Consulte a política de privacidade.
Limitações
- Quando o banner é carregado pelo GTM, os scripts inseridos diretamente na página são executados
antes dele. Para um bloqueio prévio estrito, coloque o fragmento de código em primeiro lugar no
<head>. - A ficha na Community Template Gallery ainda não está publicada; utilize a importação manual.
- O Consentl não é uma CMP certificada pela Google para o IAB TCF e não implementa o TCF.
Guias relacionados
Com dificuldades? Escreva para support@consentl.com — respondemos em inglês nos dias úteis.