Integración Criteo OneTag conecta el recorrido de compra, catálogo y pedidos pagados de tu tienda PrestaShop con Criteo. La instalación y un identificador de socio de Criteo (Partner ID) inician la conexión estándar.
Criteo ofrece publicidad dinámica y remarketing, usando catálogo y actividad para crear públicos y atribuir ingresos. La publicidad se factura aparte según tu contrato Criteo, independientemente del módulo.
Activas cada etapa, mantienes un catálogo con identificadores coincidentes y eliges la vinculación opcional de clientes. El envío directo transmite pedidos pagados sin depender del navegador; los fallos esperan reintentos o recuperación manual. El consentimiento de marketing y la exclusión del personal regulan la recogida, y la protección contra duplicados deja una sola integración a cargo del envío de eventos.
Precios, existencias e identificadores coinciden entre los artículos consultados y los productos presentados en anuncios dinámicos.
Resumen de las posibilidades del módulo
- Inicio estándar breve con un Partner ID de Criteo y ajustes detallados para tiendas exigentes
- Todo el recorrido de compra y un feed de producto sincronizado con la misma identidad de producto
- Incorporaciones al carrito confirmadas y compras pagadas registradas una sola vez con valores y productos correctos
- Envío directo de compras desde la tienda, sin duplicados, con nuevos intentos y recuperación manual
- Control sobre eventos, consentimiento, tráfico de empleados, asociación de clientes e interacciones adicionales
- Configuración guiada, verificación en la tienda real, resultados de preparación y estado visible de los envíos
Criteo OneTag Integration conecta con Criteo el interés por los productos, la actividad del carrito y los ingresos de pedidos pagados. El seguimiento estándar comienza con un identificador de cuenta, mientras que el feed, cada etapa del recorrido, las decisiones de privacidad, las reglas adicionales y el envío directo de compras forman la configuración avanzada.
El módulo mantiene alineados el catálogo, la actividad de la tienda y los datos de compra, y después muestra el estado de cada parte de la conexión y el resultado del envío de ventas.
¿Cómo recibe Criteo todo el recorrido de compra?
El módulo registra la página de inicio, los listados de categorías, los resultados de búsqueda, las vistas de producto, el carrito y el inicio del pedido, las incorporaciones confirmadas y las compras. La actividad de producto contiene el identificador, el precio actual, la disponibilidad y la ruta de categoría. Los listados contienen los productos mostrados, mientras que una compra contiene referencia, divisa, productos, precios y cantidades.
El feed de producto sincronizado utiliza la misma identidad que los eventos de la tienda y los pedidos pagados. Publica títulos, precios actuales, existencias, imágenes y direcciones de producto, los actualiza según la programación elegida y señala diferencias antes de que lleguen a Criteo. El producto visto en la tienda sigue siendo así el mismo producto que aparece en el anuncio dinámico.
¿Qué acciones representan un interés de compra real?
Una incorporación llega a Criteo únicamente después de confirmar un aumento positivo de la cantidad del carrito. Una eliminación, una reducción de cantidad, una solicitud fallida y los avisos repetidos de la tienda no se convierten en un nuevo interés de compra. El evento contiene una sola vez el producto y la cantidad añadida realmente.
Las ventas siguen el mismo principio. Solo un pedido pagado entra en el envío directo, y un pago aplazado envía el pedido cuando cambia al estado pagado. Una identidad de compra estable impide que el evento inmediato de la tienda, el posterior cambio de estado y el procesamiento repetido conviertan una venta en varias.
¿Qué ocurre cuando una compra no llega a Criteo?
El envío directo registra el pedido pagado en la tienda antes de intentar la transmisión. Un rechazo temporal de Criteo o un problema de conexión mantiene esa compra en la cola en lugar de crear un vacío silencioso en los informes de campaña. Los nuevos intentos siguen intervalos crecientes y una entrega correcta cierra el mismo registro único.
El panel de administración muestra totales pendientes, en proceso, entregados y fallidos, además de la identidad de las compras recientes, el número de intentos, el estado de respuesta y el error. Un registro que ha agotado sus intentos vuelve al procesamiento mediante la recuperación manual y conserva su historial anterior de fallos para el diagnóstico.
¿Qué decisiones permanecen bajo el control del comerciante?
Activas por separado cada etapa estándar del recorrido. Con MPR Cookies Revolution o MPR Cookie Banner instalado, la decisión de marketing de la tienda gobierna el inicio de Criteo, mientras que los empleados conectados quedan fuera de los datos publicitarios. La asociación del cliente es opcional, y tanto el número de cliente como el correo electrónico se transforman antes de cualquier envío desde el navegador o directamente desde la tienda.
Las reglas adicionales asocian acciones admitidas por Criteo a un clic elegido, un fragmento de dirección, una página de la tienda, una página aportada por otro módulo o una acción con nombre. Sus valores se revisan y se eliminan los campos personales. Cuando otra integración participante ya controla la misma cuenta de Criteo, este módulo queda inactivo e identifica al responsable en vez de registrar cada acción dos veces.
¿Cómo demuestra la configuración que la conexión funciona?
Un asistente guiado conduce desde el Partner ID hasta el consentimiento, el feed de producto y el envío directo opcional de compras. Explica cada requisito, guarda el progreso y comprueba el recorrido real de la tienda, desde un listado y una vista de producto hasta la incorporación confirmada, el carrito y el pedido pagado. El resultado coteja la identidad de producto emitida con el feed.
El área de preparación informa por separado del identificador de cuenta, los eventos estándar, la protección del consentimiento, las reglas adicionales, la actualización del feed, los ajustes de compra y el almacenamiento de la cola. Una prueba de envío a Criteo, los resultados recientes y mensajes de error que orientan la corrección completan la puesta en marcha. El inicio rápido se convierte así en una configuración cuyo estado permanece visible después de cambios en el aspecto, el consentimiento o el proceso de pedido.
-
Referenciamprcriteotag
-
Versión1.4.0
-
Mejoras126
-
Publicado
-
Actualizado
-
Compatibilidad PrestaShopPS 1.6 – 9.x
-
Modelo de precioCompra única
-
Tipo de móduloFront-office
-
Relevante para RGPDSí
-
Objetivo comercialMarketing y retargeting
-
Cuenta externa necesariaSí
-
Complejidad del móduloWidget ligero
-
Etapa del recorrido del clienteAtraer visitantes
-
Funciona con plataformaRedes de publicidad y analítica
Sé la primera persona en compartir tu experiencia con este producto.
Instala Criteo OneTag en tu tienda PrestaShop y envía a Criteo los eventos de ecommerce que necesita para retargeting, recomendaciones de productos, anuncios de producto y medición de conversiones. El módulo añade el seguimiento OneTag en el navegador mediante hooks de PrestaShop y, opcionalmente, puede poner en cola eventos de compra del lado del servidor para Criteo Retail Media.
¿Puede el módulo Criteo de PrestaShop enviar conversiones de compra del lado del servidor?
Sí. El módulo tiene seguimiento opcional de compras Criteo Retail Media del lado del servidor. Para usarlo, el seguimiento de compras debe estar activado y los ajustes del lado del servidor deben estar configurados: Criteo partner ID, S2S_ENABLED, región eu o us, IDs de página API desktop y móvil, y un límite de lote. El límite de lote predeterminado del lado del servidor es 20, con validación acotada de 1 a 100.
Cuando PrestaShop dispara actionValidateOrder, el hook encola una conversión trackTransaction para el proveedor criteo_retailmedia y procesa inmediatamente un lote pequeño, pero no inspecciona por sí mismo el estado del pedido o el estado de pago. La ruta de cola se ejecuta cuando el seguimiento del módulo puede ejecutarse, el seguimiento de compra está activado, la configuración del lado del servidor es válida y hay un objeto Order cargado. Si necesitas semántica de solo pagado, debe garantizarse por el contexto de validación del pedido o añadirse como una comprobación explícita de estado.
También se registra una tarea cron llamada send_criteo_retailmedia_conversions para procesar conversiones encoladas cada 300 segundos. La petición del servidor se envía al endpoint Retail Media de Criteo para la región configurada, como d.eu.criteo.com o d.us.criteo.com, con ID de transacción, artículo, precio, cantidad, moneda, datos de visitante/cliente e ID de página. El ajuste opcional S2S_SEND_IP_UA controla si se incluyen datos de IP y user-agent. Esta cola del lado del servidor está separada del evento de navegador trackTransaction en la página de confirmación de pedido, así que los envíos fallidos del servidor pueden reintentarse sin depender de la sesión del navegador del cliente.
La función del lado del servidor se instala con la tabla de cola de conversiones compartida y registro cron. Está desactivada por defecto: S2S_ENABLED=0, S2S_REGION=eu, ID de página desktop trackTransactionApiDesktop, ID de página móvil trackTransactionApiMobile, S2S_SEND_IP_UA=1 y S2S_BATCH_LIMIT=20. El Partner ID debe ser numérico y de 4 a 20 dígitos, la región debe ser eu o us, y los IDs de página pueden contener letras, números, guion bajo, dos puntos y guion.
En la validación de pedido, el módulo comprueba primero las guardas de seguimiento de alto nivel: Criteo debe estar activo, el seguimiento de compra debe estar activado, el consentimiento debe permitir seguimiento cuando la guarda de consentimiento está activa y los ajustes del lado del servidor deben pasar la validación. Si cualquiera de esas comprobaciones falla, no se encola ningún evento de servidor.
El payload de compra se construye desde los datos de línea de pedido. Los IDs de artículo, precios y cantidades se unen con caracteres pipe para la consulta Criteo Retail Media. Si no se puede mapear ningún ID de artículo, el módulo envía un fallback item=None, price=0.00 y quantity=1 en lugar de dejar vacío un campo obligatorio. El valor de entorno se selecciona desde el user agent como desktop d, móvil m o tablet t, y ese entorno elige el ID de página desktop o móvil.
El controlador de administración también expone herramientas operativas para esta cola: puede mostrar recuentos pending/sending/sent/failed, enviar una prueba de API y mover eventos Criteo del lado del servidor fallidos de nuevo a pending para reintento.
Required server-side setup:
ENABLED=1
PARTNER_ID=12345
TRACK_PURCHASE=1
S2S_ENABLED=1
S2S_REGION=eu or us
S2S_DESKTOP_PAGE_ID=trackTransactionApiDesktop
S2S_MOBILE_PAGE_ID=trackTransactionApiMobileLos comerciantes pueden crear disparadores Criteo OneTag personalizados en PrestaShop?
Sí, los comerciantes pueden definir reglas de disparador para eventos Criteo compatibles. La configuración PrestaShop acepta reglas JSON validadas con disparadores de clic, URL, controlador o evento DOM, y normaliza los nombres al vocabulario OneTag admitido por Criteo.
Cómo añado seguimiento Criteo OneTag a PrestaShop?
Puedes añadir Criteo OneTag a PrestaShop configurando un Criteo Partner ID numérico y activando el seguimiento de navegador. El módulo crea eventos OneTag en el header para páginas ecommerce compatibles y mantiene el tracking inactivo si falta el Partner ID o no es válido.
¿Criteo OneTag for PrestaShop envía identificadores de cliente hasheados?
Sí, cuando SEND_CUSTOMER_IDENTIFIERS está activado. El módulo construye eventos de cliente de Criteo separados junto a los eventos normales de página o compra. Nunca envía el email en claro en esos eventos de cliente; lo convierte a minúsculas, lo recorta y luego lo hashea con SHA-256. El ID de cliente también se hashea con un prefijo customer:.
[{"event":"setCustomerId","id":"sha256(customer:123)"},{"event":"setEmail","email":"sha256(alice@example.com)"}]Los valores anteriores son placeholders que muestran solo la forma. En la salida real del escaparate, los campos hash contienen cadenas hexadecimales SHA-256 de 64 caracteres. Los eventos se omiten por completo cuando los identificadores de cliente están desactivados o cuando no puede cargarse un cliente válido desde el contexto u pedido actual.
El ajuste está desactivado por defecto, así que el comerciante debe optar por activarlo antes de que se creen estos eventos. Para eventos normales de página, el módulo usa el cliente actual de PrestaShop desde el contexto del escaparate. Para eventos de compra de confirmación de pedido, puede cargar el cliente desde el id_customer del pedido. En ambas rutas, la fuente comprueba que exista un objeto cliente válido antes de añadir cualquier evento de identificador.
Las plantillas del navegador colocan estos eventos de identificador en la cola universal con setAccount y setSiteType, antes de enviar el evento de página, cesta o compra a window.criteo_q. El módulo no envía el nombre, teléfono, dirección postal ni ID de cliente PrestaShop sin procesar en esos eventos de cliente del navegador.
Para seguimiento de compras del lado del servidor, la misma bandera opt-in también puede añadir un valor de email hasheado a la consulta Retail Media cuando el cliente del pedido tiene una dirección de email. Esa ruta del lado del servidor sigue dependiendo de las guardas normales de seguimiento: el módulo debe estar activo, el consentimiento debe permitir seguimiento cuando está activado, el seguimiento de compra debe estar activo y los ajustes de Criteo del lado del servidor deben ser válidos.
¿El módulo Criteo de PrestaShop respeta el consentimiento de cookies?
Sí, puede respetar el consentimiento de cookies cuando RESPECT_CONSENT está activado, que es el valor predeterminado del módulo. El módulo comprueba primero mprcookiesrevolution analizando la cookie mprcr_consent y buscando marketing:1. Si falta esa cookie, recurre al valor DEFAULT_CONSENT de mprcookiesrevolution.
Si Cookies Revolution no está activo, comprueba mprcookiebanner. Un valor de cookie mprcookie_consent=granted permite Criteo; cualquier otro valor presente lo bloquea. Si la cookie del banner no existe, el módulo usa el DEFAULT_CONSENT de mprcookiebanner.
Si no hay ningún módulo de consentimiento MPR compatible instalado o activo, hasMarketingConsent() devuelve permitido, así que Criteo no se bloquea solo por consentimiento. Para una configuración estricta basada primero en consentimiento, mantén Respect marketing consent activado y ejecuta uno de los módulos de consentimiento MPR compatibles. La puerta de consentimiento del lado del cliente solo se activa cuando Respect marketing consent está activo y mprcookiesrevolution o mprcookiebanner está activo.
La comprobación de consentimiento forma parte de canTrack(), que se usa antes de eventos de cabecera, eventos de compra de confirmación de pedido y encolado de compras del lado del servidor. Así que cuando la comprobación de consentimiento del servidor bloquea el seguimiento, el módulo no construye eventos normales de navegador y no encola la conversión del lado del servidor desde actionValidateOrder.
La plantilla del navegador también incluye una comprobación de consentimiento del lado del cliente cuando la puerta de consentimiento está activa. Puede llamar a window.MPRCR.isGranted('marketing') cuando Cookies Revolution expone ese helper, o puede leer directamente las mismas cookies mprcr_consent y mprcookie_consent. Si esa comprobación JavaScript devuelve false, se detiene antes de enviar eventos Criteo a window.criteo_q.
RESPECT_CONSENT=0: consent check is bypassed
RESPECT_CONSENT=1 + mprcr_consent contains marketing:1: allowed
RESPECT_CONSENT=1 + mprcookie_consent=granted: allowed
RESPECT_CONSENT=1 + no supported MPR consent module: allowed by this moduleEl consentimiento no es la única guarda de seguimiento. El seguimiento del navegador también requiere ENABLED=1 y un Criteo Partner ID numérico válido, y la navegación de empleados puede excluirse cuando EXCLUDE_EMPLOYEES está activado.
¿Qué eventos Criteo puede enviar el módulo OneTag de PrestaShop?
El módulo asigna páginas y hooks del front office de PrestaShop a eventos Criteo OneTag, con ajustes separados para cada evento estándar.
| Evento | Dónde se dispara | Notas |
|---|---|---|
viewHome | Página de inicio desde displayHeader | Controlado por el ajuste de tracking de home. |
viewItem | Página de producto desde displayHeader | Usa el contexto del producto actual. |
viewCategory | Página de categoría/listado desde displayHeader | Usa contexto de categoría/listado y datos de productos visibles cuando están disponibles. |
viewSearchResult | Página de resultados de búsqueda desde displayHeader | Incluye contexto de búsqueda y datos de productos coincidentes cuando están disponibles. |
viewBasket | Página de carrito o checkout desde displayHeader | Usa las líneas del carrito actual. |
addToCart | JavaScript de front office en la plantilla de cabecera | Capturado desde interacciones de actualización de carrito y añadir al carrito. |
trackTransaction | Confirmación de pedido desde displayOrderConfirmation | Usa referencia de pedido, moneda y líneas compradas. |
custom | Reglas configuradas de clic, URL, controlador o evento DOM | Solo se ejecuta cuando el tracking de eventos personalizados está activado y las reglas coinciden. |
Todos los eventos de navegador siguen dependiendo de que el módulo esté activo, haya un partner ID de Criteo configurado, el visitante pase las comprobaciones de tracking/consentimiento del módulo y el toggle correspondiente por evento esté activado.
- AddedHarden Criteo release surface
- AddedAdd Criteo custom trigger rules
- AddedAdd Criteo server-side purchase tracking
Funciona bien con Integración Criteo OneTag
Los módulos que nuestro equipo combina realmente con este, y por qué cada uno encaja en la misma configuración.
Con Criteo OneTag en funcionamiento, tu tienda envía señales de compra a Criteo para retargeting, interés en el producto e informes de compra a lo largo de los flujos de inicio, producto, categoría, búsqueda, cesta, añadir a la cesta y transacción. Criteo trabaja a partir de tu catálogo de productos, por lo que su rendimiento depende en gran medida de la calidad y la estructura de los datos de producto que hay detrás, que la integración mantiene mediante su propio feed sincronizado.
Smart Google Merchant Feed Manager es un módulo independiente que genera y da forma a los datos de producto para Google Merchant Center, con perfiles de feed independientes para mercados, idiomas, monedas, países de destino y modos de sincronización, y puede publicar enlaces de feed XML protegidos. Te da un control disciplinado y deliberado sobre cómo se estructuran los datos de tu catálogo para las plataformas de shopping, en lugar de depender de exportaciones improvisadas.
Usados juntos, te permiten mantener datos de producto ordenados y bien estructurados que respaldan tu presencia en Shopping mientras Criteo se encarga del retargeting, dos herramientas complementarias que dependen ambas de información de catálogo limpia. La recompensa es un marketing de producto de pago construido sobre datos que gestionas a propósito: tu feed se mantiene organizado y adecuado al mercado, Criteo mantiene su propio feed y sus señales de compra, y el catálogo que sustenta ambos es algo que controlas en lugar de dejarlo al azar.
Con Criteo OneTag en funcionamiento, tu tienda envía señales de retargeting y de compra a Criteo a lo largo de los principales flujos de la tienda, desde el inicio y el producto hasta la cesta y la transacción. Esa es la propia visión de atribución de Criteo, útil para optimizar el canal, pero describe a Criteo solo en sus propios términos y no te ofrece ningún punto de informes neutral para compararlo de forma justa con tus otras fuentes de tráfico.
Google Analytics GA4 es un módulo independiente que envía la actividad de comercio electrónico a tu propiedad GA4 tras validar el ID de medición, cubriendo vistas de producto, actividad del carrito, inicios de compra, compras, búsquedas, inicios de sesión y creación de cuentas. Proporciona informes independientes del canal en toda la tienda, situando a Criteo dentro de los mismos embudos y la misma visión de ingresos que cualquier otra fuente.
Usado junto a Criteo OneTag, GA4 conserva la visión de conversión de Criteo para el ajuste de campañas a la vez que muestra su rendimiento frente a todo lo demás. La recompensa es un contexto multicanal para el gasto en retargeting: optimizas Criteo con datos de la plataforma pero asignas el presupuesto desde un informe neutral, de modo que un canal que parece bueno de forma aislada siempre se sopesa frente a su contribución real a la tienda.
Una tienda que usa Criteo OneTag envía señales de compra para retargeting y normalmente gestiona también otras etiquetas de marketing. Mantenerlas coordinadas a mano en la plantilla es engorroso y propenso a fallos, y OneTag solo se ocupa de su propia plataforma, de modo que el conjunto más amplio de píxeles y fragmentos de analítica no tiene ninguna estructura compartida y consciente de eventos que lo mantenga coherente a medida que el stack crece y cambia.
Google Tag Manager es un módulo independiente que añade tu contenedor GTM y lo alimenta con eventos de comercio electrónico en formato GA4 procedentes del comportamiento de compra real, dando a las etiquetas de marketing y analítica circundantes una capa de entrega coherente. Configura el contenedor compartido de GTM para otras etiquetas y deja Criteo al módulo dedicado, de modo que tu etiqueta Criteo dedicada permanece exactamente como está configurada.
Ejecutar ambos deja intacto el OneTag de Criteo mientras GTM organiza el panorama más amplio de etiquetas. La recompensa es una configuración más limpia y más fácil de mantener: tu medición de Criteo se mantiene independiente y fiable, las demás etiquetas viven en una estructura ordenada, y es mucho menos probable que los cambios futuros rompan el seguimiento existente, de modo que tu esfuerzo se dedica a los resultados en lugar del mantenimiento de fragmentos.
Dado que Criteo OneTag carga seguimiento en el navegador y puede enviar compras desde el servidor, aplica el consentimiento de marketing a ambas vías de envío cuando la decisión se gestiona mediante un gestor de consentimiento compatible. Cookies Revolution aporta esa capa de decisión y registra las elecciones del comprador.
Cookies Revolution es un gestor de consentimiento independiente que recopila y aplica las decisiones para las cookies necesarias, funcionales, analíticas y de marketing. Bloquea los scripts externos e inline coincidentes antes del consentimiento, reactiva los permitidos después una vez que se concede, y registra cada decisión.
Usado junto a Criteo OneTag, retiene los scripts de marketing hasta que un comprador da su consentimiento y guarda un registro de esas decisiones, de modo que tu retargeting de Criteo se apoya en una base que respeta el consentimiento. La recompensa es un seguimiento que puedes defender: sigues midiendo a los compradores que aceptan, puedes evidenciar cómo se recogió el consentimiento, y el cumplimiento se mantiene como una capa separada y manejable en lugar de algo parcheado alrededor de tu etiqueta de retargeting.
La URL del feed del catálogo de productos de Criteo devuelve un 404 tras actualizar el módulo
30 días de devolución
Devolución fácil - sin preguntas
Módulos Plug & Play
Instalar, configurar y beneficiarse
Soporte ante todo
Prioridad en ayuda y satisfacción
También podría interesarle
Quién desarrolla y mantiene este módulo
Desarrollado y mantenido por David Miller y mypresta.rocks. David Miller trabaja con PrestaShop desde 2013, y la empresa detrás de esta tienda está registrada desde el 3 de diciembre de 2018. Cada módulo de este catálogo es trabajo propio, así que tus preguntas al soporte llegan a las personas que escribieron el código. El registro de cambios de esta página muestra cada actualización con su fecha.