Marketing Revolution: configuración y ayuda

Sube el ZIP de la versión mediante Módulos > "Module Manager" > "Upload a module" e instálalo. Abre "Marketing > Panel de control". Usa "Marketing > Plataformas" para configurar los destinos y "Marketing > Configuración" para los controles compartidos.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

Empieza con un destino. Decide si GA4 funcionará directamente o a través de tu contenedor GTM. Si ambas rutas envían a la misma propiedad, configúralas con cuidado para evitar eventos duplicados. Revisa también los demás módulos de seguimiento y etiquetas instalados.

Asigna a los empleados los permisos de visualización y edición adecuados para los controladores del módulo. Los guardados y las acciones de las plataformas requieren permiso de edición y un token de administrador válido.

"Configuración"

Usa un identificador coherente en el feed del catálogo y los eventos. La extracción compartida incluye nombre del artículo, marca, jerarquía de categorías, descripción de la combinación, precio y cantidad, cuando están disponibles. La extracción de pedidos añade moneda, impuestos, envío, cupones e identificadores del pedido.

"Seguimiento"

El registro muestra las compras que ha guardado tu tienda. Para ver qué conversiones ha aceptado cada plataforma, consulta sus propios informes.

"Consentimiento"

Configura un proveedor de consentimiento compatible que recoja la elección del visitante. El módulo funciona con MPR Cookies Revolution y las integraciones compatibles de Cookiebot, OneTrust y TCF. Los valores predeterminados de Consent Mode no recogen el consentimiento. Cada plataforma aplica también sus propios requisitos de consentimiento.

"Automatización"

No hay ajustes editables en "Automatización". "Reenviar compras omitidas", "Periodo de reenvío" y "Data Language" no están disponibles. Configura la recuperación y la entrega por servidor en los formularios individuales de las plataformas que aparecen a continuación.

Abre "Marketing > Plataformas", elige la plataforma y abre su configuración. La mayoría de los formularios tienen un interruptor "Activado", inicialmente desactivado. Guarda el ID del destino antes de activarlo.

Google Tag Manager

Introduce "GTM Container ID", como GTM-XXXXXXX. El ID está inicialmente vacío. El módulo proporciona envíos ecommerce a dataLayer; aún debes configurar y publicar las etiquetas y los activadores dentro del contenedor.

"Track Contact Signals" y "Track Product Engagement" están inicialmente desactivados. "Exclude Employee Browsers" también empieza desactivado en esta suite. Actívalo si quieres excluir las visitas del personal.

Para los contactos y la interacción con productos, prueba los controles correspondientes antes de activarlos de forma general. Un contenedor GTM puede generar su propia visita de página. El módulo no envía a GTM un evento genérico page_view independiente para cada página.

Google Analytics GA4

Para la recuperación, guarda el secreto de API y activa "Recover Missing GA4 Purchases". Se requiere la integración de consentimiento MPR Cookies Revolution. La recuperación considera las compras registradas después de activar la función cuando el cliente no llegó a la página de confirmación del pedido. Los pedidos anteriores a la activación quedan excluidos. La falta de identidad del comprador, consentimiento o destino coincidente retiene la entrega.

Controles de Google para la interacción con productos

GTM y GA4 ofrecen estos controles en sus respectivos formularios:

Prueba los selectores en tu tema real. Estos controles registran interacciones observadas; no acreditan una compra ni requieren una etiqueta de conversión publicitaria.

Introduce "Google Ads Conversion ID", como AW-123456789, y activa la plataforma. Todas las etiquetas están inicialmente vacías. Rellena únicamente las acciones de conversión que quieras:

Una etiqueta vacía desactiva esa conversión. La plataforma también tiene "Track Contact Signals" y "Exclude Employee Browsers", ambos inicialmente desactivados. Las conversiones de contacto usan "Phone Click Conversion Label", "Chat Start Conversion Label" y "Confirmed Contact Form Conversion Label", cada una inicialmente vacía. Usa la etiqueta de la acción prevista.

Correcciones opcionales de reembolsos

