Adicione o Velo
ao Shopware.
Instale o banner de cookies do Velo e o Google Consent Mode v2 no Shopware com uma linha no template da sua storefront. A maioria das instalações leva poucos minutos quando você já tem acesso de administrador ao site. Se você usa Google Tag Manager, esse caminho também está nesta página.
Instruções e fontes das imagens revisadas em 23 de setembro de 2026.
Cole uma linha
no base.html.twig.
Adicione o trecho de código do seu site ao head global do site, depois publique e teste o resultado. Se as suas tags de medição já rodam pelo Google Tag Manager, use o caminho abaixo.
Já usa o Google Tag Manager? Vá por esse caminho ↓
Três passos · cerca de seis minutos
-
01
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.veloconsent.com" data-velo-site="your-site-id" async></script> -
02
Estenda o template de head da storefront
No seu tema personalizado ou plugin, estenda storefront/base.html.twig e sobrescreva base_head. Cole o trecho de código completo do Velo antes da chamada parent(), preservando a saída do bloco pai. Faça o deploy, compile o tema e limpe o cache. Não edite os templates do núcleo do Shopware.
Shopware · template da storefront
{% sw_extends '@Storefront/storefront/base.html.twig' %} {% block base_head %} {# Paste the complete Velo snippet from your dashboard here. #} {{ parent() }} {% endblock %}Referência de configuração verificada · 23 de setembro de 2026 Referência de configuração conferida com a documentação da plataforma. Não é uma captura de tela do painel administrativo.
Documentação da plataforma ↗ -
03
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.
Captura da interface no ar · 23 de setembro de 2026 O banner real em veloconsent.com, capturado em 23 de setembro de 2026. O texto, o layout e as configurações regionais do seu banner podem ser diferentes.
Site do Velo no ar ↗Ver em tamanho real ↗
Se o banner não renderizar depois da edição, é quase sempre o cache do tema: recompile o tema, limpe o cache, recarregue forçado. Depois confirme que o trecho de código está dentro do bloco base_head que o seu tema realmente estende, com a chamada parent() ainda no lugar.
Ainda comparando opções? Leia por que as equipes usam o Velo no Shopware ou veja todas as plataformas compatíveis.
Ou adicione a tag
no Tag Manager.
Já tem um contêiner web do Google Tag Manager neste site? Adicione o Velo pela Community Template Gallery e configure por lá. Se você precisa instalar o contêiner primeiro, use a integração compatível da sua plataforma e confira na URL publicada.
- 01Adicione o template do Velo CMPTemplates→Tag Templates→New→Search Gallery
- 02Crie a tagTags→New→Velo CMP template
- 03Revise as opções avançadasAdvanced→url_passthrough→ads_data_redaction
- 04Dispare em Consent Initialization – All PagesTriggering→Consent Initialization – All Pages
- 05Ative a visão geral de consentimentoAdmin→Container Settings→Enable consent overview
- 06Faça o preview e publiquePreview→Submit→Publish
Velo CMP · configuração da tag
- ID do site no Velo
- Copie o ID exato do site no seu painel do Velo.
- Tema do banner
- Light ou Dark
- Endpoint da API do Velo (opcional)
- Use o endpoint da API que aparece nas configurações de instalação do Velo.
Nomes dos campos conferidos no template Velo CMP publicado. Use o ID do seu próprio site e o seu endpoint da API.
Template Velo CMP ↗Perguntas sobre o Shopware,
respondidas.
O que os times que instalam no Shopware perguntam primeiro.
Qual versão do Shopware isso cobre?
Os passos são para o Shopware 6. O Shopware 5 funciona do mesmo jeito pelo template index, mas chegou ao fim da vida útil, então o caminho pelo Tag Manager é o mais limpo lá enquanto você planeja a atualização.
O Shopware já vem com a própria barra de cookies.
Desative para o sales channel, para o Velo ser a única camada de consentimento rodando. Dois banners confundem os visitantes, e só o Velo liga a decisão ao Consent Mode e ao registro de auditoria.
Por que o banner não aparece depois da edição?
Quase sempre o cache do tema: recompile o tema e limpe o cache, depois recarregue forçado. Se ainda assim não renderizar, confirme que o trecho de código está dentro do bloco base_head que o seu tema realmente estende.
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.
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.
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.
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.
Privacidade na web em um só lugar.
Analise seu site →© 2026 por
