Cookie Manager Tarteaucitron — Guía completa

Presentación

Cookie Manager Tarteaucitron es un módulo de gestión del consentimiento de cookies para PrestaShop 8.0+ y 9.x. Combina el motor open-source tarteaucitron.js — que bloquea efectivamente los servicios antes del consentimiento — con una interfaz moderna estilo Axeptio: tarjeta flotante animada, interruptores por categoría y burbuja de reapertura. El módulo integra Google Consent Mode v2, un escáner de trackers con activación automática y un registro RGPD de los consentimientos.

Instalación

1. En tu back-office PrestaShop, ve a Módulos → Gestor de módulos → Subir un módulo.
2. Sube el archivo datafirefly_tarteaucitron.zip.
3. Haz clic en Instalar y luego en Configurar.

Después de cualquier actualización del módulo, vacía la caché de PrestaShop: Parámetros avanzados → Rendimiento → Vaciar la caché.

Configuración general

La pestaña General contiene los ajustes básicos:

• Activar el módulo: interruptor principal del banner en el front-office.
• Nombre de la cookie: nombre de la cookie de consentimiento (por defecto tarteaucitron). Cámbialo solo si otra herramienta entra en conflicto.
• Duración de la cookie: 365 días por defecto. Las autoridades europeas recomiendan un máximo de 13 meses (395 días).
• Burbuja de reapertura: muestra una pequeña burbuja «Cookies» tras el consentimiento, permitiendo al visitante modificar sus elecciones en cualquier momento — una exigencia RGPD.
• Enlace a la política de privacidad: URL de tu página CMS, mostrada bajo los botones del banner.

La pestaña Textos permite personalizar el título, el mensaje y las etiquetas de los tres botones. La pestaña Diseño controla el color principal y los colores de fondo y de texto de los botones.

Activar los servicios

La pestaña Servicios lista las 11 integraciones listas para usar. Para cada servicio, activa el interruptor y completa el identificador solicitado:

• Google Analytics 4: Measurement ID en formato G-XXXXXXXX
• Google Tag Manager: Container ID en formato GTM-XXXXXX
• Google Ads: Conversion ID
• Meta Pixel: Pixel ID numérico
• Hotjar: Site ID numérico
• LinkedIn Insight: Partner ID
• TikTok Pixel: Pixel ID
• Microsoft Clarity: Project ID
• Intercom: App ID
• YouTube: sin identificador — activa el bloqueo de los vídeos incrustados antes del consentimiento
• Stripe: sin identificador — ver la sección dedicada más abajo

Escáner y detección automática

La pestaña Detección automática configura el módulo por ti:

1. Haz clic en Escanear el sitio ahora. El módulo lee las cookies presentes en tu dominio y recupera el HTML de tu front-office para analizar las etiquetas de scripts de terceros.
2. Aparecen dos tablas: las cookies detectadas (con servicio probable y categoría sugerida, editable) y los scripts de terceros identificados (con su estado en el módulo).
3. La barra verde indica el número de servicios reconocidos. Haz clic en Aplicar al módulo y guardar: los servicios correspondientes se activan y la configuración se guarda inmediatamente.
4. Pasa después a la pestaña Servicios para completar los identificadores de los servicios recién activados.

El escáner reconoce entre otros: Google Analytics, Google Ads, Meta Pixel, Hotjar, LinkedIn, TikTok, Microsoft Clarity, Intercom, Brevo, Stripe, así como las cookies funcionales de PrestaShop.

Google Consent Mode v2

Obligatorio desde marzo de 2024 para los anunciantes europeos, Consent Mode v2 permite a Google modelizar las conversiones incluso en caso de rechazo. La pestaña Consent Mode del módulo:

• emite las 7 señales requeridas (ad_storage, ad_user_data, ad_personalization, analytics_storage, functionality_storage, personalization_storage, security_storage) como default antes de cualquier tag;
• permite configurar cada estado por defecto individualmente — denied se recomienda para el EEE;
• actualiza las señales automáticamente según las elecciones del visitante.

Particularidad del módulo: al cargar cada página, el estado por defecto lee la cookie de consentimiento existente. Un visitante que ya aceptó obtiene granted desde el primer frame — ninguna ventana denied transitoria que recorte tus conversiones de Google Ads al recargar.

Stripe y las cookies esenciales

Las cookies de Stripe (__stripe_mid, __stripe_sid) son estrictamente necesarias para la prevención del fraude en el pago. Entran en la exención de consentimiento prevista para los rastreadores esenciales: bloquearlas rompería el túnel de compra.

El módulo las trata en consecuencia: cuando el servicio Stripe está activado, se carga sin solicitud de consentimiento y aparece en el panel de preferencias bajo la categoría Esenciales y pago con la insignia «Siempre activo». Transparencia total para el visitante, cero pagos bloqueados.

Servicios personalizados

La pestaña Servicios personalizados permite añadir cualquier script de terceros ausente de la lista:

• Clave: identificador técnico único en minúsculas (ej. michat)
• Nombre: etiqueta mostrada en el banner
• Categoría: analytic, ads, social, support, api u other
• Código JavaScript: el código de carga del servicio, ejecutado solo tras el consentimiento
• Cookies: lista de nombres de cookies depositadas, separadas por comas
• URL de política: enlace a la política de privacidad del servicio

Los servicios personalizados aparecen en el banner bajo una categoría dedicada con su propio interruptor.

Registro RGPD de los consentimientos

El artículo 7 del RGPD exige poder demostrar que el consentimiento fue otorgado. La pestaña Registro RGPD muestra los últimos 50 registros con, para cada acción:

• la fecha y la hora;
• el identificador de visitante anónimo (cookie técnica dedicada, ningún dato personal);
• las categorías aceptadas;
• el detalle de las elecciones servicio por servicio.

Puntos clave del funcionamiento:

• La dirección IP nunca se almacena en claro: se hashea en SHA-256 con un salt del servidor, conforme a las recomendaciones de las autoridades de protección de datos.
• Una deduplicación en servidor ignora los registros idénticos del mismo visitante en los 5 segundos siguientes (doble clic).
• Una purga automática elimina las entradas de más de 3 años en cada visita a la página de configuración.
• El registro se conserva en caso de desinstalación del módulo para preservar tu pista de auditoría.

Solución de problemas

• El banner no se muestra: verifica que el módulo esté activado en la pestaña General y luego vacía la caché de PrestaShop. Verifica también que ningún otro módulo de consentimiento esté activo en paralelo.
• Las elecciones no se memorizan: asegúrate de usar la versión 1.1.0 o superior, que escribe la cookie en el formato nativo de tarteaucitron. Vacía la caché del navegador y elimina la antigua cookie de consentimiento antes de volver a probar.
• Un servicio no se carga tras la aceptación: verifica que su identificador esté completado en la pestaña Servicios. Abre la consola del navegador para detectar posibles errores.
• El escaneo no detecta nada: navega primero por el front-office en el mismo navegador y luego relanza el escaneo. Si el admin y el front están en dominios diferentes, solo funciona el análisis de scripts.
• Ningún registro en el journal: visita la página de configuración del módulo (la tabla se crea automáticamente si falta) y luego efectúa un nuevo consentimiento desde el front en navegación privada.