"Correct Refunded Google Ads Conversions" está inicialmente desactivado. Configura estos campos antes de activarlo:

El archivo OAuth debe contener el ID de cliente, el secreto de cliente y el token de actualización. Guarda los campos y revisa la preparación antes de activar las correcciones. Solo se pueden corregir las compras enviadas desde el navegador después de la configuración; las conversiones anteriores no se tocan. La tarea de corrección solo se ejecuta cuando la lanza tu programador cron.

Abre "Meta Pixel" e introduce "Pixel ID", inicialmente vacío. "Enable Facebook Pixel" está inicialmente desactivado. En esta suite, "Exclude employees" está desactivado por defecto. "Respect cookie consent" está inicialmente activado. "Persist marketing consent withdrawals" está inicialmente desactivado.

Los interruptores estándar "Track ViewContent", "Track AddToCart", "Track InitiateCheckout", "Track Purchase", "Track Search", "Track AddToWishlist" y "Track CompleteRegistration" están inicialmente activados. Desactiva los eventos que no use tu configuración. Los eventos de lista de deseos y registro necesitan una acción completada compatible.

"Track custom events" está inicialmente desactivado. "Custom event rules" está inicialmente vacío y acepta las reglas de activación JSON documentadas. Configura y prueba una regla antes de activarla.

"Enable Conversions API purchase events" está inicialmente desactivado en una instalación nueva. Añade "Conversions API access token" antes de activarlo. El campo del token conserva un token guardado si lo dejas vacío. "Código de evento de prueba" está inicialmente vacío. "Graph API version" empieza en v25.0.

Esta es la entrega de compras por servidor junto al Pixel del navegador, con una identidad de evento compartida para la deduplicación. No se limita a un reenvío cada hora de compras perdidas. Revisa el panel de conexión, la cola del proveedor y los diagnósticos de Meta. Borra cualquier código de prueba temporal antes del uso en producción.

El módulo también admite estos destinos. Sus credenciales están inicialmente vacías y sus interruptores principales desactivados. Usa el formulario de la red que realmente utilices.

Eventos, privacidad y reglas personalizadas

Cada proveedor asigna los eventos compartidos a su API compatible. Revisa sus interruptores de eventos individualmente. Cada plataforma publicitaria recibe solo los eventos que admite.

Donde se ofrecen, "Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" y "Track product engagement" están inicialmente desactivados. Cualquier campo correspondiente "Phone target", "Chat target", "Form target" o "Engagement target" está inicialmente vacío. Introduce el destino exacto proporcionado por la cuenta cuando el formulario lo requiera. Los destinos no se deducen del Pixel ID.

"Send confirmed forms through the server API" está inicialmente desactivado donde es compatible. Un formulario solo cuenta cuando el servidor indica un envío correcto; hacer clic en "Submit" no basta. Los clics telefónicos y los inicios reales de chat son señales independientes. "Product engagement thresholds" usa los valores compartidos predeterminados de 3 visualizaciones de galería, 1 cambio de combinación, 1 clic en detalles, 45 segundos y 1500 milisegundos. Cambia su JSON únicamente para ajustarlo a los umbrales previstos y los selectores del tema.

"Custom event rules" está inicialmente vacío y el seguimiento personalizado, donde existe, está desactivado. Las reglas pueden seleccionar clics, URL, controladores o eventos DOM compatibles. Las restricciones del proveedor siguen aplicándose. Criteo, por ejemplo, asigna a su vocabulario OneTag compatible en lugar de aceptar nombres de eventos nuevos arbitrarios.

Revisa la exclusión de empleados por separado en cada plataforma. No hay un único interruptor universal activado por defecto. Esta suite conserva valores predeterminados desactivados para la exclusión de empleados de Google, Meta, TikTok, Snapchat, Reddit y AdRoll. Las comprobaciones de consentimiento, host de salida y responsabilidad siguen aplicándose de forma independiente.

Entrega opcional por servidor

