Recomendaciones y catálogo de productos
OneTrace.pro selecciona productos para cada cliente: los populares, «comprados juntos», similares, vistos recientemente y una selección personalizada. Las recomendaciones se muestran en el sitio web, en los correos, en los recorridos y en las campañas. Para que funcionen se necesitan un catálogo de productos y eventos de vistas, carrito y compras.
La sección se abre en el menú Comunicaciones → Recomendaciones. Todos los miembros del proyecto pueden verla; pueden conectar feeds, cambiar la configuración y lanzar el recálculo «Propietario», «Administrador» y «Gestor».

Catálogo de productos
En la parte superior de la página se ve cuántos productos hay en el catálogo, cuántos están disponibles y cuántas categorías hay. Mientras el catálogo esté vacío, no hay nada que recomendar: conecte un feed o cargue los productos mediante la API.
Cómo conectar un feed
- En el bloque Feeds de productos, pulse Añadir feed.
- Indique el Nombre y la URL del feed, el enlace al archivo.
- Elija el Formato: YML (Yandex), Google Merchant, CSV, JSON o JSON Lines.
- En el campo Actualización, elija con qué frecuencia se vuelve a leer el feed: cada 1, 3, 6 o 12 horas, o una vez al día.
- Si el feed está protegido con contraseña o token, complete el Encabezado Authorization, por ejemplo
Bearer …. Se guarda cifrado. - Pulse Guardar. La primera importación comenzará de inmediato.

En CSV y JSON, las columnas se reconocen por su nombre: id, name o title, url, image, price, old_price, currency, available, category, brand (también se reconocen los nombres equivalentes en ruso). El resto de columnas se consideran características del producto. El id del producto debe coincidir con el que el sitio web envía en los eventos; de lo contrario, las acciones de los clientes no se vincularán con el catálogo.
Cada feed muestra su estado (Activo o Error), la hora de la última importación y el resultado: cuántos productos y categorías se leyeron y cuántos se marcaron como no disponibles. El botón Actualizar lanza la importación fuera de la programación. Pausar detiene las importaciones programadas (estado «En pausa») y Actualizar las reanuda. Un feed con error se vuelve a intentar según la programación; el texto del error aparece debajo.
Qué debe saber:
- Los productos que ya no están en el feed se marcan como no disponibles, no se eliminan: su historial de eventos se conserva y, si el producto vuelve al feed, vuelve a estar disponible.
- Al eliminar un feed, los productos permanecen en el catálogo.
Copias de las imágenes
En la configuración del feed puede activar Copiar las imágenes de productos a nuestro almacenamiento. Así, las imágenes de los correos y los widgets se cargan desde la CDN de OneTrace.pro y no dependen de la disponibilidad de su sitio web.
- Descargar como máximo … imágenes por segundo, minuto u hora: un límite para no sobrecargar su sitio web. Por defecto, 5 por segundo.
- Bajo el feed se ve cuántas imágenes se copiaron, cuántas están en cola y cuántas no se pudieron descargar. Mientras no haya copia (o si la dirección de la imagen en el feed cambió), se muestra la imagen original.
- Las copias cuentan para el límite de almacenamiento de imágenes del plan. Si el interruptor no está disponible, el almacenamiento de imágenes no está configurado en su instalación.
Carga mediante la API
Los desarrolladores pueden cargar y eliminar productos con solicitudes a https://cdp.onetrace.pro/api/v1/products, hasta 1000 productos y categorías por solicitud. Se necesita una clave secreta con el permiso «Carga y eliminación de productos»; consulte Claves de API e Integración desde el servidor.
Eventos para los modelos
En el bloque Eventos para los modelos, indique qué eventos corresponden a acciones con productos:
| Campo | Ejemplo |
|---|---|
| Vista de producto | product_viewed |
| Añadir al carrito | product_added |
| Compra | order_completed |
| Propiedad con el id del producto | product_id: un campo en el evento o un array products[] con este campo |
| No recomendar lo comprado | 30, 90 o 365 días; «Volver a recomendar» para productos consumibles |
Por defecto, los eventos se toman de la configuración de las predicciones. Al pulsar Guardar, los modelos se recalculan.
Modelos y cálculo nocturno
La tarjeta Modelos muestra el estado (Pendiente, Calculando, Listo, Sin catálogo, Error), la hora del cálculo y el número de relaciones entre productos.
Los modelos se recalculan cada noche, además de justo después de guardar la configuración y con el botón Recalcular. Durante el cálculo y en caso de error, las recomendaciones se sirven con la versión anterior.
Además de las relaciones, el cálculo escribe en los perfiles los atributos favorite_category, favorite_brand y top_products. Se pueden usar en los segmentos, por ejemplo «categoría favorita: calzado».
Tipos de recomendaciones
| Tipo | Qué muestra | Dónde es útil |
|---|---|---|
| Personalizados | una selección según las vistas, los carritos y las compras del cliente, teniendo en cuenta sus acciones de hoy | página de inicio, correo «También le puede interesar» |
| Populares | los productos más demandados en 30 días, de todo el catálogo o de una categoría | visitante nuevo, carrito vacío |
| En tendencia | productos cuyo interés creció en la última semana | página de inicio, campaña «Novedades de la semana» |
| Vistos juntos | lo que se ve junto con este producto | ficha de producto |
| Comprados juntos | lo que se compra junto con este producto | carrito, correo posterior al pedido |
| Similares | productos de la misma categoría: marca, precio, características | ficha de producto, producto agotado |
| Vistos recientemente | las últimas vistas del cliente | navegación abandonada |
Un visitante nuevo sin historial recibe los productos populares. En las selecciones solo entran productos disponibles.
Comprobación de resultados
En el bloque Comprobar resultados, elija el Tipo e indique el ID del producto, el ID de categoría o el ID del perfil, según el tipo. Pulse Mostrar para ver las tarjetas de los productos que recibirá el cliente.

Informe de efecto
La tabla Efecto en el sitio web en 30 días muestra para cada tipo las impresiones, los clics, el CTR, las compras y los ingresos. Una compra se contabiliza si el cliente compró el producto en los 7 días siguientes al clic en la recomendación; los ingresos se calculan con el precio del catálogo. El efecto de las recomendaciones en los correos se ve en los informes de campañas y recorridos.

Dónde mostrar las recomendaciones
- En el sitio web: widgets listos de la sección «Sitio web» o una llamada al rastreador; consulte Widgets de recomendaciones en el sitio web.
- En los correos: el bloque Productos del editor de correos. En él se eligen Qué productos, Cantidad, el número de columnas, Mostrar precio y Botón bajo el producto. Para los tipos «Vistos juntos», «Comprados juntos» y «Similares», el producto se toma del evento que activó el correo (Propiedad del evento con el id del producto); así se crea el correo de carrito abandonado. Si no hay productos adecuados, el bloque no se muestra en el correo.
- En plantillas de cualquier canal: la función
recommendations():
{% for product in recommendations('personal', 4) %}
<a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}