PS PrestaShop Principiante

Cookie Manager Tarteaucitron — Guía completa

Instalación, asistente, bloqueo automático de scripts de terceros, lista de cookies, catálogo de servicios, apariencia, Google Consent Mode v2, análisis, estadísticas y prueba de los consentimientos del módulo Cookie Manager (tarteaucitron.js) para PrestaShop 1.7.8, 8 y 9.

Actualizado Versión del módulo 3.0.0

Presentación

Cookie Manager es un módulo de gestión del consentimiento de cookies para PrestaShop 1.7.8, 8 y 9, compatible con los temas Classic y Hummingbird. Se basa en tarteaucitron.js 1.37.0, la biblioteca de código abierto de Amauri Champeaux (licencia MIT). El módulo le añade su propio banner, el bloqueo automático de scripts de terceros, una lista de cookies generada para tus visitantes, Google Consent Mode v2 y un registro de prueba de los consentimientos.

Mientras el visitante no haya elegido nada, el módulo no instala ninguna cookie, no escribe nada en el almacenamiento del navegador ni contacta con ningún tercero. La cookie que recuerda la elección solo se escribe con el primer clic.

Banner de cookies en la página de inicio de una tienda PrestaShop 9 (tema Hummingbird): «Rechazar todo» y «Aceptar todo» con la misma apariencia
Banner de cookies en la página de inicio de una tienda PrestaShop 9 (tema Hummingbird): «Rechazar todo» y «Aceptar todo» con la misma apariencia

Instalación y asistente de inicio

  1. En el back office, abre Módulos → Gestor de módulos → Subir un módulo.
  2. Arrastra el archivo datafirefly_tarteaucitron-3.0.0.zip y haz clic en Configurar.
  3. El asistente se abre la primera vez: política de privacidad, herramientas utilizadas y sus identificadores, apariencia y activación del banner.

La configuración también es accesible desde la entrada de menú Módulos → Cookies (tarteaucitron). Puedes volver a lanzar el asistente en cualquier momento con el botón Asistente de la parte superior de la página.

Asistente de configuración en 4 pasos: elección de las herramientas que usa la tienda e introducción de sus identificadores
Asistente de configuración en 4 pasos: elección de las herramientas que usa la tienda e introducción de sus identificadores

Actualización desde la versión 2.0 o 1.x

Sube el nuevo zip sobre el módulo antiguo. El script de actualización recupera tus ajustes: servicios e identificadores, textos, colores, posición, duración, Consent Mode, registro, estadísticas y servicios personalizados.

  • La elección ya expresada por tus visitantes con la 2.0 se conserva: el banner no se les vuelve a mostrar, salvo si añades un servicio.
  • El bloqueo automático permanece desactivado tras una actualización. Actívalo en la pestaña Bloqueo y después prueba tus páginas.
  • Desde la 1.x, el valor único de cada texto se copia en todos los idiomas de la tienda, y la etiqueta «Continuar sin aceptar» pasa a ser «Rechazar todo».

En una instalación nueva, el bloqueo automático está activado de origen.

Panel de control

El panel de control reúne doce comprobaciones de configuración: banner activado, enlace a la política de privacidad, botones «Rechazar todo» y «Aceptar todo» con la misma apariencia, duración de la elección, medio de retirada, valores por defecto de Consent Mode, identificadores válidos, archivos servidos por la tienda, análisis de scripts de terceros, bloqueo automático, lista de cookies accesible para el visitante y registro de prueba. Cada punto no cumplido ofrece un enlace Corregir hacia la pestaña adecuada.

Estas comprobaciones recogen buenas prácticas basadas en las recomendaciones de la CNIL y del CEPD. Ayudan a configurar el banner, pero no sustituyen el análisis jurídico de tu sitio.

Panel del banner de cookies: control de la configuración en 12 puntos, cifras de los últimos 30 días y servicios gestionados
Panel del banner de cookies: control de la configuración en 12 puntos, cifras de los últimos 30 días y servicios gestionados

Servicios