La entrega por servidor se configura por plataforma y está inicialmente desactivada para las siguientes rutas opcionales. Introduce las credenciales requeridas y revisa los ajustes de consentimiento de la plataforma antes de activarla.

Para Pinterest, "Include tax in purchase value", "Include shipping in purchase value" y "Subtract discounts from purchase value" están todos inicialmente desactivados. Revisa estos valores específicos del proveedor en lugar de suponer que el ajuste general de precios determina el total de la compra.

Los botones de prueba de los proveedores tienen comportamientos diferentes. Un botón llamado "Check test availability" o "Check test requirements" puede devolver indicaciones sin enviar ningún evento. Usa la ruta de prueba documentada del proveedor y los identificadores de prueba requeridos. Una acción de reintento devuelve las filas fallidas elegibles al procesamiento; no soluciona credenciales ausentes ni la falta de consentimiento original.

Abre "ChatGPT Ads (OpenAI)". Tanto el interruptor global "Activar seguimiento" como "Tracking enabled" de este formulario deben estar activados para este destino.

Obtén el Pixel ID y la clave de Conversions API para la fuente de datos prevista. La clave API es independiente de una clave Advertiser API. Cuando el consentimiento es obligatorio, la entrega por servidor necesita la autorización adecuada de almacenamiento publicitario; el navegador también necesita la señal de datos de usuario. La retirada del consentimiento impide el envío de los eventos que siguen pendientes en la cola.

El navegador y el servidor usan una identidad de compra compartida para facilitar la deduplicación en la plataforma de destino. La plataforma de destino gestiona los informes y la atribución de compras. Los eventos fallidos en espera caducan tras 6 días y 22 horas en la cola incluida.

"Check test-mode availability" no envía eventos ni valida una compra de ejemplo. "Retry failed events" vuelve a poner en cola los eventos fallidos elegibles de la tienda y el Pixel ID seleccionados.

Desactivar "Pixel del navegador" deja la entrega por servidor controlada por separado. Para una configuración solo de compras, deja "Purchases" activado y desactiva los demás eventos comerciales. Los ID de producto y combinación usan valores como 42-7; los productos sin combinación conservan su ID de producto.

Los interruptores opcionales de contacto e interacción descritos anteriormente también empiezan desactivados aquí. Si el módulo independiente Pixel for ChatGPT Ads usa el mismo destino, la responsabilidad coordinada decide qué módulo emite y procesa la cola compartida. Revisa el estado de responsabilidad antes de diagnosticar duplicados.

Abre su formulario de plataforma y establece:

Prueba la insignia y la aceptación de la encuesta en una confirmación de pedido elegible. Tu cuenta de Merchant Center debe admitir Reseñas de Clientes de Google; eso lo decide Google, no los ajustes del módulo.

Estos ajustes permiten herencia global, por grupo de tiendas y por tienda. "Use inherited settings" elimina las anulaciones locales de esta plataforma. La mayoría de los demás ajustes del módulo se comparten entre tiendas. Seleccionar una tienda no crea por sí solo credenciales independientes de GA4, Meta u OpenAI.

Conecta la infraestructura cron instalada con una ejecución externa regular. El módulo registra estos identificadores de tarea:

Usa el ejecutor autenticado o el comando del programador instalado para esta tienda. No expongas un endpoint de escritura sin autenticación. Los workers principales de servidor no se ejecutan con el tráfico de visitantes. Una tarea solo se ejecuta si tu alojamiento llama de verdad al programador, así que compruébalo.

La tienda recibe scripts de seguimiento en lugar de un nuevo widget visible, salvo la insignia de reseñas y la encuesta opcionales. La integración normal usa displayHeader, displayBeforeBodyClosingTag, displayOrderConfirmation, displayAfterBodyOpeningTag y hooks de medios, además de acciones de carrito/cuenta/pedido y la ruta de pie de página heredada.

La recogida compartida cubre visitas de página y producto, listados y búsquedas compatibles, visitas al carrito, inicios del proceso de compra, registros e inicios de sesión. El seguimiento del navegador proporciona adiciones confirmadas al carrito y adiciones correctas a listas de deseos compatibles. Comprueba por separado las señales de pasos de compra y otras interacciones; no supongas que se recogen automáticamente. Cada proveedor aplica sus propias asignaciones y condiciones compatibles.

