Guía de instalación de Shopware

Añade Velo a Shopware.

Instala el banner de cookies de Velo y Google Consent Mode v2 en Shopware en minutos. Con una línea en la plantilla de tu storefront basta. Si ya usas Google Tag Manager, esa ruta también está en esta página.

Empezar Todas las guías de instalación

Dóndestorefront/base.html.twig → base_head

PlanShopware 6

Se activaDespués de recompilar

TiempoUnos seis minutos

Pega una línea
en base.html.twig.

Una línea en Shopware y el banner está en todas las páginas, con el valor por defecto de Consent Mode fijado antes de que pueda dispararse ninguna otra etiqueta. El mismo banner, el mismo cableado y el mismo registro de auditoría que en la ruta de Tag Manager.

¿Ya usas Google Tag Manager? Mejor sigue esa ruta ↓

Tres pasos · unos seis minutos

01

Copia la línea

Una etiqueta de script, la misma en todas las páginas del sitio. Todo lo que viene ahora va de ponerla en el sitio correcto, y ese sitio es siempre el head, por delante de las etiquetas que gobierna.

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

Añade la etiqueta a tu storefront

En Shopware 6, extiende el bloque base_head de storefront/base.html.twig desde tu tema y añade ahí el fragmento, o usa una extensión de inyección de cabecera de la Shopware Store si prefieres no tocar plantillas.

tu-tienda.com/admin · Theme
03

Recompila y vacía la caché

Recompila el tema y vacía la caché para que el storefront recoja el cambio. El banner aparece en la siguiente carga de página, con el valor por defecto de Consent Mode fijado antes de que pueda dispararse ninguna otra etiqueta.

tu-sitio.com

Un detalle a vigilar

Si el banner no aparece después del cambio, casi siempre es la caché del tema: recompila el tema, vacía la caché y haz una recarga forzada. Después confirma que el fragmento está dentro del bloque base_head que tu tema extiende de verdad, con la llamada a parent() todavía en su sitio.

Recomendado si ya tienes un contenedor

O importa la etiqueta
en Tag Manager.

Una etiqueta, nada de código en la página, y todo tu stack de medición se queda en un mismo sitio. ¿Aún no usas Tag Manager? Una extensión de GTM de la Shopware Store, o ese mismo bloque de la plantilla base, deja puesto el contenedor. Después empieza aquí.

01Importa la plantilla CMP de VeloTemplates→Tag Templates→New→Import
02Crea la etiquetaTags→New→Velo CMP template
03Marca las dos opciones de recuperaciónAdvanced→url_passthrough→ads_data_redaction
04Dispárala en Consent Initialization – All PagesTriggering→Consent Initialization – All Pages
05Activa la vista general de consentimiento en AdminAdmin→Container Settings→Enable consent overview
06Previsualiza y publicaPreview→Submit→Publish

Una etiqueta nueva en Google Tag Manager con la plantilla Velo Consent Banner y el ID del sitio rellenado

La guía de Tag Manager, pantalla a pantalla Seis pantallas, unos diez minutos, igual en todas las plataformas.

Y verifícalo
con tráfico real.

Sea cual sea la ruta que hayas tomado, la consola de Velo sondea en busca de la primera señal real de tu sitio de Shopware — el banner cargando o una decisión quedando registrada — y pasa a instalado en cuanto llega una.

El banner de consentimiento de Velo en un sitio real, con las opciones Rechazar, Preferencias y Aceptar todo

El banner apareceEn una carga limpia de la página, el banner se muestra antes de que nada más pida datos.

Todo empieza denegadoDesde el EEE, el Reino Unido o Suiza, todas las señales de consentimiento arrancan denegadas hasta que la persona elige.

Cada elección cambia las señalesAceptar o rechazar cambia la actualización de consentimiento correspondiente, y la decisión queda en el registro de auditoría.

Lanza el análisis gratuito cuando ya estés en producción y leerá el resultado como si fuera la primera visita.

Preguntas sobre Shopware,
respondidas.

Lo que primero preguntan los equipos que instalan en Shopware.

¿Qué versión de Shopware cubre esto?

Los pasos apuntan a Shopware 6. Shopware 5 funciona igual desde su plantilla index, pero ya está en fin de vida, así que ahí la ruta de Tag Manager es la más limpia mientras planificas la actualización.

Shopware trae su propia barra de cookies.

Desactívala para ese canal de venta, de modo que Velo sea la única capa de consentimiento en marcha. Dos banners confunden a quien visita, y solo Velo conecta la decisión con Consent Mode y con el registro de auditoría.

¿Por qué no se ve el banner después del cambio?

Casi siempre es la caché del tema: recompila el tema, vacía la caché y haz una recarga forzada. Si sigue sin aparecer, confirma que el fragmento está dentro del bloque base_head que tu tema extiende de verdad.

¿Ralentizará el sitio?

No. El script carga en diferido, nunca bloquea el renderizado, y la región de quien visita se resuelve en el nodo más cercano antes de que la página termine de pintarse. El banner en sí son unos pocos kilobytes de código estático.

¿Puede hacerlo por mí un asistente de IA?

