Taboola Pixel + S2S Postback: configuración y ayuda

1. Sube e instala el ZIP en Módulos > "Module Manager" y abre Taboola Pixel + S2S Postback > "Configure".
2. Introduce ID de cuenta de Taboola en Configuración de Taboola Pixel.
3. Revisa los interruptores de eventos y ajusta Nombre del evento de compra y los demás campos de nombres de eventos a la cuenta.
4. Establece "Enable Taboola Pixel" en Sí y haz clic en Guardar.
5. Concede el consentimiento de marketing en un navegador de visitante y abre un producto.
6. Comprueba que se carga tfa.js y se emite el evento de visualización de producto configurado.
7. Para las compras opcionales del servidor, activa "Capture purchase consent evidence" y "Enable S2S postback events". Después haz un pedido de prueba desde un clic en un anuncio de Taboola (con ID de clic tblci) aceptando el seguimiento y comprueba que el pedido entra en la cola y que el programador lo envía.

Abre Módulos > "Module Manager" > Taboola Pixel + S2S Postback > "Configure".

• "Enable Taboola Pixel". Interruptor principal del seguimiento en el navegador; valor predeterminado: 0.

• ID de cuenta de Taboola. ID numérico de la cuenta de Taboola de Realize > "Tracking"; valor predeterminado: "".

• "Exclude employees". Detiene el seguimiento mientras un empleado conectado al back office navega por la tienda; valor predeterminado: 1.

• "Respect cookie consent". Espera el consentimiento de marketing de mprcookiesrevolution o mprcookiebanner cuando uno de estos módulos está activo; valor predeterminado: 1.

• "Track PageView". Envía el evento estándar page_view en las páginas con seguimiento; valor predeterminado: 1.

• "Track View Content". Envía el evento de visualización de producto en las páginas de producto; valor predeterminado: 1.

• "Track View Category". Envía el evento de visualización de categoría o colección cuando detecta una categoría actual; valor predeterminado: 1.

• "Track Add To Cart". Envía eventos del navegador de adición al carrito tras adiciones correctas confirmadas; valor predeterminado: 1.

• "Track Checkout". Envía el evento de inicio del proceso de compra cuando el módulo detecta su página inicial y el carrito contiene productos; valor predeterminado: 1.

• "Track Purchase". Envía eventos de compra desde la confirmación y validación del pedido; valor predeterminado: 1.

• "Track Search". Envía eventos de búsqueda en la página de búsqueda cuando hay un término; valor predeterminado: 1.

• "Track Add To Wishlist". Envía eventos de lista de deseos tras adiciones correctas confirmadas; valor predeterminado: 1.

• "Track Sign Up". Envía un evento de registro después de crear una cuenta de cliente nueva; valor predeterminado: 1.

• Nombre del evento de compra. Nombre de evento de Taboola usado para compras y postbacks S2S de compras; valor predeterminado: make_purchase.

• "Product view event name". Nombre de evento de Taboola usado para visualizaciones de productos; valor predeterminado: product_view.

• "Collection/category view event name". Nombre de evento de Taboola usado para visualizaciones de categorías; valor predeterminado: collection_view.

• "Add to cart event name". Nombre de evento de Taboola usado para adiciones al carrito; valor predeterminado: add_to_cart.

• "Start checkout event name". Nombre de evento de Taboola usado para inicios del proceso de compra; valor predeterminado: start_checkout.

• "Search submitted event name". Nombre de evento de Taboola usado para búsquedas; valor predeterminado: search_submitted.

• "Wishlist event name". Nombre de evento de Taboola usado para adiciones a la lista de deseos; valor predeterminado: add_to_wish_list.

• "Registration event name". Nombre de evento de Taboola usado para registros de cuentas nuevas; valor predeterminado: complete_registration.

• "Track custom events". Activa reglas JSON personalizadas del navegador; se retienen los eventos del servidor enviados desde el navegador; valor predeterminado: 0.

• Reglas de eventos personalizados. Array JSON de reglas de eventos personalizados para los activadores click, url, controller o event; valor predeterminado: "".

• "Enable S2S postback events". Envía las compras desde el servidor para compradores que llegaron desde un clic de Taboola (tblci) y cuyo consentimiento se guardó al finalizar la compra; valor predeterminado: 0.

• "Test tblci". Valor conservado por compatibilidad; la sonda actual rechaza el envío; valor predeterminado: "".

• "Queue batch limit". Número máximo de eventos de conversión de Taboola en cola procesados por ejecución, intervalo admitido de 1 a 1000; valor predeterminado: 20.

