Integración Criteo OneTag: configuración y ayuda

1. Sube e instala el ZIP en Módulos > "Module Manager", después abre Criteo OneTag Integration > "Configure".
2. Introduce Partner ID de Criteo en Configuración de Criteo OneTag.
3. Revisa "Track home page", "Track product views" y los demás interruptores de eventos.
4. Mantén activados los controles iniciales de consentimiento y empleados, establece "Enable Criteo OneTag" en Sí y haz clic en Guardar.
5. Concede el consentimiento de marketing en un navegador de visitante y abre una página de producto.
6. Confirma que se emiten el cargador de Criteo y el evento viewItem.
7. Para compras opcionales del servidor, configura la región y los ID de página API asignados por Criteo y después inspecciona un pedido autorizado mediante la cola y el programador.

Abre Módulos > "Module Manager" > Criteo OneTag Integration > "Configure".

• "Enable Criteo OneTag". Interruptor principal del seguimiento OneTag en el navegador; valor predeterminado: 0.
• Partner ID de Criteo. Valor numérico de la cuenta Criteo de tu configuración OneTag, de 4 a 20 dígitos; valor predeterminado: "".
• "Exclude logged-in employees". Evita que la navegación de empleados del Back Office afecte a las audiencias Criteo durante las pruebas; valor predeterminado: 1.
• "Respect marketing consent". Usa los módulos de consentimiento MPR como protección de consentimiento de marketing antes de ejecutar el seguimiento; valor predeterminado: 1.
• "Send hashed customer identifiers". Envía el ID de cliente y correo con hash SHA-256 para los clientes conectados cuando se permite el seguimiento; valor predeterminado: 0.
• "Track home page". Envía viewHome en la página de inicio de la tienda; valor predeterminado: 1.
• "Track product views". Envía viewItem en las páginas de producto; valor predeterminado: 1.
• "Track category listings". Envía viewCategory en las páginas de categoría y listados; valor predeterminado: 1.
• "Track search results". Envía viewSearchResult con palabras clave de búsqueda e ID de productos visibles; valor predeterminado: 1.
• "Track basket and checkout starts". Envía viewBasket en las páginas de carrito y proceso de compra; valor predeterminado: 1.
• "Track add to cart". Envía addToCart a partir de adiciones al carrito de PrestaShop confirmadas como correctas; valor predeterminado: 1.
• "Track purchases". Envía trackTransaction desde el navegador y también es necesario para los eventos de compra del servidor; valor predeterminado: 1.
• "Track custom trigger rules". Activa las reglas de activadores JSON adicionales guardadas en el campo de activadores personalizados; valor predeterminado: 0.
• Reglas de disparador personalizadas. Array JSON de reglas de activadores Criteo personalizados; valor predeterminado: "".
• "Enable server-side purchase tracking". Pone en cola los eventos de compra al validar el pedido para enviarlos a través de Criteo Retail Media API; valor predeterminado: 0.
• "Server-side region". Selecciona la región del endpoint de Criteo Retail Media, eu o us; valor predeterminado: eu.
• Page ID desktop server-side. ID de página API de Criteo usado para llamadas de compra desde escritorio; valor predeterminado: trackTransactionApiDesktop.
• Page ID móvil server-side. ID de página API de Criteo usado para llamadas de compra desde móviles y tabletas; valor predeterminado: trackTransactionApiMobile.
• "Forward IP address and user agent". Añade las cabeceras X-Forwarded-For y User-Agent a las llamadas del servidor para la coincidencia de atribución; valor predeterminado: 1.
• "Server-side queue batch limit". Número máximo de eventos Criteo de la cola enviados por ejecución cron, de 1 a 100; valor predeterminado: 20.

Haz clic en Guardar. Puedes instalar antes de tener un Partner ID, pero deja desactivado el seguimiento hasta introducir un ID válido. Usa la región y los ID de página API asignados por Criteo antes de activar las compras del servidor.

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 de Back Office iniciada, una regla de tráfico interno o la exclusión voluntaria de un 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 denegada puede retener los eventos. El módulo no proporciona un banner de cookies. Una preferencia de consentimiento antigua no sustituye un rechazo actual de una CMP detectada.

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