1. Configura una plataforma con el interruptor global aún desactivado.
2. Comprueba sus credenciales requeridas y la integración del consentimiento.
3. Activa la plataforma y "Activar seguimiento", y después navega como un cliente.
4. Verifica los ID de producto, los precios, la moneda y las categorías en las solicitudes del navegador o la vista previa de GTM.
5. Añade y elimina un producto. Comprueba el evento confirmado y su cantidad.
6. Completa la compra e inspecciona el destino, el valor, la moneda, los artículos y el identificador de transacción.
7. Comprueba "Registro de seguimiento", el estado/las colas del proveedor y los diagnósticos remotos por separado.
8. Prueba la denegación, la retirada del consentimiento y tu ruta de servidor programada, si está activada. Después desactiva "Modo depuración".

No hay seguimiento: comprueba ambos interruptores, credenciales requeridas, consentimiento, estado de empleado/tráfico interno, reglas de host de salida y avisos de responsabilidad. El seguimiento se retiene en rutas de staging/clon no compatibles.

Faltan compras: para la entrega por navegador, comprueba que tu proceso de compra muestra la página normal de confirmación de pedido, que ejecuta el hook de confirmación. Para una ruta API activada, revisa la cola del servidor y el estado del programador. Los bloqueadores del navegador, la denegación del consentimiento y las caídas de las plataformas pueden seguir impidiendo el seguimiento.

Eventos duplicados: revisa el responsable coordinado, los módulos independientes antiguos, las etiquetas incluidas directamente en el tema y las publicadas en GTM. Las integraciones nativas ps_facebook o ps_googleanalytics con el mismo destino aún pueden emitir etiquetas duplicadas y cuentan con advertencias explícitas.

El registro de compras indica una observación: esto registra la observación de la confirmación del pedido y la lista de plataformas activas. No es un acuse de recibo de la plataforma externa.

Datos de búsqueda o cliente inesperados: el módulo limpia los términos que contienen datos de correo electrónico o teléfono y aplica comprobaciones de consentimiento para la coincidencia. Inspecciona los payloads reales de tu configuración en lugar de suponer que se incluyen todos los datos.

Para las tarjetas de producto personalizadas, mantén la identidad del producto disponible para el seguimiento compatible. El patrón original es:

<article class="product-miniature" data-id-product="123" data-list-name="Category page">
  <h3 class="product-title"><a href="/example-product">Example product</a></h3>
  <span class="price" content="49.99">49.99</span>
</article>

Después de cambiar el marcado, prueba los clics y adiciones reales al carrito: el evento de carrito solo se envía cuando un producto se añade de verdad, así que no basta con que el selector coincida.

Los datos de compra de GTM usan un objeto ecommerce. Por ejemplo, un contenedor configurado puede recibir:

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: '123',
    value: 99.99,
    tax: 16.67,
    shipping: 4.99,
    currency: 'EUR',
    items: [{
      item_id: 'SKU-001', item_name: 'Example product',
      item_brand: 'Example brand', item_category: 'Category',
      item_category2: 'Subcategory', price: 99.99, quantity: 1
    }]
  }
});

Esto ilustra la estructura de los datos. No pegues un segundo emisor de compras en el tema. Configura el contenedor para consumir la salida existente del módulo.

Desactiva "Activar seguimiento" para detener el seguimiento. Los eventos que ya están en cola y las retiradas de consentimiento se procesan según su propia programación. Haz una copia de cualquier registro o configuración que necesites antes de desinstalar.

Desinstala mediante "Module Manager". El módulo elimina su menú, tareas registradas, sus propias tablas de base de datos, configuración y responsabilidad sobre colas/atribución a través de los paquetes compartidos. Las tablas compartidas siguen las reglas de limpieza de su paquete. Los eventos ya comunicados de forma remota no se borran al desinstalar el módulo.