Guia de instalação do Google Tag Manager

Adicione o Velo ao
Google Tag Manager.

Instale o banner de cookies do Velo e o Google Consent Mode v2 com uma tag importada do template do Velo CMP. Sem código na página, sem Custom HTML. Configure a tag, defina o gatilho, publique. Cerca de dez minutos de ponta a ponta.

Começar Todos os guias de instalação

Instale pelo
Google Tag Manager.

Uma tag, sem código na página, e toda a sua stack de medição fica em um lugar só.

Seis passos · cerca de dez minutos

01

Importe o template do Velo CMP

Baixe o template.tpl em github.com/ampliodata/velo-cmp. No seu contêiner, abra Templates → Tag Templates → New, depois abra o menu ⋮ no canto superior direito do editor e escolha Import. Selecione o arquivo que acabou de baixar, salve, e a tag Velo CMP está pronta para configurar. O Velo CMP está aguardando a listagem na Community Template Gallery do Google. Até isso acontecer, importar o arquivo é o caminho, e a tag se comporta de forma idêntica.

Templates→Tag Templates→New→Import

tagmanager.google.com
02

Crie a tag

Vá em Tags → New e escolha o template do Velo. Informe o ID do seu site Velo , letras minúsculas, dígitos e traços, exatamente como o painel mostra, e depois escolha o tema claro ou escuro para combinar com o seu site. Deixe o endpoint da API em branco a não ser que o Velo tenha emitido um para a sua conta: o banner e o Consent Mode funcionam totalmente sem ele, e quando está definido a configuração remota do painel assume o texto e as categorias.

Tags→New→Velo CMP template

tagmanager.google.com
03

Marque as duas opções de recuperação

Em Advanced, vale a pena ligar dois checkboxes. O url_passthrough deixa identificadores de clique em anúncio, de cliente e de sessão sobreviverem à navegação por parâmetros de URL enquanto o consentimento de armazenamento está negado, e recupera a atribuição do tráfego que o seu banner perderia. O ads_data_redaction ainda remove identificadores de clique em anúncio e passa a operar sem cookies nas requisições enquanto o ad_storage está negado, o que é recomendado para configurações rígidas da UE. Os campos de sobrescrita de texto podem ficar vazios; prefira editar o texto no painel do Velo.

Advanced→url_passthrough→ads_data_redaction

tagmanager.google.com
04

Dispare em Consent Initialization – All Pages

Esse é o gatilho que o Google oferece especificamente para os padrões de consentimento: ele roda antes de qualquer outro gatilho do contêiner, que é o que garante que o padrão negado esteja no lugar antes de qualquer tag de medição poder disparar. Não use Initialization nem All Pages. Os dois rodam tarde demais. Essa única escolha é quase tudo o que separa uma instalação de consentimento correta de uma errada.

Triggering→Consent Initialization – All Pages

tagmanager.google.com
05

Ative a visão geral de consentimento em Admin

Em Admin → Container Settings, marque Enable consent overview. Isso liga os recursos de consentimento do contêiner: o ícone de escudo na visão de Tags que mostra o status de consentimento de cada tag, e as leituras de estado de consentimento que você está prestes a conferir no Preview. Faça isso antes de abrir o Preview. Sem isso, o GTM não te dá nenhuma visão geral de consentimento para depurar.

Admin→Container Settings→Enable consent overview

tagmanager.google.com
06

Faça o preview e publique

No Preview, verifique três coisas: a tag do Velo disparou em Consent Initialization antes de qualquer outra tag; a aba Consent no Tag Assistant mostra todos os sinais, exceto security_storage, negados por padrão a partir de uma localização do EEE, do Reino Unido ou da Suíça; e aceitar ou recusar no banner inverte a linha de update correspondente enquanto um evento velo_consent_update chega à camada de dados. Depois Submit → Publish. O banner fica no ar no próximo carregamento de página, e o console do Velo muda para instalado sozinho quando o primeiro sinal real chega.

Preview→Submit→Publish

tagmanager.google.com

Controle qualquer tag
pela decisão.

Além do Consent Mode, você pode segurar qualquer tag até uma categoria ser concedida — três peças pequenas no mesmo contêiner.

velo_categoriesData Layer Variable

velo_consent_updategatilho Custom Event

tag de evento do GA4dispara quando analytics ✓

Uma variávelCrie uma Data Layer Variable chamada velo_categories. É um objeto de booleanos: analytics, ads, functional, personalization , refletindo a decisão atual do visitante.

Um gatilhoCrie um gatilho Custom Event em velo_consent_update com uma condição na categoria que te interessa, por exemplo, velo_categories.analytics igual a true.

AnexePonha esse gatilho na tag que você quer controlar. Como o evento também dispara para visitantes que voltam com uma decisão guardada, a tag dispara em todo pageview em que o consentimento está concedido, sem a lacuna do "só dispara uma vez depois do clique".

Perguntas sobre o Google Tag Manager,
respondidas.

O que os times que instalam pelo Google Tag Manager perguntam primeiro.

O banner não aparece.

Quase sempre uma de duas coisas: a tag não está no gatilho Consent Initialization – All Pages, ou a versão do contêiner nunca foi publicada. Abra o Preview e veja onde a tag dispara. A correção costuma ficar visível em dez segundos.

Os sinais aparecem como concedidos por padrão na UE.

Alguma outra coisa está competindo com o Velo: uma tag antiga de CMP, um trecho de padrão de consentimento dentro de uma tag Custom HTML, ou um default do gtag escrito na página. Só uma coisa na stack pode definir os padrões. Encontre a outra e remova.

Aparecem dois banners ao mesmo tempo.

O trecho de código direto do velo.js também está instalado na marcação da página. Use um caminho de instalação, não os dois. Se os dois estiverem presentes, os atributos do trecho inline vencem a configuração da tag, o que deixa a depuração confusa. Remova um.

