Guia de instalação do WordPress
Adicione o Velo ao WordPress
Instale o banner de cookies da Velo e o Google Consent Mode v2 no WordPress com o plugin Velo Consent. Com acesso de administrador ao site, a maioria das instalações leva poucos minutos. Se preferir não adicionar um plugin, você pode colar uma linha no header do seu site ou usar o Google Tag Manager.
Instruções e fontes das imagens revisadas em 23 de setembro de 2026.
O que você precisa no WordPress
Antes de começar
- Onde. Settings → Velo Consent
- Plano. WordPress com plugins
- Entra no ar. Ao conectar
- Tempo típico. Cerca de dois 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.
Duas formas de instalar o Velo no WordPress
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.
Instale o plugin Velo Consent
O plugin Velo Consent configura seu banner de cookies e o Google Consent Mode v2 em poucos cliques e se conecta à WP Consent API. Prefere não adicionar um plugin? Cole uma linha no seu header ou use o Google Tag Manager.
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.
Já usa Complianz, CookieYes, Cookie Notice ou outro plugin de consentimento? Desative-o antes de colocar a Velo no ar, como lembra a lista de verificação em Configurações → Velo Consent. Dois banners confundem os visitantes, e duas ferramentas gravando padrões do Consent Mode enviam sinais conflitantes ao Google.
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.
Instale o plugin Velo Consent
O plugin Velo Consent configura seu banner de cookies e o Google Consent Mode v2 em poucos cliques e se conecta à WP Consent API. Prefere não adicionar um plugin? Cole uma linha no seu header ou use o Google Tag Manager.
Instale pelo WordPress.org
O Velo Consent está no diretório de plugins do WordPress.org. No painel do WordPress, abra Plugins → Adicionar plugin e pesquise por Velo Consent; depois clique em Instalar agora e em Ativar. Ver no WordPress.org
Ou envie o zip
Se o seu site não consegue instalar plugins pelo diretório, baixe o velo-consent.zip abaixo. No painel do WordPress, abra Plugins → Adicionar plugin e clique em Enviar plugin, no topo da página (em versões anteriores do WordPress o menu se chama Adicionar novo). Escolha velo-consent.zip, clique em Instalar agora e depois em Ativar plugin quando o envio terminar. Baixar velo-consent.zip (v0.1.0)

Conecte à Velo
Abra Configurações → Velo Consent e clique em Connect to Velo. Entre ou crie uma conta gratuita da Velo e seu site será vinculado em um clique, sem precisar copiar IDs de site. Se você já tem um ID de site, abra Enter a site ID manually, cole-o e clique em Save.

Verifique o status e o site no ar
Em Configurações → Velo Consent, a verificação de status deve mostrar o snippet do banner como ativo e nenhum outro plugin de consentimento. O plugin insere o velo.js no topo do head, para que os padrões do Consent Mode v2 rodem antes de qualquer script enfileirado. Se você quer que o WooCommerce, o Site Kit by Google e o WP Statistics sigam a escolha de cada visitante, instale também o plugin gratuito WP Consent API; assim que ele estiver ativo, a Velo envia a escolha para ele. Limpe qualquer cache de página ou CDN e abra seu site em uma janela anônima para testar o banner.


Prefere não adicionar um plugin? Cole uma linha em Header & Footer
Adicione o snippet do seu site ao head global com o WPCode ou no header.php de um tema filho e, em seguida, publique e teste no site no ar.
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.
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app-staging.veloconsent.com" data-velo-site="your-site-id" async></script>
Cole no campo Header do WPCode
No WordPress, abra Code Snippets → Header & Footer no WPCode. Cole o trecho de código completo do Velo em Header e salve. Isso exige uma instalação do WordPress que aceite plugins, e se o seu tema já carrega o Velo, não adicione uma segunda cópia.

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.
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 ManagerAdicione 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 IAO 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.
Instale o Velo no WordPress. Guia atual: https://veloconsent.com/wordpress Antes de editar, pegue o ID do meu site e o trecho de código de instalação completo ou as configurações do GTM no painel do Velo. Confirme qual ferramenta de consentimento e quais tags de medição já rodam no site. Escolha uma forma de instalação: A. Se o site já usa o 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 conforme o painel. Revise as opções avançadas; ads_data_redaction e url_passthrough vêm desativadas por padrão. Use Consent Initialization – All Pages, depois use o Preview e verifique o consentimento antes de publicar. Passo a passo completo: https://veloconsent.com/google-tag-manager B. Para instalação direta: no WordPress, abra Code Snippets → Header & Footer no WPCode. Cole o trecho de código completo do Velo em Header e salve. Use uma instalação do WordPress que aceite plugins; não adicione uma segunda cópia se o seu tema já carrega o Velo. 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 assíncrono, por si sós, garantem a ordem das tags. Verifique o site publicado em uma sessão nova. Confira 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. Verifique se as tags que não são do Google seguem as categorias atribuídas a elas. Teste uma segunda página e qualquer etapa de checkout separada. Confirme que os sinais chegam ao painel do Velo. Relate o que mudou, onde mudou e o resultado de cada verificação. Descreva qualquer acesso que faltou e as verificações que você não conseguiu concluir.
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?
Google Consent Mode v2 no Velo: o que há de novo
Como adicionar um banner de cookies no WordPress sem plugin
Perguntas frequentes sobre o Velo no WordPress
Preciso de um plugin do WordPress?
Não, embora o plugin Velo Consent seja a opção mais rápida. Ele adiciona o banner, configura o Google Consent Mode v2 e se conecta à WP Consent API em poucos cliques. Se preferir não adicionar um plugin, cole uma linha de script no seu header com o WPCode ou um tema filho, ou instale pelo Google Tag Manager.
Eu já uso um plugin de cookies como Complianz ou Cookie Notice.
Desative-o antes de colocar a Velo no ar. A lista de verificação em Configurações → Velo Consent avisa se outro plugin de consentimento estiver ativo. Dois banners confundem os visitantes, e duas ferramentas gravando padrões do Consent Mode enviam sinais conflitantes ao Google. A partir daí, a Velo cuida sozinha do banner, das regras regionais e do registro de consentimento.
Funciona com o WooCommerce?
Sim. O banner e o Consent Mode cobrem todas as páginas que o seu tema renderiza, incluindo loja e carrinho. Quando você usa o plugin Velo Consent, ele também envia a escolha de cada visitante para a WP Consent API, para que o WooCommerce, o Site Kit by Google e o WP Statistics a sigam automaticamente.
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.