El envío en producción también sigue la política de tráfico saliente, y las tiendas de demo o vista previa no envían eventos a tu cuenta de Criteo. Las compras y los eventos de formulario del servidor solo se envían con el consentimiento registrado en el momento del pedido o del formulario; una ejecución cron posterior nunca cuenta como consentimiento.

Cuando se permite, el módulo carga https://dynamic.criteo.com/js/ld/ld.js?a=PARTNER_ID y prepara criteo_q. Envía tu cuenta, el tipo de dispositivo y el evento OneTag correspondiente. Los tipos de dispositivo son d para escritorio, m para móvil y t para tableta.

Los eventos estándar son viewHome, viewItem, viewCategory, viewSearchResult, viewBasket, addToCart y trackTransaction. Los datos de producto pueden incluir ID de catálogo, producto padre, precio, disponibilidad y ruta de categoría. Los listados pueden incluir ID visibles y número de página. Los eventos de carrito usan las líneas de carrito disponibles. Los eventos de compra usan la referencia del pedido, artículos, cantidades y moneda.

"Send hashed customer identifiers" está desactivado inicialmente. Al activarlo, el contexto privado del visitante puede proporcionar el ID de cliente con hash SHA-256 y el correo normalizado. El consentimiento actual para la coincidencia se comprueba por separado. Una cuenta conectada no autoriza por sí sola los datos de coincidencia.

La etiqueta pide los datos propios del visitante al endpoint evidence del módulo, que vincula al visitante del navegador con su sesión de invitado de PrestaShop. Mantén accesible ese endpoint (no lo bloquees ni lo pongas en caché). Las actualizaciones de la página de producto y las adiciones al carrito pueden actualizar los datos del catálogo.

Puedes reconocer una secuencia típica de la cola como esta. No pegues una etiqueta adicional en el tema mientras el módulo sea responsable del destino:

criteo_q.push(
  {event: 'setAccount', account: 12345},
  {event: 'setSiteType', type: 'd'},
  {event: 'viewItem', item: '42', parent_item: '42', price: '19.99', availability: 1}
);

Activa "Track custom trigger rules", pega un array en Reglas de disparador personalizadas y guarda. Adapta selectores y rutas a tu tienda:

[
  {
    "event": "viewItem",
    "label": "Gallery browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "page_id_type": "product",
    "params": {
      "interaction": "gallery_browse",
      "source": "product_gallery"
    },
    "once": false
  },
  {
    "event": "viewCategory",
    "label": "Sale landing page",
    "trigger": "url",
    "contains": [
      "sale"
    ],
    "page_id_type": "category",
    "params": {
      "section": "sale"
    }
  },
  {
    "event": "viewBasket",
    "label": "Checkout start",
    "trigger": "controller",
    "controllers": [
      "order",
      "orderopc"
    ],
    "page_id_type": "basket"
  },
  {
    "event": "viewItem",
    "label": "Size guide",
    "trigger": "event",
    "dom_event": "mprcriteo:custom",
    "page_id_type": "product"
  }
]

Ejecuta el ejemplo DOM desde el tema:

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

Las reglas personalizadas funcionan para viewHome, viewItem, viewCategory, viewSearchResult y viewBasket. El módulo envía por sí mismo addToCart y trackTransaction con adiciones al carrito y pedidos reales, así que las reglas personalizadas con esos dos nombres se aceptan pero nunca se activan.

El gestor de activadores usa los params configurados y los artículos actuales disponibles. No combina detalles DOM arbitrarios. Las condiciones URL inspeccionan la URL completa. Las reglas de controlador también pueden incluir nombres de módulos.

Los ID de página del navegador usan estas correspondencias. Los ID móviles también cubren los contextos de tabletas:

Mantén "Track purchases" activado. Configura "Enable server-side purchase tracking", "Server-side region" y los ID de página de escritorio/móvil. Los valores predeterminados son eu, trackTransactionApiDesktop y trackTransactionApiMobile. Los ID de página API admiten letras, dígitos, guiones bajos, dos puntos y guiones. Valores como trackTransaction_API_desktop se aceptan sintácticamente, pero usa los ID asignados a tu integración.