Minha tag controlada nunca dispara.

Confira se o nome do evento no gatilho Custom Event é exatamente velo_consent_update, com underscores e sem erros de digitação, e se a correspondência por regex não foi ligada sem querer. Depois confirme que a condição lê a variável velo_categories, e não o nome do evento.

Uma instalação pelo Tag Manager é diferente da instalação pelo trecho de código?

Não. Mesmo banner, mesma ligação do Consent Mode, mesmo registro de auditoria, mesmo painel. O caminho pelo template só mantém toda a stack de medição em um contêiner, que é por isso que é o caminho que recomendamos em todo guia de plataforma.

Um agente pode fazer isso por mim?

Sim. Copie o prompt em Instalar com agentes, logo abaixo, no Claude, ChatGPT, Cursor ou no assistente que você já usa. Ele carrega o template, o gatilho, o padrão de gating para tags que o Consent Mode não cobre, e as verificações que o agente tem que rodar antes de dizer que terminou.

Ou entregue
para um agente.

Copie o prompt no Claude, ChatGPT, Cursor ou no assistente que você já usa. Ele carrega tudo o que está nesta página: os dois caminhos, a ordem em que as tags precisam carregar e as verificações que provam que deu certo.

O prompt

Cole como sua primeira mensagem e troque your-site-id pelo ID que está no seu painel do Velo. Todo o resto de que o agente precisa já está escrito ali, inclusive o que verificar antes de publicar.

Prompt de instalação · Google Tag Manager

# Instale o Velo no Google Tag Manager: banner + Consent Mode v2

Você está instalando o Velo, uma plataforma de gestão de consentimento, no meu
contêiner do Google Tag Manager. O Velo define os padrões do Consent Mode v2
antes de qualquer outra tag disparar, mostra o banner de cookies, e registra
cada decisão. Nada vai para a marcação da página.

Me peça o seguinte antes de mexer no contêiner:

- O id do meu site Velo. Ele está no painel do Velo. Ainda sem conta? Me mande
  para https://veloconsent.com/get-started e espere o id.
- O id do contêiner, e se eu posso publicar ou apenas enviar para revisão.
- Qual ferramenta de consentimento está no ar hoje.

## A instalação

1. Templates → Tag Templates → New, depois ⋮ → Import. Importe o
   template.tpl de github.com/ampliodata/velo-cmp ("Velo CMP").
2. Crie uma tag a partir desse template. Defina o id do meu site Velo e escolha
   o tema claro ou escuro.
3. Dispare no gatilho "Consent Initialization – All Pages". Não
   Initialization, não All Pages. Os dois rodam tarde demais para definir os
   padrões de consentimento.
4. Preview, depois Submit e Publish.

## Controlando tags que não são do Google

GA4, Google Ads e Floodlight não precisam de nada a mais. As verificações de
consentimento embutidas neles seguram e liberam as tags sozinhas. Para um
widget de chat, um heatmap ou um pixel sem suporte a Consent Mode:

1. Crie uma Data Layer Variable chamada velo_categories. É um objeto de
   booleanos: analytics, ads, functional, personalization.
2. Crie um gatilho Custom Event em velo_consent_update, com uma condição
   como velo_categories.analytics igual a true.
3. Ponha esse gatilho na tag. O evento também dispara para visitantes que
   voltam com uma decisão guardada, então a tag não fica limitada ao único
   pageview em que o clique aconteceu.

## Regras

- Instale só um caminho. Se o trecho de código do velo.js também estiver na
  marcação da página, remova. Duas instalações significam dois banners.
- Só uma ferramenta pode definir os padrões do Consent Mode. Se outra tag de
  CMP estiver no contêiner, pause antes de publicar o Velo. Não deixe nenhum
  gtag('consent', 'default', ...) escrito à mão na página nem
  em uma tag Custom HTML.
- Não mude nenhuma outra tag, gatilho ou variável. Me avise antes se alguma
  tiver que sair do lugar.

## Verifique, depois me reporte

- O banner renderiza em um carregamento novo em uma janela anônima.
- Antes de eu escolher, todo sinal de consentimento exceto security_storage
  está negado a partir de uma localização do EEE, do Reino Unido ou da Suíça.
- Aceitar e recusar invertem cada um os sinais correspondentes, e um evento
  velo_consent_update chega à camada de dados.
- As tags do Google ficam no modo sem cookies até o consentimento ser
  concedido, e qualquer tag controlada à mão só dispara depois disso.
- window.Velo está definido, e Velo.open() reabre o painel de preferências.
- Em uma instalação por Tag Manager, o Tag Assistant mostra a tag do Velo
  disparando em Consent Initialization antes de qualquer outra tag.

Me diga o que você mudou, onde mudou, e o que cada verificação mostrou. Se uma
verificação falhar, corrija e rode as verificações de novo.

Guia completo: https://veloconsent.com/pt/google-tag-manager
Mais contexto para agentes: https://veloconsent.com/llms.txt

Trabalhando com um agente que lê a web? Aponte ele para veloconsent.com/llms.txt e /install.md para o mesmo contexto em texto puro.

Do diário.

Como verificar se o seu banner de cookies está enviando o sinal do Consent Mode v2 Duas leituras resolvem: os quatro sinais de consentimento dentro do navegador e o estado que de fato chegou ao Google na requisição. 26 de julho de 2026

Como enviar o sinal de consentimento para um contêiner de servidor O consentimento é decidido no contêiner web e viaja para o servidor na requisição. 27 de julho de 2026

Consent Mode básico vs avançado: qual você está usando Negue o consentimento em uma janela anônima e leia o parâmetro gcs na requisição do Google. 12 de julho de 2026

Todos os artigos