La pestaña Servicios presenta el catálogo verificado: Google Analytics 4, Google Tag Manager, Google Ads, Meta Pixel, TikTok, LinkedIn Insight, Pinterest, Snap Pixel, Microsoft Advertising, Microsoft Clarity, Hotjar, Matomo, Plausible, HubSpot, YouTube, Vimeo, Google Maps, Intercom, Crisp, Tawk.to, Smartsupp y Stripe, así como dos señales de Google Consent Mode sin script, para una etiqueta de Google instalada por otro módulo.

  • Activa solo las herramientas realmente presentes en tu tienda y pega su identificador: su formato se verifica mientras lo escribes y de nuevo al guardar. Un identificador no válido se rechaza y el servicio permanece desactivado.
  • Cada servicio puede asignarse a una categoría distinta de la propuesta, por ejemplo Google Tag Manager en «Publicidad» si tu contenedor contiene sobre todo etiquetas publicitarias.
  • Matomo y Plausible pueden declararse exentos de consentimiento, únicamente si tu configuración de la herramienta cumple las condiciones de la CNIL para la medición de audiencia.
  • Stripe se trata como estrictamente necesario para el pago: se carga sin solicitud y se muestra entre las cookies siempre activas.

Servicios personalizados: para una herramienta que no está en el catálogo, añade un servicio con su nombre, su categoría, su política de privacidad, sus cookies y el código proporcionado por la herramienta (etiquetas <script> incluidas). Este código solo se ejecuta después de que el visitante acepte la categoría elegida.

Catálogo de 24 servicios verificados: identificadores comprobados al introducirlos, categoría mostrada al visitante, búsqueda y filtros
Catálogo de 24 servicios verificados: identificadores comprobados al introducirlos, categoría mostrada al visitante, búsqueda y filtros

Biblioteca tarteaucitron.js: los 245 servicios de tarteaucitron.js 1.37.0 están disponibles además del catálogo. Busca un servicio, añádelo, completa sus parámetros y elige su categoría. El visitante solo descarga el archivo de un servicio si el servicio está activado y aceptado.

Biblioteca tarteaucitron.js: búsqueda entre 245 servicios adicionales y adición con un solo clic
Biblioteca tarteaucitron.js: búsqueda entre 245 servicios adicionales y adición con un solo clic

Bloqueo automático

Antes de enviar cada página, el módulo neutraliza las etiquetas <script> y los iframes de los servicios de terceros que reconoce, procedan del tema o de otro módulo: 46 servicios (los del catálogo y otros 24 rastreadores habituales), además de tus propias reglas. No se descarga ni se ejecuta nada mientras el visitante no haya aceptado la categoría correspondiente; después, las etiquetas se reactivan en el orden del documento.

  • Reglas adicionales: una regla por línea, con el formato fragmento de dirección o de código | nombre mostrado al visitante | categoría. Las categorías son analytic, ads, social y functional. El botón «Bloquear» del análisis añade la regla por ti.
  • Excepciones: un fragmento por línea; una etiqueta cuya dirección o código lo contenga nunca se bloquea. También puedes añadir el atributo data-dftac-ignore a una etiqueta de tu tema.

El bloqueo se aplica a las etiquetas presentes en el código de la página. Un script cargado por otro script (por ejemplo, desde un archivo JavaScript de un módulo) no figura en él: desactívalo en ese módulo y declara el servicio aquí. Un script que utiliza document.write puede no funcionar una vez reactivado.

Google Tag Manager se bloquea por completo hasta la aceptación. Si lo controlas con el Consent Mode, añade googletagmanager.com/gtm.js a las excepciones.

Bloqueo automático de scripts de terceros y contenidos incrustados antes del consentimiento: ajustes, reglas adicionales, excepciones y límites
Bloqueo automático de scripts de terceros y contenidos incrustados antes del consentimiento: ajustes, reglas adicionales, excepciones y límites

Lista de cookies

La pestaña Cookies genera la lista de cookies a partir de los servicios activados, las etiquetas bloqueadas y lo que tú añadas: categoría, servicio, nombre, duración y finalidad. Se actualiza cada vez que guardas y se muestra en el idioma del visitante.

  • Cookies adicionales: una cookie por línea, con el formato nombre | proveedor | duración | finalidad | categoría, para las cookies de tus otros módulos o para precisar una duración.
  • Solo se indica una duración si se ha recogido en la documentación del editor (noviembre de 2026); «—» significa que la fija el servicio.

Comprueba esta lista antes de publicarla: describe los servicios declarados en el módulo, no los que otro script pudiera añadir sin que lo sepas.

Lista de cookies generada automáticamente: categoría, servicio, nombre, duración y finalidad de cada cookie, cookies adicionales
Lista de cookies generada automáticamente: categoría, servicio, nombre, duración y finalidad de cada cookie, cookies adicionales

Con la opción Publicar la lista de cookies (pestaña Comportamiento), se crea una página pública, enlazada desde el banner, la ventana de preferencias y el pie de página.

