Guia de instalação do Shopify

Adicione o Velo ao Shopify

Instale o banner de cookies da Velo e o Google Consent Mode v2 no Shopify com o app Velo Consent da Shopify App Store. Ele é ativado no editor de temas sem editar código e repassa a escolha de cada visitante à Customer Privacy API do Shopify. Se preferir não adicionar um app, você pode colar uma linha no theme.liquid ou usar o Google Tag Manager.

Instruções e fontes das imagens revisadas em 19 de novembro de 2026.

Funciona com as plataformas em que você cria

WordPressShopifyWebflowWixHubSpotPrestaShopDrupalBigCommerceShopwareNext.jsAstroSquare

O que você precisa no Shopify

Antes de começar

  • Onde. App Velo Consent · ou Edit code → theme.liquid
  • Plano. Qualquer plano com Online Store
  • Entra no ar. Ao salvar o tema
  • 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 Shopify

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 app Velo Consent

O app Velo Consent adiciona seu banner de cookies como app embed do tema, define os padrões do Google Consent Mode v2 e repassa a escolha de cada visitante à Customer Privacy API do Shopify, para que os pixels do Shopify e o checkout a sigam. Prefere não adicionar um app? Cole uma linha no theme.liquid 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.

Cerca de dois minutosTempo típico de instalação no Shopify
Ao salvar o temaQuando o banner entra no ar
1,500Sessões mensais no plano Free, para um site
Já usa outro app de consentimento? Desative antes de o Velo entrar no ar. Dois banners confundem os visitantes, e duas ferramentas escrevendo padrões do Consent Mode mandam sinais conflitantes para o Google.
!
Um ponto de atençãoInstalação no Shopify
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.

Instale o app Velo Consent

O app Velo Consent adiciona seu banner de cookies como app embed do tema, define os padrões do Google Consent Mode v2 e repassa a escolha de cada visitante à Customer Privacy API do Shopify, para que os pixels do Shopify e o checkout a sigam. Prefere não adicionar um app? Cole uma linha no theme.liquid ou use o Google Tag Manager.

Instale pela Shopify App Store

Abra o Velo Consent: Cookie Banner na Shopify App Store, clique em Install e aprove no admin do Shopify. O app configura a Velo para a sua loja, então não há ID de site para copiar. É grátis para até 10.000 sessões por mês, e o Pro custa US$ 5 por mês, cobrado pelo Shopify. Ver na Shopify App Store

O app Velo Consent no admin do Shopify, com cores, layout e prévia ao vivo
O app Velo Consent dentro do admin do Shopify: escolha as cores e o layout, e a prévia à direita se atualiza na hora. Captura real do Shopify · 19 de novembro de 2026. Shopify App Store ↗

Ative o banner

No app, clique em Turn on in theme editor. O editor de temas abre em App embeds com o Velo Consent já ativado. Clique em Save, volte ao app e clique em I’ve turned it on para confirmar que o banner está no ar.

Desative o banner do Shopify e confira a loja

Clique em Open customer privacy settings no app e desative o banner de cookies do Shopify, para que os visitantes não sejam perguntados duas vezes. Depois abra a sua storefront numa janela anônima, teste recusar e aceitar tudo, e confira se as suas tags de medição seguem a escolha.

Uma storefront Shopify com o banner de cookies da Velo no canto inferior
O banner numa loja de teste do Shopify depois de salvar o app embed, com Reject e Accept all lado a lado. Captura real do Shopify · 19 de novembro de 2026. Shopify App Store ↗

Prefere não adicionar um app? Cole uma linha no seu tema

Adicione o snippet do seu site ao head do tema, depois 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.

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 layout/theme.liquid

Abra Online Store → Themes, use o menu de ações do tema e escolha Edit code. Abra layout/theme.liquid e cole o seu trecho de código completo do Velo dentro do head, antes dos seus scripts de medição. Salve o tema. Isso instala o Velo na storefront; o checkout precisa de uma integração própria e compatível.

Shopify: editor de código do tema
O editor de temas atual do Shopify. Abra layout/theme.liquid e use o head do tema da sua storefront; o checkout é uma superfície separada. Imagem da documentação oficial, revisada em 23 de setembro de 2026. Documentação do Shopify ↗

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

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

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: Abra Online Store → Themes, use o menu de ações do tema e escolha Edit code. Abra layout/theme.liquid e cole o seu trecho de código completo do Velo dentro do head, antes dos seus scripts de medição. Salve o tema. Isso instala o Velo na storefront; o checkout precisa de uma integração própria e compatível.

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.


Como configurar o Google Consent Mode v2 no Shopify
V
O diário do Velo2 de setembro de 2026
DiárioLer o post

Sites canadenses precisam do Consent Mode v2?

11 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 Shopify

Preciso do app do Shopify?

É o caminho mais rápido e o que recomendamos. O app Velo Consent ativa o banner pelo editor de temas sem editar código e repassa cada escolha à Customer Privacy API do Shopify, para que os pixels do Shopify e o checkout a sigam. É grátis para até 10.000 sessões por mês. Se preferir não adicionar um app, uma linha no theme.liquid entrega o mesmo banner e o Consent Mode v2 na sua storefront.

E o checkout?

O checkout do Shopify é hospedado pelo Shopify e não roda o código do tema, então o banner aparece na sua storefront. O app Velo Consent repassa cada escolha à Customer Privacy API do Shopify, que o checkout e os pixels do Shopify leem, então eles seguem a mesma decisão. Pelo caminho do código do tema, a escolha continua valendo para as tags da storefront, mas o próprio Shopify não fica sabendo.

Eu já uso um app de consentimento.

Remova ou desative antes de publicar o Velo. Dois banners em uma loja confundem os visitantes, e duas ferramentas definindo padrões do Consent Mode mandam sinais conflitantes para o Google.

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.