Escolha a sua plataforma e siga o guia. Cada instalação leva cerca de dez minutos: uma tag pelo Google Tag Manager, ou uma única linha de código colocada direto no seu site. Sem refazer nada, sem desenvolvedor.
Funciona em todas as plataformas abaixo, e em qualquer site que já rode um contêiner do GTM. Uma tag, importada do template do Velo CMP, disparada em Consent Initialization, define o padrão do Consent Mode v2 antes de qualquer outra coisa carregar. Sem código na página.
Cada guia cobre os dois caminhos, a instalação pelo Google Tag Manager e a direta, com uma imagem de cada passo e uma rodada de verificação no fim, para você saber que o banner e o Consent Mode estão mesmo no ar.
Copie o prompt no Claude, ChatGPT, Cursor ou em qualquer agente de código e ele instala o Velo para você: o caminho certo, a ordem certa, e então as verificações que provam que deu certo. Esta é a versão universal para Google Tag Manager — cada guia de plataforma acima termina com a sua, ajustada àquela plataforma.
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