• "Capture purchase consent evidence". Valor predeterminado: 0. Activa esta opción antes de probar compras del servidor. Guarda el consentimiento del comprador al hacer el pedido; las compras del servidor también necesitan un banner de consentimiento cuya elección guardada pueda leer el módulo, por ejemplo Cookies Revolution.

Haz clic en Guardar. Usa un ID de cuenta numérico distinto de cero de hasta 32 dígitos. Los nombres de eventos deben coincidir exactamente con la cuenta y tener de 1 a 100 letras, números o guiones bajos. Los nombres no válidos no se reescriben automáticamente. Cambia los campos de nombres de eventos integrados solo cuando la cuenta use el nombre de sustitución.

El formulario actual también ofrece estos ajustes. Todos los interruptores de señales tienen No como valor predeterminado. Activa solo las acciones que quieras observar.

Los umbrales compartidos son tres vistas de galería, un cambio de variante, un clic en detalles, una permanencia de 45 segundos y un intervalo mínimo de 1500 ms para las opciones. Los recuentos de galería, variantes y detalles están limitados de 1 a 20. La permanencia está limitada de 5 a 600 segundos. El intervalo está limitado de 250 a 60000 ms. Por ejemplo:

{"min_gallery_views":3,"min_variant_changes":1,"min_detail_clicks":1,"dwell_seconds":45,"option_throttle_ms":1500}

También puedes proporcionar gallery_selectors, variant_selectors y detail_selectors. Mantén los valores predeterminados salvo que tu tema necesite otros selectores. Estas señales opcionales requieren comprobaciones de consentimiento, política de empleados y titularidad del seguimiento, igual que los eventos comerciales.

Mantén activados los ajustes de consentimiento y exclusión de empleados durante la configuración inicial. Prueba desde un navegador de visitante normal que no esté marcado como empleado. Una sesión iniciada en el back office, una regla de tráfico interno o la exclusión voluntaria del visitante pueden impedir el seguimiento.

La capa de consentimiento compartida admite integraciones de consentimiento MPR y adaptadores CMP adicionales. Debe obtener una decisión de marketing utilizable para el destino. Una decisión desconocida, obsoleta o negativa puede retener eventos. El módulo no proporciona un banner de cookies. Una preferencia de consentimiento antigua no anula una negativa actual de una CMP detectada.

El módulo debe ser titular del destino configurado en el coordinador de seguimiento compartido. Una titularidad ausente, ambigua o en conflicto puede retener el envío desde el navegador y el servidor. Elimina las etiquetas duplicadas del tema o resuelve la titularidad cuando otro módulo MPR gestione la misma cuenta.

El envío en producción también sigue la política de salida. Un evento que se ve en la demo o la vista previa no llega necesariamente a tu cuenta publicitaria. Las compras y los eventos de formularios del servidor solo se envían con el consentimiento que el comprador dio en ese momento; una ejecución cron posterior no puede sustituirlo.

El módulo prepara la configuración mediante displayHeader. El entorno de ejecución carga https://cdn.taboola.com/libtrc/unip/ACCOUNT_ID/tfa.js tras superar las comprobaciones y envía los eventos del navegador activados. No obtienes un widget normal en la tienda.

Las visitas a páginas usan page_view. Los eventos de producto, categoría, adición confirmada al carrito, inicio de compra, compra, búsqueda, adición confirmada a la lista de deseos y registro usan los nombres guardados. Las compras pueden incluir ingresos del pedido, moneda, cantidad, referencia y contexto del producto. El registro se marca en actionCustomerAccountAdd y se consume en una solicitud posterior apta de la sesión nativa.

Para la atribución del servidor, usa URL de destino de campañas que contengan un único tblci real, por ejemplo:

https://www.example.com/product-name?tblci=REAL_TABOOLA_CLICK_ID

La captura actual del navegador acepta tblci; no captura el antiguo alias de URL taboola_click_id. Tras superar el consentimiento y los demás controles, guarda mprtbpx_tblci durante 30 días con la ruta de cookie configurada, SameSite=Lax y Secure en HTTPS. Una negativa de consentimiento borra las cookies de atribución compatibles del entorno de ejecución.

Activa "Track custom events", introduce un array JSON en Reglas de eventos personalizados y guarda. Usa los nombres exactos de eventos de la cuenta con entre 1 y 100 letras, números o guiones bajos. Estos ejemplos incluyen activadores de clic, URL, controlador y evento DOM. Las reglas de controlador pueden restringir un módulo frontal con modules.

[
  {
    "event": "gallery_browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "once": false
  },
  {
    "event": "landing_page_view",
    "trigger": "url",
    "contains": [
      "/sale"
    ]
  },
  {
    "event": "contact_page_view",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "modules": []
  },
  {
    "event": "lead",
    "trigger": "event",
    "dom_event": "mprtbpx:custom"
  }
]

