Taboola Pixel + S2S Postback — Documentación

Haga seguimiento de las visitas de Taboola Realize y de las acciones de ecommerce en su tienda PrestaShop. El módulo añade el Pixel de navegador de Taboola, admite postbacks servidor a servidor opcionales y le permite crear eventos de conversión personalizados para las interacciones de la tienda que importan a sus campañas.

Compatibilidad

Compatible con PrestaShop 1.6 a 9.0 (latest) y PHP 7.1+. Seguimos dando soporte a las próximas versiones de PrestaShop.

Configuración

1. Instale el módulo y abra Modules -> Taboola Pixel -> Configure.
2. Pegue su Taboola Account ID numérico desde Taboola Realize.
3. Active Taboola Pixel.
4. Elija qué eventos de ecommerce deben enviarse.
5. Opcional: active S2S postback events si sus campañas de Taboola pasan un ID de clic.
6. Opcional: añada reglas de eventos personalizados para clics, URL, controladores o eventos JavaScript.

El Account ID debe ser numérico:

ACCOUNT_ID=1234567

El módulo se instala con estos nombres de evento predeterminados:

product_view
collection_view
add_to_cart
start_checkout
make_purchase
search_submitted
add_to_wish_list
complete_registration

Ajustes principales

La página de configuración incluye estos ajustes para el comerciante:

ENABLED=1
ACCOUNT_ID=1234567
EXCLUDE_EMPLOYEES=1
RESPECT_CONSENT=1
TRACK_PAGEVIEW=1
TRACK_VIEWCONTENT=1
TRACK_VIEWCATEGORY=1
TRACK_ADDTOCART=1
TRACK_STARTCHECKOUT=1
TRACK_PURCHASE=1
TRACK_SEARCH=1
TRACK_ADDTOWISHLIST=1
TRACK_SIGNUP=1
S2S_ENABLED=0
S2S_BATCH_LIMIT=20

Valores predeterminados útiles:

• Excluir empleados: detiene el seguimiento del front-office mientras navega un empleado conectado al back-office.
• Respetar el consentimiento de cookies: espera al consentimiento de marketing cuando mprcookiesrevolution o mprcookiebanner está activo.
• Límite de lote de la cola: procesa por defecto hasta 20 eventos S2S en cola por ejecución. El rango aceptado es de 1 a 1000.

Eventos

Los eventos de navegador integrados incluyen:

• Vista de página: page_view
• Vista de producto: product_view
• Vista de categoría o colección: collection_view
• Añadir al carrito: add_to_cart
• Iniciar checkout: start_checkout
• Compra: make_purchase
• Búsqueda: search_submitted
• Añadir a la lista de deseos: add_to_wish_list
• Registro de cliente: complete_registration

El seguimiento de compras usa la página de confirmación de pedido y envía, cuando están disponibles, valores del pedido como ingresos, moneda, cantidad e ID de pedido.

Server-To-Server Postbacks

Los postbacks S2S son opcionales. El seguimiento con Pixel de navegador puede funcionar sin ellos.

Para la atribución S2S, las URL de landing page de las campañas de Taboola deben incluir uno de estos parámetros de ID de clic:

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

El script del front almacena el ID de clic en estas cookies para la atribución posterior:

mprtbpx_tblci
taboola_click_id

Los postbacks S2S se envían a Taboola mediante este endpoint:

https://trc.taboola.com/actions-handler/log/3/s2s-action

La consulta del postback puede incluir:

click-id=TABOOLA_CLICK_ID
name=make_purchase
revenue=49.90
currency=EUR
quantity=2
orderid=1234

El campo Test tblci acepta letras, números, puntos, guiones bajos, dos puntos y guiones:

S2S_TEST_CLICK_ID=abc.DEF_123-456:789

Eventos personalizados

Active Track custom events cuando quiera enviar puntos de conversión adicionales, como navegación por galerías, botones de lead, clics en el localizador de tiendas o visitas a landing pages.

Las reglas de eventos personalizados usan JSON. Los activadores admitidos son:

click
url
controller
event

Ejemplo de regla de clic:

[
  {
    "event": "gallery_browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "s2s": true,
    "once": false
  }
]

Ejemplo de regla de URL:

[
  {
    "event": "landing_page_view",
    "trigger": "url",
    "contains": ["/sale", "utm_campaign=taboola"],
    "params": {
      "property": "taboola_landing"
    },
    "s2s": true
  }
]

Ejemplo de regla de controlador:

[
  {
    "event": "contact_page_view",
    "trigger": "controller",
    "controllers": ["contact"],
    "params": {
      "property": "contact"
    },
    "s2s": true
  }
]

Ejemplo de regla de evento JavaScript:

[
  {
    "event": "lead",
    "trigger": "event",
    "dom_event": "mprtbpx:custom",
    "params": {
      "property": "lead_form"
    },
    "s2s": true
  }
]

Un tema o un pequeño script personalizado puede activar entonces el evento DOM:

document.dispatchEvent(new CustomEvent('mprtbpx:custom', {
  detail: {
    params: {
      value: 1,
      currency: 'EUR'
    }
  }
}));

Para las reglas de clic, el módulo también puede leer parámetros desde los elementos pulsados:

<a href="/contact"
   class="taboola-lead-button"
   data-taboola-param-property="lead_button"
   data-mprtbpx-param-location="product_page">
  Contact us
</a>

Diagnóstico

La página de configuración muestra comprobaciones de preparación para:

• Taboola Account ID
• Seguimiento de navegador
• Nombre del evento de compra
• Estado del postback S2S
• Reglas de eventos personalizados
• Captura de tblci
• Tabla de cola

También muestra los recuentos de la cola S2S:

pending
sending
sent
failed

Puede usar Send S2S probe después de añadir un tblci real, y Retry failed events para devolver los postbacks fallidos a la cola pendiente.

Notas técnicas para propietarios de tiendas

El módulo registra estos hooks de PrestaShop:

displayHeader
displayOrderConfirmation
actionValidateOrder
actionCustomerAccountAdd

Una tarea programada procesa las conversiones de Taboola en cola:

send_taboola_conversions
schedule: every:300
timeout: 30

Normalmente no necesita editar estos valores. Se incluyen aquí para que su desarrollador o equipo de hosting pueda confirmar rápidamente que el módulo está instalado y funcionando en los lugares esperados.