PrestaShop

Módulo CookiePilot para PrestaShop con Consent Mode v2

Sube un único ZIP en el Module Manager, conecta el dominio de tu tienda y el módulo sirve el banner de consentimiento desde el head de cada página de la tienda. El módulo es compatible con PrestaShop 8.x y 9.x.

Requisitos y versiones compatibles

  • El módulo es compatible con PrestaShop 8.x y 9.x.
  • Acceso al back office con permiso para instalar módulos.
  • Una cuenta de CookiePilot. Puedes registrarte, verificar tu correo electrónico e iniciar sesión directamente dentro del módulo.
  • El ZIP del módulo, versión 1.0.0, descargado desde el enlace de abajo. No lo descomprimas.

Descarga el módulo

Descarga el ZIP oficial de instalación de CookiePilot, guárdalo y súbelo a PrestaShop sin descomprimirlo.

Descargar el ZIP

Instala el ZIP en el Module Manager

  1. 1.En el back office abre Módulos, luego Module Manager, y haz clic en Subir un módulo.
  2. 2.Arrastra el ZIP descargado al cuadro de subida. PrestaShop lo instala y lo muestra en la lista como CookiePilot CMP.
  3. 3.Haz clic en Configurar en la entrada CookiePilot CMP para abrir la página de configuración del módulo.
  4. 4.Si la subida es rechazada, comprueba que tu tienda usa PrestaShop 8.x o 9.x y que el ZIP es el archivo original sin modificar.

Regístrate, verifica tu correo y conecta la tienda

  1. 1.En la página de configuración crea una cuenta de CookiePilot o inicia sesión en una existente. El registro solo pide una dirección de correo electrónico y una contraseña.
  2. 2.Confirma el correo de verificación, vuelve al PrestaShop Back Office, reabre la configuración de CookiePilot CMP e inicia sesión con la cuenta verificada si hace falta.
  3. 3.Conecta la tienda: el módulo crea el dominio en tu cuenta de CookiePilot automáticamente, o se reconecta a un dominio existente con el mismo nombre de host.
  4. 4.El panel Shop connection muestra entonces el dominio conectado, la cuenta y el plan actual, con el estado CONNECTED.

Dónde se inyecta el script

  1. 1.El módulo inserta un script de CookiePilot en el head de cada página de la tienda y usa un hook temprano del módulo. Los scripts insertados antes directamente en el tema aún pueden ejecutarse primero, así que configúralos para que el autoblocking de CookiePilot los bloquee o para que esperen el consentimiento en GTM.
  2. 2.Si en tu tema o en un contenedor de etiquetas ya existe un snippet de CookiePilot pegado a mano u otro banner de consentimiento, elimínalo. Dos capas de consentimiento en una misma página compiten por el estado de consentimiento y corrompen la medición.
  3. 3.El panel Storefront status tiene un único interruptor, Enable CookiePilot banner and Consent Mode, así que puedes comprobar en cualquier momento si el script se está sirviendo.

Mapeo de Consent Mode v2

  1. 1.El módulo establece los valores por defecto de Google Consent Mode v2 en denied antes de que el visitante tome cualquier decisión. El almacenamiento de analítica y de marketing permanece en denied hasta que existe consentimiento.
  2. 2.Accept All concede todas las categorías. Reject All mantiene todas las categorías en denied. El consentimiento granular concede exactamente las categorías que el visitante seleccionó en la vista de configuración.
  3. 3.Los scripts opcionales estáticos y dinámicos registrados en el módulo se bloquean y se liberan según esas mismas categorías, de modo que un script solo se ejecuta cuando su categoría está concedida.

Comportamiento en multitienda

  1. 1.En una instalación multitienda la configuración se guarda por tienda. Cada tienda conecta su propio dominio y conserva sus propias claves.
  2. 2.Una tienda recién creada no hereda las claves de la tienda propietaria. Abre la configuración del módulo en el contexto de cada tienda y conéctala por separado.

Pruebas de trackers en cinco estados

Ejecuta cada estado en una sesión privada nueva y mantén abierta la pestaña Network. Estos cinco estados son la prueba de aceptación con la que se verifica el propio módulo.

Antes del consentimiento: con el banner todavía abierto, la pestaña Network no muestra peticiones de analítica ni de marketing y no se escriben cookies de seguimiento.
Solo analítica: concede únicamente analítica en la vista granular. Las peticiones de analítica arrancan y las peticiones y cookies de marketing siguen ausentes.
Solo marketing: concede únicamente marketing. Las etiquetas de marketing pueden dispararse mientras el almacenamiento de analítica sigue en denied.
Accept All: después de aceptar todos los consentimientos, las herramientas de analítica y marketing pueden ejecutarse según la configuración de la tienda.
Reject All: la tienda sigue funcionando, incluidos el carrito y el checkout, y los trackers permanecen en silencio incluso tras recargar la página.

Meta Pixel y TikTok Pixel no leen Consent Mode, así que Consent Mode v2 por sí solo no los detiene. Deben quedar cubiertos por el autoblocking del módulo o dispararse mediante event gating solo después del consentimiento de marketing.

Desactivar, desinstalar, reinstalar

Desactivar el módulo elimina el script de CookiePilot de la tienda. El dominio en tu cuenta de CookiePilot queda intacto.

Desinstalar elimina los secretos locales y los hooks de la base de datos de la tienda. No borra el dominio remoto ni las evidencias de consentimiento almacenadas.

Reinstalar el módulo y reconectar el mismo dominio funciona: el módulo se vincula de nuevo al dominio existente en lugar de crear un duplicado.

Resolución de problemas

El banner no aparece tras la instalación

Vacía la caché de PrestaShop en Parámetros avanzados, Rendimiento, y purga tu CDN si usas uno. El HTML en caché sigue sirviendo páginas generadas antes de activar el módulo.

Dos banners o un estado de consentimiento contradictorio

Elimina cualquier snippet de consentimiento pegado a mano en el tema, en herramientas del hosting y en contenedores de etiquetas. Solo puede ejecutarse una capa de consentimiento, y el módulo ya la inyecta una vez.

Los trackers se disparan antes que el banner

Un tema u otro módulo con GA4, Meta o TikTok incrustados en el código puede cargarse fuera de la capa de consentimiento. Configura el bloqueo automático de CookiePilot para bloquear o cubrir esas etiquetas, o configúralas en GTM para que se ejecuten solo después del consentimiento requerido.

Configuraciones con Google Tag Manager

Mantén el módulo como única fuente de consentimiento. Condiciona cada etiqueta de GTM al estado de consentimiento correspondiente o dispárala tras el consent update, y nunca pegues un segundo loader de CookiePilot en el contenedor.

Siguen apareciendo peticiones de Meta o TikTok

Estos píxeles ignoran Consent Mode. Confirma que están cubiertos por el autoblocking o por event gating; un píxel incrustado a mano en el tema sigue disparándose hasta que se mueve detrás del consentimiento de marketing.

Instala el módulo y prueba tu tienda

Descarga el ZIP, conecta tu dominio y recorre los cinco estados de trackers en una sesión limpia. Toda la configuración se hace en el back office.