Guía de instalación de Google Tag Manager

Añade Velo a
Google Tag Manager.

Instala el banner de cookies de Velo y Google Consent Mode v2 con una sola etiqueta importada de la plantilla Velo CMP. Nada de código en la página, nada de Custom HTML. Configura la etiqueta, pon el activador, publica. Unos diez minutos de principio a fin.

Empezar Todas las guías de instalación

Instálalo con
Google 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.

Seis pasos · unos diez minutos

01

Importa la plantilla CMP de Velo

Descarga template.tpl desde github.com/ampliodata/velo-cmp. En tu contenedor, abre Templates → Tag Templates → New, luego abre el menú ⋮ de la esquina superior derecha del editor y elige Import. Selecciona el archivo que acabas de descargar, guarda, y la etiqueta Velo CMP queda lista para configurar. Velo CMP está a la espera de aparecer en la Community Template Gallery de Google. Hasta que llegue, importar el archivo es la vía de entrada, y la etiqueta se comporta igual.

Templates→Tag Templates→New→Import

tagmanager.google.com
02

Crea la etiqueta

Ve a Tags → New y elige la plantilla de Velo. Introduce tu ID de sitio de Velo , letras minúsculas, dígitos y guiones, exactamente como lo muestra el panel, y luego elige el tema claro u oscuro para que encaje con tu sitio. Deja el API endpoint en blanco salvo que Velo te haya dado uno para tu cuenta: el banner y Consent Mode funcionan del todo sin él, y cuando está definido la configuración remota del panel pasa a controlar los textos y las categorías.

Tags→New→Velo CMP template

tagmanager.google.com
03

Marca las dos opciones de recuperación

En Advanced hay dos casillas que conviene activar. url_passthrough deja que los identificadores de clic en anuncios, de cliente y de sesión sobrevivan a la navegación a través de parámetros de URL mientras el consentimiento de almacenamiento está denegado, y recupera la atribución del tráfico que tu banner perdería de otro modo. ads_data_redaction además descarta los identificadores de clic en anuncios y hace que las peticiones vayan sin cookies mientras ad_storage está denegado, algo recomendable en configuraciones europeas estrictas. Los campos para sobrescribir los textos pueden quedarse vacíos; mejor edita los textos en el panel de Velo.

Advanced→url_passthrough→ads_data_redaction

tagmanager.google.com
04

Dispárala en Consent Initialization – All Pages

Este es el activador que Google ofrece específicamente para los valores por defecto de consentimiento: se ejecuta antes que cualquier otro activador del contenedor, y eso es lo que garantiza que el estado denegado por defecto esté puesto antes de que pueda dispararse ninguna etiqueta de medición. No uses Initialization ni All Pages. Los dos se ejecutan demasiado tarde. Esta única decisión es casi todo lo que hace correcta una instalación de consentimiento.

Triggering→Consent Initialization – All Pages

tagmanager.google.com
05

Activa la vista general de consentimiento en Admin

En Admin → Container Settings, marca Enable consent overview. Eso enciende las funciones de consentimiento del contenedor: el icono de escudo en la vista Tags que muestra el estado de consentimiento de cada etiqueta, y las lecturas del estado de consentimiento que vas a comprobar en Preview. Hazlo antes de abrir Preview. Sin ello, GTM no te da ninguna vista general de consentimiento contra la que depurar.

Admin→Container Settings→Enable consent overview

tagmanager.google.com
06

Previsualiza y publica

En Preview, comprueba tres cosas: que la etiqueta de Velo se disparó en Consent Initialization antes que cualquier otra etiqueta; que la pestaña Consent de Tag Assistant muestra todas las señales excepto security_storage denegadas por defecto desde una ubicación del EEE, el Reino Unido o Suiza; y que aceptar o rechazar en el banner cambia la fila de actualización correspondiente mientras un evento velo_consent_update llega a la capa de datos. Después, Submit → Publish. El banner está activo en la siguiente carga de página, y la consola de Velo pasa a instalado por su cuenta cuando llega la primera señal real.

Preview→Submit→Publish

tagmanager.google.com

Condiciona cualquier etiqueta
a la decisión.

Más allá de Consent Mode, puedes retener cualquier etiqueta hasta que se conceda una categoría — tres piezas pequeñas en el mismo contenedor.

velo_categoriesData Layer Variable

velo_consent_updateActivador Custom Event

Etiqueta de evento de GA4se dispara cuando analytics ✓

Una variableCrea una Data Layer Variable llamada velo_categories. Es un objeto de booleanos: analytics, ads, functional, personalization , que refleja la decisión actual de quien visita.

Un activadorCrea un activador Custom Event sobre velo_consent_update con una condición en la categoría que te interese, por ejemplo, velo_categories.analytics igual a true.

EngánchaloPon ese activador en la etiqueta que quieras condicionar. Como el evento también se dispara para quien vuelve con una decisión ya guardada, la etiqueta se dispara en cada vista de página en la que hay consentimiento, sin el hueco del "solo se dispara una vez después del clic".

Preguntas sobre Google Tag Manager,
respondidas.

Lo que primero preguntan los equipos que instalan en Google Tag Manager.