Los endpoints regionales son:

La validación del pedido captura el consentimiento original y los datos del comprador. Un evento de servidor apto usa el ID de invitado del carrito real del pedido como identidad del visitante del comercio. Los hashes opcionales de coincidencia y las cabeceras IP/user-agent reenviadas requieren sus ajustes y autorización correspondientes. El envío del servidor se limita a las compras; no es una API general de eventos personalizados.

El envío de compras usa un registro compartido para que el navegador y el servidor no envíen ambos el mismo pedido; no esperes ver cada pedido en los dos canales. Una compra queda retenida si falta el consentimiento del comprador, los datos de compra guardados al hacer el pedido, el ajuste de destino o los valores del pedido.

La tarea send_criteo_retailmedia_conversions se registra con la programación every:300. Vence cada cinco minutos. Tu ejecutor cron compartido de MPR debe ejecutar las tareas pendientes; la declaración de la programación por sí sola no ejecuta un proceso de trabajo. El ajuste "Server-side queue batch limit" limita las filas de la cola por ejecución de procesamiento, de 1 a 100, con un valor predeterminado de 20.

El módulo no incluye un punto de entrada independiente cron.php. Usa el programador compartido ya configurado para la tienda. Confirma la ejecución de tareas en ese programador y comprueba las marcas de tiempo y el estado de la cola en la página de configuración de este módulo.

El diagnóstico incluye comprobaciones de preparación, contadores de cola, filas recientes, Enviar prueba API y Reintentar eventos fallidos. Resuelve la causa del fallo antes de reintentar. Devolver filas fallidas al estado pendiente no omite el consentimiento actual, la política de empleados, la responsabilidad de la cuenta ni las comprobaciones del destino.

Enviar prueba API no envía solicitudes API ni compras de prueba. Reintentar eventos fallidos devuelve el trabajo fallido apto de la cola para otro intento después de corregir la causa.

1. Comprueba Partner ID, preparación, integridad, consentimiento y responsabilidad del destino.
2. Desde un navegador de visitante normal, concede el consentimiento de marketing y abre las páginas de inicio, producto, categoría, búsqueda y carrito.
3. Confirma el cargador y el evento OneTag correspondiente para cada tipo de página activado.
4. Añade un artículo correctamente y confirma que la adición al carrito usa datos de catálogo válidos.
5. Haz un pedido de prueba. Revisa el ID de compra, los valores, el consentimiento del comprador registrado y el canal de envío utilizado.
6. Para compras del servidor, confirma que se ejecuta la tarea programada e inspecciona la respuesta de la cola y el diagnóstico de la cuenta Criteo.

Si OneTag no aparece, comprueba el interruptor de activación, el Partner ID numérico, la decisión de consentimiento, la política de empleados, la responsabilidad, la política de tráfico saliente, las colas duplicadas, los bloqueadores del navegador y la solicitud al endpoint evidence. Si una regla personalizada nunca se activa, comprueba si usa addToCart o trackTransaction, que las reglas personalizadas no pueden enviar.

Si falla el envío del servidor, verifica la región y los ID de página asignados por Criteo, el permiso original del comprador, la identidad nativa de invitado, los datos del pedido y la ejecución del programador. Cambiar el destino o la región después de la admisión puede retener filas existentes. Este módulo no configura campañas, creatividades, pujas, audiencias ni feeds de productos por ti.

Desactiva "Enable Criteo OneTag" y "Enable server-side purchase tracking", después guarda para detener el seguimiento conservando la configuración. Desinstala desde "Module Manager" para eliminar entradas de menú, tareas registradas y la configuración del módulo.

La desinstalación elimina el menú, la tarea programada y los ajustes del módulo. Las tablas compartidas de cola y compras que usan otros módulos de seguimiento se mantienen, así que exporta antes los registros que necesites. La desinstalación no puede eliminar eventos que Criteo ya haya recibido.

Requiere PrestaShop 1.6.0.0 o posterior y PHP 7.1 o posterior.