Guia de instalação do Drupal

Adicione o Velo ao Drupal

Instale o banner de cookies do Velo e o Google Consent Mode v2 no Drupal com uma linha no template do seu tema. Com acesso de administrador ao site, a maioria das instalações leva poucos minutos. Se você usa o Google Tag Manager, esta página também cobre esse caminho.

Instruções e fontes das imagens revisadas em 23 de setembro de 2026.

Funciona com as plataformas em que você cria

WordPressShopifyWebflowWixHubSpotPrestaShopDrupalBigCommerceShopwareNext.jsAstroSquare

O que você precisa no Drupal

Antes de começar

  • Onde. Tema personalizado → html.html.twig
  • Plano. Acesso ao código do tema
  • Entra no ar. Depois de limpar o cache
  • Tempo típico. Cerca de cinco minutos

Depois que estiver no ar

  • Seu banner segue os padrões que você define para a região de cada visitante.
  • As tags esperam até o visitante escolher.
  • Cada escolha fica registrada, e o Consent Mode v2 a repassa às suas tags do Google.
CMConsent Mode v2GPCGlobal Privacy ControlUEGDPREUALeis estaduais dos EUA

Duas formas de instalar o Velo no Drupal

Escolha o caminho que combina com a forma como o seu site já carrega as tags. Os dois terminam com o mesmo banner e os mesmos sinais.


Cole uma linha antes do head fechar

Adicione o trecho de código do seu site ao head global do site, depois publique e teste no site no ar. Se as suas tags de medição já rodam pelo Google Tag Manager, use o caminho mais abaixo.

Usa o Tag Manager? Esqueça o código

Se o Google Tag Manager já está no seu site, esta é a forma mais fácil de adicionar o Velo. Você não mexe em código, são quatro passos curtos e todas as suas tags ficam em um só lugar.

Cerca de cinco minutosTempo típico de instalação no Drupal
Depois de limpar o cacheQuando o banner entra no ar
1,500Sessões mensais no plano Free, para um site
O Drupal faz cache intenso de páginas renderizadas, então limpe os caches uma vez depois da edição. Como o trecho de código é o mesmo para todo visitante, o cache de página e o cache de CDN continuam funcionando. O Velo identifica a região do visitante e trata a escolha dele no navegador e na borda, não no Drupal.
!
Um ponto de atençãoInstalação no Drupal
Veja todas as plataformas compatíveis

Tudo o que uma configuração de consentimento precisa

O mesmo banner, os mesmos registros e as mesmas análises em todos os planos. O Pro adiciona sites ilimitados, análises ilimitadas e o seu próprio logotipo.


Seu banner pergunta no idioma do visitante e segue os padrões que você define para a região dele.

Cada escolha fica registrada, e o Consent Mode v2 a repassa às suas tags do Google.


Google Consent Mode v2Modo avançado em todos os planos, com um template para o Google Tag Manager.
Regras pelo país do visitanteOpt-in onde a lei pede, e regras mais rígidas para até 60 países.
Leis de privacidade dos EUAUm banner opt-out com a opção “Não vender nem compartilhar”.
Global Privacy ControlOs sinais GPC são respeitados em todos os planos.
Recusar, tão fácil quanto aceitarRecusar fica ao lado de aceitar na primeira camada.
O idioma do visitanteConforme o navegador, com seus próprios textos do banner em cada idioma.
Layouts e temasCanto, barra ou caixa centralizada, nas suas cores, claro ou escuro.
Teste A/B do seu bannerRode de 2 a 8 versões do banner lado a lado.
Registro de consentimentosCada decisão fica guardada por 3 anos, com consulta de comprovante por ID.
Painel de consentimentoTaxas de aceite e de recusa em períodos de 7 a 90 dias.
Varreduras de cookies e rastreadoresCategorias a partir de assinaturas conhecidas, mais sugestões de IA que você aprova.
Bloqueio de scriptsOs scripts esperam pela categoria de consentimento deles antes de rodar.

Cole uma linha antes do head fechar

Adicione o trecho de código do seu site ao head global do site, depois publique e teste no site no ar. Se as suas tags de medição já rodam pelo Google Tag Manager, use o caminho mais abaixo.

Copie a linha

Copie o trecho de código de instalação completo deste site no seu painel do Velo. O exemplo abaixo mostra o formato; substitua your-site-id antes de usá-lo. Mantenha o endpoint da API fornecido pelo seu painel.

Trecho de código de exemplo
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app-staging.veloconsent.com" data-velo-site="your-site-id" async></script>

Adicione o trecho de código no seu tema personalizado

No html.html.twig do seu tema personalizado, cole o trecho completo do Velo dentro do head, antes dos scripts de medição. Preserve os placeholders e a marcação que o Drupal já tem no head. Faça o deploy da mudança no tema e reconstrua os caches do Drupal. Um bloco no body não substitui a colocação no head.

