Central de ajuda · Instalar o trecho de código

Instale uma vez. Confira se funciona

Escolha o Google Tag Manager ou uma instalação direta no site e depois verifique o carregamento, a ordem do consentimento e as escolhas dos visitantes.

3 min de leituraRevisado em 23 de setembro de 2026

Escolha a forma de instalação

Sua configuraçãoUse este caminho
Tags gerenciadas pelo Google Tag ManagerInstale o template Velo CMP e dispare-o em Consent Initialization – All Pages.
Construtor de sites, tema ou código personalizadoAdicione o trecho de código direto do site ao head global, seguindo o guia da plataforma abaixo.

O template do GTM já carrega o SDK do banner. Não adicione uma segunda cópia pelo tema do seu site, por um plugin ou por uma tag Custom HTML.

Instale o trecho de código direto

  1. No workspace do Velo, abra Websites, escolha Configure no seu site e encontre Install.
  2. Copie o trecho de código completo desse site. Mantenha intactos o ID do site e o endpoint da API.
  3. Cole-o no <head> de todo o site, usando o campo de código personalizado da sua plataforma ou o template do tema.
  4. Publique o site e depois limpe qualquer cache relevante do site ou da CDN.
Apenas exemplo · use o ID do seu site
<script src="https://cdn.veloconsent.com/v1/velo.js"
data-api="https://app-staging.veloconsent.com"
data-velo-site="YOUR-SITE-ID"
async></script>

Siga o guia da sua plataforma

Use as instruções do lugar onde o seu site é publicado. Os guias explicam o campo de código personalizado certo, a etapa de publicação e as limitações de cada plataforma.

Em uma aplicação personalizada, coloque o script no head compartilhado do documento para que ele fique disponível em todas as rotas. Teste a navegação do lado do cliente e também um carregamento completo da página, e evite montar uma nova cópia a cada mudança de rota.

Verifique a instalação publicada

  • Abra o site no ar em uma sessão de navegador nova. Não confie no preview do construtor de sites.
  • Confira no painel Network do navegador a requisição de velo.js e a requisição de configuração do site. Resolva as requisições bloqueadas ou com falha.
  • Confira se o trecho carregado tem o ID do site que você copiou de Configuration.
  • Confirme que aparece um único banner e que o controle de privacidade consegue reabri-lo.
  • Teste aceitar, recusar e as preferências e depois navegue para uma segunda página.
  • Confira o estado de consentimento do Google e, separadamente, as tags que não são do Google.
  1. Descarte uma escolha já feita. Abra uma sessão privada nova ou use o botão de privacidade que já existe. Visitantes que retornam podem já ter uma decisão salva.
  2. Confirme a publicação. Salve e publique o site ou o contêiner do GTM. Um rascunho ou um preview não atualiza o site público.
  3. Veja se o carregamento está bloqueado. Procure um erro de política de segurança de conteúdo, uma requisição à CDN com falha, uma extensão de navegador ou um otimizador de scripts que atrase o Velo.
  4. Confira a configuração. Compare o ID do site e o endpoint da API com Configuration. Confirme que a exibição automática do banner não foi desativada na sua instalação personalizada.
  5. Procure outra instalação. Pesquise no seu tema, nos plugins e no GTM uma CMP mais antiga ou outra cópia do Velo.

Se o banner aparecer duas vezes, remova a instalação extra na origem, publique de novo e teste outra vez em uma sessão nova.

Ainda travado?

Conte até onde você chegou e a gente continua daí.