Activa la regla DOM después de la inicialización:

document.dispatchEvent(new CustomEvent('mprtbpx:custom'));

Las reglas de URL examinan la ruta. Los fragmentos de consulta como utm_campaign=taboola no coinciden con rutas. once limita los activadores repetidos de clic o DOM en la ejecución actual.

Las reglas personalizadas envían el nombre del evento configurado. No copian atributos de datos de clic ni detail.params del DOM. Los eventos personalizados llegan a Taboola solo desde el navegador: el módulo rechaza los eventos enviados desde el navegador para el envío del servidor, así que s2s: true en una regla personalizada no envía ningún postback del servidor.

Activa "Enable S2S postback events" y "Capture purchase consent evidence" cuando tu tienda tenga un banner de consentimiento que el módulo pueda leer y los visitantes lleguen con ID de clic de Taboola. Mantén "Track Purchase" activado y ajusta Nombre del evento de compra a tu cuenta de Taboola.

Al validar el pedido, el módulo guarda el consentimiento y el ID de clic del comprador y añade la compra a la cola. Una compra del servidor solo se envía si el comprador dio su consentimiento, no es un empleado, este módulo gestiona el seguimiento de Taboola y se capturó un tblci real. Las filas antiguas enviadas desde el navegador permanecen retenidas.

Cuando una compra se acepta en la cola del servidor, el módulo bloquea también su evento de compra en el navegador para evitar enviarla dos veces. Si la compra no puede entrar en la cola del servidor, su evento del navegador puede enviarse cuando lo permitan el consentimiento y las demás condiciones de seguimiento.

La tarea send_taboola_conversions está registrada con la programación every:300. Vence cada cinco minutos. Tu ejecutor cron MPR compartido debe ejecutar las tareas pendientes; la declaración de la programación por sí sola no ejecuta un proceso de trabajo. El límite de lote restringe las filas de cola por ejecución de 1 a 1000, con un valor predeterminado de 20.

El módulo no dispone de un punto de entrada independiente cron.php. Usa el planificador compartido ya configurado para tu tienda. Comprueba la ejecución de tareas en ese planificador y las fechas y el estado de la cola en la página de configuración de este módulo.

Los diagnósticos incluyen comprobaciones de preparación, contadores de cola, filas recientes, Enviar prueba S2S y Reintentar eventos fallidos. Resuelve la causa del fallo antes de reintentar. Devolver las filas fallidas al estado pendiente no evita las comprobaciones actuales de consentimiento, política de empleados, titularidad de la cuenta o destino.

Enviar prueba S2S no envía nada, porque Taboola no ofrece un modo de prueba que deje las conversiones de prueba fuera de tus informes. "Test tblci" se mantiene por compatibilidad y no genera ninguna conversión de prueba. Para comprobar el envío, mira la respuesta de la cola para una compra real procedente de un clic de Taboola.

1. Comprueba la configuración requerida, la integridad, la preparación, la titularidad y el programador compartido.
2. En un navegador de visitante normal, concede el consentimiento de marketing y abre un producto. Confirma tfa.js y el evento de visualización de producto configurado.
3. Añade un producto correctamente al carrito y confirma el evento de adición. Un clic en un botón no es suficiente.
4. Para S2S, activa la captura del consentimiento y después haz una compra desde un clic en un anuncio de Taboola. Comprueba el tblci original, el consentimiento guardado y la fila del pedido en la cola.
5. Deja que el programador procese la fila. Examina el resultado final y el evento en los informes de Taboola. Comprueba que el mismo pedido no se envió por ambos transportes.

Si no aparece ningún script del navegador, comprueba la activación, el ID de cuenta, el consentimiento, las marcas de empleado, la titularidad, las etiquetas duplicadas y los bloqueos del navegador. Si se retiene una compra del servidor, comprueba "Capture purchase consent evidence", el banner de consentimiento, el ID de clic, la identidad del comprador y el motivo registrado. Si fallan las reglas personalizadas, comprueba los nombres exactos, los selectores y la coincidencia de ruta. La antigua función global window.mprtbpxTrack no está disponible.

Desactiva los interruptores del navegador y del servidor y guarda para detener el seguimiento y conservar la configuración. Desinstala desde "Module Manager" para eliminar los ajustes del módulo, las entradas de menú y las tareas registradas.

La desinstalación ejecuta la limpieza compartida de la cola de conversiones. La tabla compartida se conserva mientras otro módulo de conversión la use y puede eliminarse al retirar su último usuario. Exporta los diagnósticos que necesites antes de desinstalar. No supongas que la desinstalación elimina los eventos ya enviados a la plataforma publicitaria ni borra todos los datos de atribución del navegador.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.