Sí. Copia el prompt de Instalar con agentes, justo debajo, en Claude, ChatGPT, Cursor o el asistente que ya uses. Lleva dentro los pasos de esta página, el orden en el que tienen que cargar las etiquetas y las comprobaciones que el agente tiene que hacer antes de decirte que ha terminado.

O pásaselo
a un agente.

Copia el prompt en Claude, ChatGPT, Cursor o el asistente que ya uses. Lleva dentro todo lo de esta página: las dos rutas, el orden en el que tienen que cargar las etiquetas y las comprobaciones que demuestran que ha funcionado.

El prompt

Pégalo como primer mensaje y luego cambia your-site-id por el ID de tu panel de Velo. Todo lo demás que el agente necesita ya está escrito dentro, incluido qué comprobar antes de publicar.

Prompt de instalación · Shopware

# Instalar Velo en Shopware: banner de cookies + Google Consent Mode v2

Vas a instalar Velo, una plataforma de gestión del consentimiento, en mi
sitio de Shopware. Velo muestra el banner de cookies, fija los valores
por defecto de Google Consent Mode v2 antes de que pueda dispararse
ninguna otra etiqueta, y registra cada decisión.

Pregúntame esto antes de tocar nada:

- Mi site id de Velo. Está en el panel de Velo. ¿Todavía no tengo
  cuenta? Mándame a https://veloconsent.com/get-started y espera al id.
- Si el sitio ya usa Google Tag Manager, y qué contenedor.
- Qué banner de cookies o herramienta de consentimiento está activa hoy
  en el sitio.

## Ruta A: con Google Tag Manager (preferible si GTM ya está activo)

1. Templates → Tag Templates → New y luego ⋮ → Import. Importa el
   template.tpl de github.com/ampliodata/velo-cmp ("Velo CMP").
2. Crea una etiqueta a partir de esa plantilla. Pon mi site id de Velo y
   elige el tema claro u oscuro.
3. Dispárala con el trigger "Consent Initialization – All Pages".
   Ni Initialization, ni All Pages. Los dos llegan demasiado tarde para
   fijar los valores por defecto del consentimiento.
4. Previsualiza, mira la pestaña Consent en Tag Assistant y luego Submit
   y Publish.

¿Aún no hay contenedor? En Shopware, Shopware 6 no trae campo de GTM en
el admin del core, así que la mayoría de tiendas instala un plugin de
GTM desde la Shopware Store y pega el id del contenedor en los ajustes
del plugin, dentro del 'sales channel' correspondiente.

## Ruta B: el fragmento, directo en el sitio

Pon esta línea en el <head>, por encima de cada etiqueta de
analítica y de publicidad:

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

En Shopware: extiende el bloque base_head de storefront/base.html.twig
desde el tema y añade ahí el fragmento, o usa una extensión de inyección
de cabecera de la Shopware Store para no tocar plantillas.

## Reglas

- Una ruta, nunca las dos. Dos instalaciones son dos banners.
- Velo carga primero. Todo lo que mide o anuncia va después.
- Solo una herramienta puede fijar los valores por defecto de Consent
  Mode. Desactiva la barra de cookies propia de Shopware para ese canal
  de venta, de modo que Velo sea la única capa de consentimiento en
  marcha. Y no dejes ningún gtag('consent', 'default',
  ...) escrito a mano en ningún otro sitio.
- No cambies nada más allá de lo que pide esta instalación. Avísame
  antes si hay que tocar un archivo del tema, un plugin o una etiqueta
  que ya existe.

## Verifica y cuéntame

- El banner aparece en una carga limpia, en una ventana privada.
- Antes de que yo elija, todas las señales de consentimiento salvo
  security_storage están denegadas desde el EEE, el Reino Unido o Suiza.
- Aceptar y rechazar cambian cada uno las señales correspondientes, y un
  evento velo_consent_update llega al data layer.
- Las etiquetas de Google se quedan en su modo sin cookies hasta que hay
  consentimiento, y cualquier etiqueta bloqueada a mano se dispara solo
  después.
- window.Velo está definido, y Velo.open() vuelve a abrir el panel de
  preferencias.
- En una instalación con Tag Manager, Tag Assistant muestra la etiqueta
  de Velo disparándose en Consent Initialization antes que ninguna otra.

Cuéntame qué cambiaste, dónde lo cambiaste y qué mostró cada
comprobación. Si una comprobación falla, arréglala y vuelve a pasarlas
todas.

Guía completa: https://veloconsent.com/shopware
Más contexto para agentes: https://veloconsent.com/llms.txt

¿Trabajas con un agente que lee la web? Apúntalo a veloconsent.com/llms.txt y a /install.md para el mismo contexto en texto plano.

Del diario.

Requisitos del banner de cookies del RGPD en 2026, y la comprobación que confirma cada uno Lo que un banner de cookies tiene que cumplir bajo el RGPD en 2026, cada punto con la comprobación en el navegador que demuestra que tu banner lo cumple de verdad. 29 de julio de 2026

Cómo comprobar que tu banner de cookies envía la señal de Consent Mode v2 Dos lecturas lo resuelven: las cuatro señales de consentimiento dentro del navegador y el estado que llegó realmente a Google en la petición. 26 de julio de 2026

¿Sigues necesitando un banner de cookies con etiquetado del lado del servidor? Sí. 24 de julio de 2026

Todos los artículos