Pular para o conteúdo
Abra seu espaço de trabalho
Ver tópicos 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

Use uma forma por site
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.veloconsent.com"
  data-velo-site="YOUR-SITE-ID"
  async></script>
O posicionamento do script é só uma parte da configuração do consentimento.

Um script assíncrono pode ser executado depois de um código que aparece abaixo dele. Defina os padrões de consentimento antes de os comandos de medição do Google rodarem e configure verificações para as outras tags. Siga as orientações sobre a ordem do consentimento antes de publicar mudanças na medição.

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.