Página pública «Lista de cookies»: cookies clasificadas por finalidad con duración y finalidad, botón «Gestionar mis cookies»
Página pública «Lista de cookies»: cookies clasificadas por finalidad con duración y finalidad, botón «Gestionar mis cookies»

Apariencia

Se ofrecen seis disposiciones: banner ancho en la parte inferior, tarjeta en una de las cuatro esquinas o ventana central. Por defecto, «Rechazar todo» y «Aceptar todo» tienen la misma forma, el mismo tamaño y el mismo color; también hay disponible un estilo «contorno». El estilo que destaca «Aceptar todo» se ofrece con una advertencia, ya que la CNIL y el CEPD valoran estas diferencias caso por caso.

Los colores (botones, texto de los botones, fondo, texto) cuentan con paletas listas para usar y un control de contraste en directo, con un umbral de 4,5:1. La vista previa muestra el banner real, la ventana de preferencias o el botón flotante, en ancho de ordenador o móvil, en cada idioma, con los ajustes aún no guardados.

Apariencia del banner: disposición, botones, tema claro, oscuro o automático con control de contraste, vista previa en directo
Apariencia del banner: disposición, botones, tema claro, oscuro o automático con control de contraste, vista previa en directo

Tema e identidad: tema claro, oscuro o automático (según el ajuste del dispositivo del visitante) con sus propios colores, icono de cookie o logotipo de la tienda, posición del botón flotante, fuente del sistema o fuente del tema, y un campo de CSS personalizado que se añade después de la hoja de estilos del banner.

Ventana de preferencias en tema oscuro, aplicado automáticamente según el ajuste del dispositivo del visitante
Ventana de preferencias en tema oscuro, aplicado automáticamente según el ajuste del dispositivo del visitante

Textos e idiomas

Los textos del banner se proporcionan en francés, inglés, español, alemán, italiano, polaco, neerlandés y portugués. El mensaje propuesto por defecto cita únicamente las finalidades activadas en tu tienda, una línea por finalidad, y después recuerda que rechazar no impide navegar ni comprar.

La pestaña Textos permite sustituir cada texto idioma por idioma: título, mensaje, etiquetas de los botones y direcciones de las políticas de privacidad y de cookies. Un campo que se deja vacío utiliza el texto propuesto. En el mensaje, una línea que empieza por un guion se convierte en un elemento de lista. Una página CMS de la tienda también puede servir como política de privacidad en todos los idiomas.

La frase «rechazar no impide comprar» es exacta con el catálogo del módulo, en el que Stripe es estrictamente necesario. Si sometes un medio de pago a consentimiento, adapta el mensaje.

Textos del banner por idioma: título, mensaje y etiquetas de los botones, con vista previa en directo de la ventana de preferencias
Textos del banner por idioma: título, mensaje y etiquetas de los botones, con vista previa en directo de la ventana de preferencias

Comportamiento

  • Duración de conservación de la elección: 183 días por defecto (6 meses, duración que la CNIL presenta como una buena práctica), 365 días como máximo. Se aplica tanto a la aceptación como al rechazo.
  • Volver a solicitar el consentimiento a todos: tras un cambio importante, un botón hace que el banner vuelva a aparecer para todos los visitantes. En cualquier caso, un servicio añadido se propone a los visitantes que aún no lo hayan visto.
  • Retirada del consentimiento: botón flotante, enlace «Gestionar mis cookies» añadido automáticamente al pie de página, cualquier enlace a #tarteaucitron o llamada JavaScript dftacOpenPreferences(). Cuando se retira una aceptación, se borran las cookies del servicio y se recarga la página.
  • Cuenta de cliente: como opción, la elección de un cliente conectado se recupera en sus otros dispositivos. Figura en la exportación y la eliminación de datos del módulo RGPD oficial de PrestaShop (psgdpr), si está instalado.
  • Cruz de cierre: opcional, equivale a «Rechazar todo».
  • Banner oculto sin servicios sujetos a consentimiento: sin rastreadores que gestionar, el banner no es necesario. Desactiva esta opción si gestionas scripts fuera del módulo.
  • Global Privacy Control: opcional, un navegador que envía esta señal se trata como un rechazo.
Comportamiento: duración de conservación de la elección, retirada del consentimiento, visualización, elección memorizada con la cuenta de cliente
Comportamiento: duración de conservación de la elección, retirada del consentimiento, visualización, elección memorizada con la cuenta de cliente

