Antes de empezar
Necesitas un dominio en QookieQloud, su Site Key pública y un contenedor web GTM ya instalado.
En Configuración → Conexión, copia la API v2 Site Key que empieza por qq_pk_. No es el ID del contenedor GTM ni un token API privado.
Configuración → Conexión
Utiliza una sola instalación del banner. Si GTM carga QookieQloud, retira el cargador duplicado del sitio o de la integración CMS. No configures también QookieQloud para cargar ese mismo contenedor: el banner depende de que ya esté funcionando.
Instalar la plantilla
1. Busca y añade la plantilla
Abrir una nueva etiqueta
En tu espacio de trabajo GTM:
Encontrar QookieQloud
Abre la galería de plantillas:
Busca QookieQloud o abre directamente la plantilla GTM de QookieQloud en la galería.
Añadir la plantilla
Selecciona la plantilla verificada de QookieQloud (qodli-ab):
Confirma después:
2. Configura la etiqueta
| Ajuste | Valor inicial |
|---|---|
| QookieQloud Site Key | Tu Site Key pública · qq_pk_… |
| Enable Google Consent Mode v2 Default States | Activado |
| Regional Default Consent Settings | Dejar vacío |
| Wait For Update (ms) | 500 ms |
| Custom CDN Loader URL (Optional) | Dejar vacío |
3. Elige el activador y previsualiza
Selecciona Consent Initialization - All Pages. La propia etiqueta CMP no debe esperar consentimiento de marketing o estadísticas.
Guarda y comprueba con Preview antes de publicar el contenedor.
Referencia de ajustes
Abre un ajuste para leer la explicación completa. Los valores iniciales anteriores sirven para una instalación estándar.
QookieQloud Site Key
Selecciona el cargador API v2. Sin clave se utiliza el antiguo cargador API v1; el acceso API v1 debe seguir activado para el dominio. Actualiza la etiqueta si renuevas la Site Key.
Enable Google Consent Mode v2 Default States
Activado por defecto. Define las cuatro señales siguientes antes de cargar el banner. Desactivarlo solo elimina los valores iniciales de la plantilla, no Consent Mode en el cargador del banner.
Regional Default Consent Settings
Sin filas, las cuatro señales tienen el valor global denied. Con filas, solo se envían esas filas: añade una con Region vacía como valor global de respaldo. Ejemplos: SE, DE y US-CA, separados por comas si hay varios. La plantilla no convierte EEA en países. Estos valores no se sincronizan con las excepciones regionales de Customize.
Wait For Update (ms)
Valor inicial: 500 milisegundos. Da tiempo a las etiquetas Google compatibles para recibir una actualización asíncrona. No es un plazo para que el visitante decida; al terminar no se concede consentimiento.
Custom CDN Loader URL (Optional)
Déjalo vacío para la selección automática. El permiso de scripts solo permite https://cf-cdn.qookieqloud.com/*, no cualquier CDN externo.
el cargador actual también establece valores globales denied con 500 ms de espera. Los tiempos personalizados y valores regionales granted requieren una comprobación completa; la tabla de la plantilla no describe por sí sola el estado final.
Señales de consentimiento
| Categoría | Señales de Google |
|---|---|
| Estadísticas | analytics_storage |
| Marketing | ad_storagead_user_dataad_personalization |
La plantilla no define valores iniciales para functionality_storage, personalization_storage ni security_storage. El banner actualiza las preferencias y emite consent_update cuando cambian sus valores de consentimiento.
Ajustes del banner y etiquetas de seguimiento
Diseño, colores, apariencia clara/oscura, logotipo, textos e idioma se siguen configurando en QookieQloud. Guarda esos cambios allí.
Strict
Controla los scripts gestionados por QookieQloud. No puede bloquear el contenedor GTM que ya ha cargado el banner.
Flexible
Permite cargar los gestores de etiquetas gestionados mientras las señales comunican las preferencias. Las etiquetas Google compatibles pueden enviar solicitudes sin cookies cuando se deniega el consentimiento.
Auto
Elige Strict o Flexible según el país del visitante y las excepciones configuradas. No crea filas regionales en GTM ni controles de consentimiento para cada etiqueta.
Requisitos de consentimiento en GTM
- Para bloquear el propio GTM hasta obtener consentimiento, carga QookieQloud directamente antes de GTM, en lugar de dentro del contenedor.
- Si GTM carga el banner, configura los requisitos de consentimiento de cada etiqueta de seguimiento en GTM.
- Las etiquetas sin gestión integrada necesitan comprobaciones adicionales y un activador adecuado, como
consent_update. - El evento por sí solo no autoriza el seguimiento.
- Evita duplicar visitas o conversiones con activaciones repetidas.
Comprobar antes de publicar
- Inicia una sesión nueva del navegador. En Tag Assistant, verifica los valores iniciales antes de que las etiquetas de medición utilicen el consentimiento.
- Prueba rechazar todo, aceptar todo y solo Estadísticas, revisando las cuatro señales.
- Abre los ajustes, retira el consentimiento y recarga. Comprueba también las visitas posteriores.
- Revisa las etiquetas activadas y las solicitudes de red, también para las regiones configuradas. Publica después el contenedor comprobado.
Solución de problemas
¿No aparece el banner?
Revisa Site Key, dominio, solicitud del cargador y activador.
¿Las etiquetas se activan antes de tiempo?
Revisa sus requisitos y los scripts externos a GTM.
¿Aviso de consentimiento tardío?
Comprueba el orden en Tag Assistant: el cargador también puede detectar el evento de inicio de GTM en esta instalación. Si utilizas Google Tag Gateway (GTG), consulta nuestra guía para Late Consent y GTG.
