Guia de instalação do Shopware

Adicione o Velo ao Shopware.

Instale o banner de cookies do Velo e o Google Consent Mode v2 no Shopware em minutos. Uma linha no template da sua storefront resolve. Se você já usa Google Tag Manager, esse caminho também está nesta página.

Começar Todos os guias de instalação

Ondestorefront/base.html.twig → base_head

PlanoShopware 6

Entra no arDepois de recompilar

TempoCerca de seis minutos

Cole uma linha
no base.html.twig.

Uma linha no Shopware, e o banner está em todas as páginas com o padrão do Consent Mode definido antes de qualquer outra tag poder disparar. Mesmo banner, mesma ligação e o mesmo registro de auditoria do caminho pelo Tag Manager.

Já usa o Google Tag Manager? Vá por esse caminho ↓

Três passos · cerca de seis minutos

01

Copie a linha

Uma tag de script, igual em todas as páginas do site. Tudo abaixo é sobre colocá-la no lugar certo, e esse lugar é sempre o head, antes das tags que ela governa.

 <script src="https://veloconsent.com/v1/velo.js" data-velo-site="your-site-id" defer></script>
02

Adicione a tag à sua storefront

No Shopware 6, estenda o bloco base_head em storefront/base.html.twig a partir do seu tema e adicione o trecho de código ali, ou use uma extensão de injeção de header da Shopware Store se preferir não mexer em template.

sua-loja.com/admin · Theme
03

Recompile e limpe o cache

Recompile o tema e limpe o cache para a storefront pegar a mudança. O banner renderiza no próximo carregamento de página com o padrão do Consent Mode definido antes de qualquer outra tag poder disparar.

seu-site.com

Um ponto de atenção

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.

Recomendado se você já usa um contêiner

Ou importe a tag
no Tag Manager.

Uma tag, sem código na página, e toda a sua stack de medição fica em um lugar só. Ainda sem Tag Manager? Uma extensão de GTM da Shopware Store, ou o mesmo bloco do template base, coloca o contêiner. Depois comece por aqui.

01Importe o template do Velo CMPTemplates→Tag Templates→New→Import
02Crie a tagTags→New→Velo CMP template
03Marque as duas opções de recuperaçãoAdvanced→url_passthrough→ads_data_redaction
04Dispare em Consent Initialization – All PagesTriggering→Consent Initialization – All Pages
05Ative a visão geral de consentimento em AdminAdmin→Container Settings→Enable consent overview
06Faça o preview e publiquePreview→Submit→Publish

Uma nova tag no Google Tag Manager usando o template Velo Consent Banner, com o ID do site preenchido

O guia do Tag Manager, tela por tela Seis telas, cerca de dez minutos, igual em qualquer plataforma.

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?

Não. O script carrega com defer, nunca bloqueia a renderização, e a região do visitante é resolvida na borda mais próxima antes de a página terminar de pintar. O banner em si são alguns kilobytes de código estático.

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.

O prompt

Cole como sua primeira mensagem e troque your-site-id pelo ID que está no seu painel do Velo. Todo o resto de que o agente precisa já está escrito ali, inclusive o que verificar antes de publicar.

Prompt de instalação · Shopware

# Instale o Velo no Shopware: banner de cookies + Google Consent Mode v2

Você está instalando o Velo, uma plataforma de gestão de consentimento, no meu
site Shopware. O Velo mostra o banner de cookies, define os padrões do Google
Consent Mode v2 antes de qualquer outra tag poder disparar, e registra cada
decisão.

Me peça o seguinte antes de mexer em qualquer coisa:

- O id do meu site Velo. Ele está no painel do Velo. Ainda sem conta? Me mande
  para https://veloconsent.com/get-started e espere o id.
- Se o site já usa Google Tag Manager, e qual contêiner.
- Qual banner de cookies ou ferramenta de consentimento está no ar hoje.

## Caminho A: pelo Google Tag Manager (preferido quando o GTM já está no ar)

1. Templates → Tag Templates → New, depois ⋮ → Import. Importe o
   template.tpl de github.com/ampliodata/velo-cmp ("Velo CMP").
2. Crie uma tag a partir desse template. Defina o id do meu site Velo e escolha
   o tema claro ou escuro.
3. Dispare no gatilho "Consent Initialization – All Pages". Não
   Initialization, não All Pages. Os dois rodam tarde demais para definir os
   padrões de consentimento.
4. Preview, confira a aba Consent no Tag Assistant, depois Submit e
   Publish.

Ainda sem contêiner? No Shopware, o Shopware 6 não tem campo de GTM no admin
do core, então a maioria das lojas instala um plugin de GTM da Shopware Store e
cola o id do contêiner nas configurações do plugin, dentro do
'sales channel' correspondente.

## Caminho B: o trecho de código, direto no site

Ponha esta linha no <head>, acima de toda tag de análise e de publicidade:

  <script src="https://veloconsent.com/v1/velo.js"
    data-velo-site="MY_SITE_ID" defer></script>

No Shopware: estenda o bloco base_head em storefront/base.html.twig a partir do
tema e adicione o trecho de código ali, ou use uma extensão de injeção de
header da Shopware Store para não mexer em template.

## Regras

- Um caminho, nunca os dois. Duas instalações significam dois banners.
- O Velo carrega primeiro. Tudo que mede ou anuncia vem depois.
- Só uma ferramenta pode definir os padrões do Consent Mode. Desative a barra
  de cookies nativa do Shopware para aquele sales channel, para o Velo ser a
  única camada de consentimento rodando. Também não deixe nenhum
  gtag('consent', 'default', ...) escrito à mão em nenhum outro lugar.
- Não mude nada além do que esta instalação exige. Me avise antes se um arquivo
  de tema, plugin ou tag existente tiver que ser tocado.

## Verifique, depois me reporte

- O banner renderiza em um carregamento novo em uma janela anônima.
- Antes de eu escolher, todo sinal de consentimento exceto security_storage
  está negado a partir de uma localização do EEE, do Reino Unido ou da Suíça.
- Aceitar e recusar invertem cada um os sinais correspondentes, e um evento
  velo_consent_update chega à camada de dados.
- As tags do Google ficam no modo sem cookies até o consentimento ser
  concedido, e qualquer tag controlada à mão só dispara depois disso.
- window.Velo está definido, e Velo.open() reabre o painel de preferências.
- Em uma instalação por Tag Manager, o Tag Assistant mostra a tag do Velo
  disparando em Consent Initialization antes de qualquer outra tag.

Me diga o que você mudou, onde mudou, e o que cada verificação mostrou. Se uma
verificação falhar, corrija e rode as verificações de novo.

Guia completo: https://veloconsent.com/pt/shopware
Mais contexto para agentes: https://veloconsent.com/llms.txt

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.

Requisitos do GDPR para banners de cookies em 2026, e a verificação que prova cada um O que um banner de cookies precisa fazer sob o GDPR em 2026, cada item ao lado da verificação no navegador que prova que o seu banner realmente faz. 29 de julho de 2026

Como verificar se o seu banner de cookies está enviando o sinal do Consent Mode v2 Duas leituras resolvem: os quatro sinais de consentimento dentro do navegador e o estado que de fato chegou ao Google na requisição. 26 de julho de 2026

Você ainda precisa de banner de cookies com marcação do lado do servidor Precisa. 24 de julho de 2026

Todos os artigos