Vídeos y mapas integrados: los iframes reconocidos (YouTube, Vimeo, Google Maps, Dailymotion, Spotify…) se sustituyen por un marcador «Permitir», accesible con el teclado. Solo se contacta con la plataforma después de la aceptación del visitante. Permitir un solo contenido desde su marcador no equivale a aceptar el resto de la categoría.

Vídeo de YouTube bloqueado antes del consentimiento: espacio reservado «Permitir YouTube» y enlace «Gestionar mis cookies»
Vídeo de YouTube bloqueado antes del consentimiento: espacio reservado «Permitir YouTube» y enlace «Gestionar mis cookies»

Lo que ve el visitante

La primera pantalla muestra el título, el mensaje, el enlace a la política de privacidad y los botones «Rechazar todo», «Aceptar todo» y «Personalizar». La ventana de preferencias enumera las finalidades con un interruptor para cada una (desmarcados por defecto), los servicios de cada categoría con sus cookies y su duración, y las cookies estrictamente necesarias, siempre activas. También muestra el identificador del consentimiento, que el visitante puede facilitarte.

Ventana de preferencias: elección por finalidad, servicios y cookies de cada categoría con su duración, enlace a la lista de cookies
Ventana de preferencias: elección por finalidad, servicios y cookies de cada categoría con su duración, enlace a la lista de cookies

En móvil, los botones conservan el mismo tamaño, cada finalidad cabe en una línea y el banner no desplaza la página.

Accesibilidad: casillas de verificación reales anunciadas como interruptores, ventana de preferencias que retiene el foco, cierre con la tecla Esc con devolución del foco y movimiento reducido si el visitante lo ha solicitado. axe-core (WCAG 2.1 A y AA) no ha detectado ninguna infracción en el banner, las preferencias, un contenido bloqueado y la lista de cookies, en tema claro y oscuro.

Banner de cookies en el móvil: botones «Rechazar todo» y «Aceptar todo» del mismo tamaño, enlace a la política de privacidad
Banner de cookies en el móvil: botones «Rechazar todo» y «Aceptar todo» del mismo tamaño, enlace a la política de privacidad

El módulo declara los valores por defecto al principio de la página, antes de cualquier etiqueta de Google: publicidad, medición y personalización en denied, funcionamiento y seguridad en granted (modificables). En cuanto el visitante elige, las señales se actualizan según las categorías aceptadas:

  • Medición de audiencia → analytics_storage;
  • Publicidad → ad_storage, ad_user_data, ad_personalization;
  • Vídeos, mapas y redes sociales → personalization_storage.

Para un visitante que ya ha respondido, la actualización se envía al principio de la página desde la siguiente visualización, sin esperar a la carga completa. Las opciones wait_for_update, ads_data_redaction y url_passthrough son configurables, y se envía un evento dftac_consent_update al dataLayer para tus activadores de Google Tag Manager.

Google Consent Mode v2: valores por defecto denegados, opciones y correspondencia con las categorías del banner
Google Consent Mode v2: valores por defecto denegados, opciones y correspondencia con las categorías del banner

Análisis de scripts de terceros

El botón Analizar mi tienda carga desde el servidor la página de inicio, una categoría, un producto, la página de contacto y hasta 8 páginas de tu elección, como un nuevo visitante sin cookies. El resultado enumera las etiquetas bloqueadas automáticamente, los scripts y contenidos de terceros que aún se cargan antes de la elección (con un botón Bloquear que crea la regla), las cookies instaladas por el servidor y los módulos instalados que se sabe que añaden sus propias etiquetas.

El análisis se vuelve a lanzar por sí solo al abrir el back office cuando tiene más de 30 días. Lee el código HTML enviado por la tienda: un script añadido después mediante JavaScript no se detecta.

Análisis de la tienda: etiquetas bloqueadas automáticamente, scripts aún cargados antes del consentimiento con botón «Bloquear», módulos con sus propias etiquetas
Análisis de la tienda: etiquetas bloqueadas automáticamente, scripts aún cargados antes del consentimiento con botón «Bloquear», módulos con sus propias etiquetas

Estadísticas y test A/B

La pestaña Estadísticas muestra las visualizaciones, las elecciones expresadas, los porcentajes de «Aceptar todo», «Rechazar todo» y de elecciones personalizadas, la aceptación por categoría, el reparto entre ordenador y móvil y la evolución diaria, en 7, 30 o 90 días, 12 meses o todo el historial, con exportación CSV. Los contadores se agregan por día, sin datos personales ni cookies. Una visualización se cuenta cuando el banner lo ve un visitante que interactúa con la página; se excluyen los robots.