El banner no aparece.

Casi siempre es una de dos cosas: la etiqueta no está en el activador Consent Initialization – All Pages, o la versión del contenedor nunca se publicó. Abre Preview y mira dónde se dispara la etiqueta. La solución suele verse en diez segundos.

Las señales salen concedidas por defecto en la UE.

Hay algo más compitiendo con Velo: una etiqueta CMP antigua, un fragmento de consent default dentro de una etiqueta Custom HTML, o un gtag default escrito a mano en la página. Solo una cosa del stack puede fijar los valores por defecto. Encuentra la otra y quítala.

Se muestran dos banners a la vez.

El fragmento directo de velo.js también está puesto en el marcado de la página. Usa una sola ruta de instalación, no las dos. Si están las dos, los atributos del fragmento en línea ganan a la configuración de la etiqueta, y eso enturbia la depuración. Quita una.

Mi etiqueta condicionada no se dispara nunca.

Comprueba que el nombre del evento en el activador Custom Event es exactamente velo_consent_update, con guiones bajos y sin erratas, y que no se activó por error la coincidencia por regex. Después confirma que la condición lee la variable velo_categories, no el nombre del evento.

¿Es distinta la instalación con Tag Manager de la del fragmento?

No. Mismo banner, mismo cableado de Consent Mode, mismo registro de auditoría, mismo panel. La ruta de la plantilla solo mantiene todo el stack de medición en un mismo contenedor, y por eso es la que recomendamos en todas las guías de plataforma.

¿Puede hacerlo por mí un agente?

Sí. Copia el prompt de Instalar con agentes, justo debajo, en Claude, ChatGPT, Cursor o el asistente que ya uses. Lleva dentro la plantilla, el activador, el patrón de bloqueo para las etiquetas que Consent Mode no cubre, 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 · Google Tag Manager

# Instalar Velo en Google Tag Manager: banner + Consent Mode v2

Estás instalando Velo, una plataforma de gestión del consentimiento, en mi
contenedor de Google Tag Manager. Velo fija los valores por defecto de
Consent Mode v2 antes de que se dispare ninguna otra etiqueta, muestra el
banner de cookies y registra cada decisión. No se toca el marcado de la
página.

Pídeme esto antes de tocar el contenedor:

- Mi site id de Velo. Está en el panel de Velo. ¿Aún no tienes cuenta?
  Mándame a https://veloconsent.com/get-started y espera al id.
- El id del contenedor, y si puedo publicar o solo enviar para revisión.
- Qué herramienta de consentimiento está activa hoy en el sitio.

## La instalación

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 activador "Consent Initialization – All Pages". No
   Initialization, no All Pages. Los dos se ejecutan demasiado tarde para
   fijar los valores por defecto del consentimiento.
4. Preview, después Submit y Publish.

## Controlar etiquetas que no son de Google

GA4, Google Ads y Floodlight no necesitan nada más. Sus comprobaciones de
consentimiento integradas las retienen y las liberan solas. Para un widget
de chat, un mapa de calor o un píxel sin soporte de Consent Mode:

1. Crea una Data Layer Variable llamada velo_categories. Es un objeto de
   booleanos: analytics, ads, functional, personalization.
2. Crea un activador Custom Event sobre velo_consent_update, con una
   condición del tipo velo_categories.analytics equals true.
3. Pon ese activador en la etiqueta. El evento también se dispara para
   quien vuelve con una decisión ya guardada, así que la etiqueta no queda
   limitada a la única página vista en la que se hizo clic.

## Reglas

- Instala una sola ruta. Si el fragmento velo.js también está en el marcado
  de la página, quítalo. Dos instalaciones significan dos banners.
- Solo una herramienta puede fijar los valores por defecto de Consent Mode.
  Si hay otra etiqueta de CMP en el contenedor, páusala antes de publicar
  Velo. No dejes ningún gtag('consent', 'default', ...) escrito a mano en
  la página ni en una etiqueta de Custom HTML.
- No cambies ninguna otra etiqueta, activador ni variable. Avísame primero
  si hay que mover alguna.

## Verifica y luego infórmame

- 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 una ubicación del EEE, el Reino
  Unido o Suiza.
- Aceptar y rechazar cambian cada uno las señales correspondientes, y un
  evento velo_consent_update llega a la data layer.
- Las etiquetas de Google se quedan en su modo sin cookies hasta que se
  concede el consentimiento, y cualquier etiqueta controlada 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 por delante de todas las
  demás.

Dime qué has cambiado, dónde lo has cambiado y qué ha mostrado cada
comprobación. Si una comprobación falla, arréglala y vuelve a pasarlas
todas.

Guía completa: https://veloconsent.com/google-tag-manager
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.

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

Cómo pasar la señal de consentimiento a un contenedor de etiquetado del lado del servidor El consentimiento se decide en el contenedor web y viaja al servidor dentro de la petición. 27 de julio de 2026

Consent Mode básico o avanzado: ¿cuál estás usando? Rechaza el consentimiento en incógnito y lee el parámetro gcs en la petición a Google. 12 de julio de 2026

Todos los artículos