Guia de instalação do HubSpot

Adicione o Velo ao HubSpot

Instale o banner de cookies do Velo e o Google Consent Mode v2 no HubSpot com uma linha no Site header HTML. Com acesso de administrador ao site, a maioria das instalações leva poucos minutos. Se você usa Google Tag Manager, esta página também explica 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 HubSpot

Antes de começar

  • Onde. Settings → Content → Pages
  • Plano. Acesso às configurações de header
  • Entra no ar. Ao salvar
  • 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.
CMConsent Mode v2GPCGlobal Privacy ControlUEGDPREUALeis estaduais dos EUA

Duas formas de instalar o Velo no HubSpot

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 no Site header HTML

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 dois minutosTempo típico de instalação no HubSpot
Ao salvarQuando o banner entra no ar
1,500Sessões mensais no plano Free, para um site
Primeiro, desligue o banner nativo do HubSpot em Privacy & Consent. Lembre que a análise do HubSpot não é uma tag do Google, então o Consent Mode sozinho não a controla. Se a conformidade exigir isso, carregue pelo Tag Manager e controle pelo evento velo_consent_update.
!
Um ponto de atençãoInstalação no HubSpot
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 no Site header HTML

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>

Abra Settings → Content → Pages

Escolha o domínio a atualizar e depois a aba Templates. Cole o seu trecho de código completo do Velo em Site header HTML e salve. Para substituir as configurações herdadas em um domínio específico, ative Override default settings. Confira as substituições no nível da página antes de presumir que todas as páginas herdam o header.

HubSpot: Site header HTML
O campo Site header HTML do HubSpot, válido para todo o domínio. A documentação do HubSpot usa o Google Analytics como exemplo; cole o seu trecho de código do Velo neste campo. Imagem da documentação oficial, revisada em 23 de setembro de 2026. Documentação do HubSpot ↗

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 · HubSpot
Instale o Velo no HubSpot.

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

Antes de editar, pegue no painel do Velo o ID do meu site e o trecho de código 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 único 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 conforme o 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 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: Escolha o domínio a atualizar e depois a aba Templates. Cole o seu trecho de código completo do Velo em Site header HTML e salve. Para substituir as configurações herdadas em um domínio específico, ative Override default settings. Confira as substituições no nível da página antes de presumir que todas as páginas herdam o header.

Preserve o código que não tem relação com esta instalação. Evite instalações duplicadas do Velo ou padrões de consentimento concorrentes. Não presuma que colocar o código no head ou carregá-lo de forma assíncrona, por si só, garante a ordem das tags.

Confira o site publicado em uma sessão nova. Verifique o banner conforme as regras de região configuradas, os padrões iniciais de consentimento, as atualizações ao 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 checkout separado. 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 você não conseguiu 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

O HubSpot precisa de consentimento de cookies?

7 de novembro de 2026Ler o post

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

2 de novembro de 2026Ler o post

Perguntas frequentes sobre o Velo no HubSpot

O HubSpot já mostra um banner de cookies.

Desligue o banner do HubSpot em Privacy & Consent para o Velo ser a única camada que os seus visitantes veem. Dois banners confundem as pessoas, e duas ferramentas de consentimento mandam sinais conflitantes para o Google.

Ele cobre landing pages e o blog?

O header de todo o domínio vale para o conteúdo que herda essas configurações. Veja se há substituições no nível da página e depois teste páginas do site, landing pages e páginas do blog no domínio escolhido.

E o código de rastreamento do próprio HubSpot?

A análise do HubSpot não é uma tag do Google, então o Consent Mode sozinho não a controla. Se a conformidade exigir, carregue pelo Tag Manager e controle com o evento velo_consent_update. O guia do GTM mostra o gatilho exato.

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.