El test A/B compara dos formulaciones o disposiciones. La variante se sortea en cada visualización, sin guardar nada en el dispositivo del visitante, y ambas variantes mantienen «Rechazar todo» al mismo nivel que «Aceptar todo». Solo se anuncia una ganadora a partir de 100 elecciones por variante y con una diferencia significativa al 95 %.

Estadísticas del banner: tasas de aceptación y rechazo, distribución por dispositivo, evolución en 30 días
Estadísticas del banner: tasas de aceptación y rechazo, distribución por dispositivo, evolución en 30 días

Prueba de los consentimientos

Cada elección se registra con su fecha, su identificador aleatorio (también conservado en la cookie del visitante), la acción, las categorías y los servicios aceptados, la versión del banner presentada y el origen de la elección (banner, preferencias, botón flotante, marcador de un contenido bloqueado). No se conserva ningún nombre, correo electrónico ni dirección IP en claro; como opción, está disponible una huella con sal de la dirección IP.

  • Búsqueda por identificador de consentimiento, exportación CSV.
  • Cada modificación de los textos, los servicios o los ajustes presentados crea una versión del banner con fecha y hora, descargable en formato JSON.
  • Purga automática una vez superada la duración de conservación elegida, sin tarea programada; también es posible la purga manual.
  • El registro se conserva si se desinstala el módulo.
Prueba de los consentimientos: registro fechado, búsqueda por identificador, exportación CSV y versiones sucesivas del banner
Prueba de los consentimientos: registro fechado, búsqueda por identificador, exportación CSV y versiones sucesivas del banner

Alojamiento y peso

Antes de cualquier elección, la página solo carga dos archivos del módulo, servidos por tu tienda: el script y la hoja de estilos del banner. tarteaucitron.js, su archivo de idioma y los archivos de los servicios solo se descargan después de una aceptación que los necesite; un visitante que rechaza no los descarga nunca. La opción «CDN jsDelivr» carga entonces los archivos oficiales desde jsDelivr, un tercero contactado en cuanto se acepta un servicio.

Medido en una página de inicio de PrestaShop 9.1.5 (tema Hummingbird): 2 archivos y 12 KB transferidos antes de cualquier elección. La versión 2.0.0 cargaba 5 archivos y 38 KB (medido en PrestaShop 8.2.1, tema Classic).

Multitienda

Los ajustes siguen el contexto de tienda elegido en el back office: selecciona una tienda para configurarla individualmente. El registro y las estadísticas se guardan por tienda.

Límites que conviene conocer

  • El módulo no es una plataforma de consentimiento registrada en IAB Europe (TCF) ni una CMP certificada por Google. Si muestras publicidad de AdSense, Ad Manager o AdMob en Europa, Google exige una CMP certificada.
  • El bloqueo automático y el análisis leen el código HTML de las páginas: no ven un script inyectado después por otro script.
  • El banner es el mismo sea cual sea el país del visitante.
  • Estas funciones ayudan a aplicar las buenas prácticas de la CNIL y del CEPD; no sustituyen el análisis jurídico de tu sitio (inventario de rastreadores, política de privacidad, contratos con tus socios).

Solución de problemas

  • El banner no se muestra: comprueba que el banner está activado (interruptor de la parte superior de la página), que al menos un servicio sujeto a consentimiento está listo, o desactiva la opción «No mostrar el banner sin servicios sujetos a consentimiento». Después, vacía la caché de PrestaShop.
  • Un servicio no se carga tras la aceptación: comprueba su distintivo en la pestaña Servicios. «Por completar» indica un identificador ausente o no válido.
  • Un script se carga antes de la elección: lanza el análisis y después utiliza el botón «Bloquear». Si el script no aparece, seguramente lo inyecta otro script: desactívalo en el módulo que lo añade.
  • Una herramienta deja de funcionar tras activar el bloqueo: añade su dirección a las excepciones de la pestaña Bloqueo, o declárala como servicio para que se cargue tras la aceptación.
  • El banner vuelve a aparecer en cada página: comprueba el dominio de la cookie y que el nombre de la cookie no se haya modificado entretanto.
  • No hay entradas en el registro: comprueba que el registro está activado en la pestaña Prueba y luego haz una elección en navegación privada.

¿Necesitas ayuda? Contacta con el soporte de DataFireFly desde tu área de cliente; respuesta en 24 h laborables.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte