Menú de documentación
Google Tag Manager
La plantilla de CookieHug para Google Tag Manager: instalación, el activador Consent Initialization, parámetros, comportamiento y permisos de la plantilla.
Plantilla de Google Tag Manager
CookieHug publica una plantilla personalizada oficial para Google Tag Manager con la que puedes desplegar el banner de consentimiento y Google Consent Mode v2 íntegramente desde GTM, sin necesidad del snippet en el <head>. Está publicada en la galería de plantillas de la comunidad de GTM (busca *CookieHug Consent Banner*) y su código fuente vive en un repositorio público propio: github.com/cookiehug-com/gtm-cookiehug.
La plantilla es un cargador ligero y universal: cada sitio pega su propia clave de licencia, así que la misma plantilla sirve para cualquier dominio de CookieHug. Hace exactamente dos cosas: pone todas las señales de GCM v2 en denied *antes* de que se dispare cualquier etiqueta y luego inyecta el SDK de CookieHug, que aplica tus valores por defecto regionales y llama a updateConsentState cuando el visitante actúa. Toda la configuración del banner (categorías, textos, colores, bloqueo) sigue en el panel de CookieHug; la plantilla es un conector, no una superficie de ajustes.
Cuándo usarla
Usa la plantilla de GTM en lugar del snippet del <head> cuando ya gestiones tus etiquetas de analítica y publicidad con Google Tag Manager y quieras un único lugar —la Consent Initialization de GTM— donde se fijen los valores por defecto antes de que cualquier etiqueta evalúe su consentimiento. Si no usas GTM, quédate con el snippet <script> estándar o con el plugin de WordPress; no instales ambos, o los valores por defecto se fijarán dos veces.
Instalación
- Desde la galería (recomendado): GTM → Plantillas → Plantillas de etiqueta → Buscar en la galería → busca *CookieHug Consent Banner* → Añadir al espacio de trabajo.
- Importación manual (mientras la ficha de la galería no esté publicada): descarga `template.tpl` y luego ve a GTM → Plantillas → Plantillas de etiqueta → Nueva → ⋮ → Importar y selecciona el archivo.
- Crea una etiqueta: Etiquetas → Nueva → CookieHug Consent Banner.
- Asígnala al activador Consent Initialization — All Pages. Es el activador nativo más temprano de GTM y garantiza que los valores denegados por defecto se fijen antes de que se ejecute cualquier etiqueta de analítica o publicidad. No uses Page View / All Pages / DOM Ready.
Parámetros
| Parámetro | Tipo | Por defecto | Notas |
|---|---|---|---|
licenseKey | TEXT | *obligatorio* | La clave de tu sitio en Panel → Dominio → Configuración. |
region | SELECT | auto | Fuerza una región para el estado de consentimiento por defecto (EEA/GB/CH/US/US-CA/ROW). Déjalo en auto en producción. |
loadPosition | SELECT | async | async (rápido, no bloqueante) o defer (tras analizar el HTML). Ambos fijan los valores por defecto antes que otras etiquetas. |
debugMode | CHECKBOX | false | Muestra la insignia de diagnóstico de CookieHug. Solo para contenedores de vista previa o prueba; nunca en producción. |
Qué ejecuta la plantilla
1. setDefaultConsentState({ ad_storage: 'denied', ad_user_data: 'denied', ad_personalization: 'denied', analytics_storage: 'denied', functionality_storage: 'denied', personalization_storage: 'denied', security_storage: 'granted', wait_for_update: 500 }): impide que las etiquetas de marketing y analítica se disparen antes de que se actualice el consentimiento.
2. injectScript('https://cookiehug.com/api/script/<licenseKey>.js'): carga el SDK de CookieHug, que sustituye los valores por defecto por los correspondientes a la región, muestra el banner si hace falta y llama a updateConsentState cuando el usuario pulsa un botón.
Si rechazas el permiso inject_script en un contenedor restringido, la etiqueta llama limpiamente a gtmOnFailure(): no se carga el banner, pero las etiquetas posteriores siguen bloqueadas porque los valores por defecto permanecen en denied.
Permisos solicitados
access_consent: lectura y escritura para todas las señales de GCM v2 (ad_storage,ad_user_data,ad_personalization,analytics_storage,functionality_storage,personalization_storage,security_storage).inject_script: limitado exclusivamente ahttps://cookiehug.com/api/script/*.logging: solo en entornos de depuración.
No la combines con el snippet
La plantilla de GTM y el snippet del <head> fijan ambos los valores por defecto de Consent Mode. Usa exactamente una integración por sitio. Si migras un sitio del snippet a la plantilla de GTM, retira primero la etiqueta <script id="cookiehug"> del <head>; de lo contrario, la segunda llamada por defecto de GTM puede sobrescribir los valores regionales de CookieHug y romper el control para el EEE.