Drupal · template do tema
{# In your custom theme’s html.html.twig #}
<head>
  {# Paste the complete Velo snippet from your dashboard here. #}
  {# Keep the existing head placeholders and theme markup. #}
</head>
Referência de configuração conferida com a documentação da plataforma. Não é uma captura de tela do painel administrativo. Referência de configuração verificada · 23 de setembro de 2026. Documentação da plataforma ↗

Publique e confira o site no ar

Salve e publique a mudança seguindo os passos da plataforma acima e depois limpe qualquer cache do site ou da CDN. Abra a URL publicada em uma sessão nova do navegador. Confira o banner onde as suas regras de região o exigem, teste aceitar e recusar e verifique os padrões e as atualizações de consentimento antes de as suas tags de medição rodarem. Confirme que o site aparece como instalado no seu painel do Velo.

O banner do Velo com a aparência padrão. O texto, as cores e as configurações por região do seu banner podem ser diferentes.

Usa o Tag Manager? Esqueça o código

Se o Google Tag Manager já está no seu site, esta é a forma mais fácil de adicionar o Velo. Você não mexe em código, são quatro passos curtos e todas as suas tags ficam em um só lugar.

O guia completo do Tag Manager

Adicione o Velo ao Tag Manager

Abra o template do Velo, clique em Add to workspace e escolha o seu contêiner. Abrir o template do Velo ↗

Cole o ID do seu site

No Tag Manager, abra Tags e clique em New. Clique em Tag Configuration, escolha Velo CMP e cole o ID do seu site. Você encontra esse ID no seu painel do Velo. Deixe todo o resto como está.

Faça carregar primeiro

Clique em Triggering, escolha Consent Initialization – All Pages e clique em Save. Assim o Velo começa antes das suas outras tags.

Publique e confira

Clique em Submit e depois em Publish. Só o Preview não coloca o Velo no ar. Depois abra o seu site em uma janela anônima, teste o banner e confira se o site aparece como instalado no seu painel do Velo.

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.

Instalar com IA

O prompt

Cole este prompt no seu assistente e depois informe o ID do seu site e o trecho de instalação completo ou as configurações do GTM que estão no seu painel do Velo.

Prompt de instalação · Drupal
Instale o Velo no Drupal.

Guia atual: https://veloconsent.com/drupal

Antes de editar, pegue no painel do Velo o ID do meu site e o trecho de instalação completo ou as configurações do GTM. Confirme qual ferramenta de consentimento e quais tags de medição já rodam no site.

Escolha um caminho de instalação:
A. Se o site já usa Google Tag Manager, adicione o template Velo CMP (publicado por veloconsent) pela Community Template Gallery. Defina o ID do meu site, o tema e o endpoint da API a partir do painel. Revise as opções avançadas; ads_data_redaction e url_passthrough vêm desligadas por padrão. Use Consent Initialization – All Pages, depois faça o Preview e verifique o consentimento antes de publicar. Passos completos: https://veloconsent.com/google-tag-manager

B. Para instalação direta: no html.html.twig do seu tema personalizado, cole o trecho completo do Velo dentro do head, antes dos scripts de medição. Preserve os placeholders e a marcação que o Drupal já tem no head. Faça o deploy da mudança no tema e reconstrua os caches do Drupal. Um bloco no body não substitui a colocação no head.

Preserve o código não relacionado. Evite instalações duplicadas do Velo ou padrões de consentimento concorrentes. Não presuma que a colocação no head ou o carregamento async, por si sós, garantem a ordem das tags.

Confira o site publicado em uma sessão nova. Verifique o banner sob as regras de região configuradas, os padrões iniciais de consentimento, as atualizações de aceitar/recusar e o evento velo_consent_update. Confira se as tags que não são do Google seguem as categorias atribuídas a elas. Teste uma segunda página e qualquer área de checkout separada. Confirme que os sinais chegam ao painel do Velo.

Informe o que mudou, onde mudou e o resultado de cada verificação. Descreva qualquer acesso que faltou ou verificação que não deu para concluir.
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

Notas sobre banners de cookies, Consent Mode e os dados que se perdem entre os dois.


Sites canadenses precisam do Consent Mode v2?
V
O diário do Velo11 de novembro de 2026
DiárioLer o post

Google Consent Mode v2 no Velo: o que há de novo

2 de novembro de 2026Ler o post

Como configurar o Google Consent Mode v2 no Shopify

2 de setembro de 2026Ler o post

Perguntas frequentes sobre o Velo no Drupal

Quais versões do Drupal isso cobre?

Os passos são escritos para Drupal 10 e 11 e funcionam igual no 9. O Velo é uma tag de script sem dependência de módulo, então atualizações do core e dos módulos não o afetam.

Preciso de um módulo dedicado?

Não. Um tema personalizado pode carregar o trecho de código sem um módulo específico do Velo. Se você usar um módulo de injeção de código, confirme que ele consegue adicionar o script completo ao head. Desative qualquer ferramenta de consentimento sobreposta antes de entrar no ar.

O cache do Drupal vai quebrar isso?

Não. O trecho de código é o mesmo para todo visitante, então o cache de página e o cache de CDN continuam funcionando. O Velo identifica a região e trata a decisão de consentimento no navegador do visitante e na borda, não no Drupal.

Isso deixa o site mais lento?

O trecho de código do painel carrega de forma assíncrona. Como com qualquer script, meça o efeito dele no seu site e confira a ordem das suas tags; o carregamento assíncrono, por si só, não garante que os padrões de consentimento rodem antes das outras tags.

Um assistente de IA 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 os passos desta página, a ordem em que as tags precisam carregar e as verificações que o agente tem que rodar antes de dizer que terminou.

Grátis para um site

Banner, análise e registros de consentimento para um site, grátis. Pro a partir de €7 por mês, mais IVA, para sites ilimitados.