Subir transacciones pasadas o fuera de línea para las recomendaciones de productos

Además de las transacciones en línea que Personyze registra en tiempo real, puede aportarle sus transacciones pasadas o fuera de línea. Como las recomendaciones se basan en estadísticas de transacciones, subir el historial mejora sus recomendaciones y le permite aprovechar las ventas de tiendas físicas, pedidos por teléfono o cualquier canal que Personyze no ve en el sitio.

¿Por qué subir transacciones pasadas?

Normalmente, para dar un impulso inicial a una cuenta nueva de Personyze. Si no, las recomendaciones tardan un tiempo en ser relevantes, porque se van construyendo a medida que Personyze registra las interacciones de los clientes desde el día en que lo instala. Aportar qué usuarios compraron qué productos en el pasado permite llegar a la relevancia mucho antes.

¿Por qué subir transacciones fuera de línea?

Para mejorar las recomendaciones con ventas que Personyze no puede observar en su sitio — compras en tienda, datos del TPV, pedidos por teléfono. Como suele ser una fuente continua y no una carga única, lo mejor es entregarla como un feed recurrente (RSS/Atom, un feed por URL o SFTP) que se vaya actualizando.

Lo que necesita cada fila

Cada fila dice quién compró qué, y cuándo. En el asistente, los campos obligatorios están marcados con un asterisco:

Hora o ID de la transacción (obligatorio) — la fecha y hora de la compra, o un ID de pedido. Si varios artículos comparten un ID de pedido, Personyze aprende que se compraron juntos (y los recomienda juntos cuando eso ocurre con suficiente frecuencia). Para una marca de tiempo, use una fecha y hora estándar como 2026-07-21 14:30:00 o una época Unix como 1751389200.
Correo del usuario o ID interno del usuario (uno de los dos es obligatorio) — la clave que vincula cada transacción a un cliente. El email sirve también como clave para las campañas de recomendación por email (p. ej. emails de venta cruzada basados en lo que se compró). Un ID interno o de CRM funciona igual de bien; solo necesita uno de los dos.
ID interno del producto (obligatorio) — el ID único de cada producto. Debe coincidir con la clave de su catálogo de productos; si no hay ID de producto, la URL de la página del producto puede servir en su lugar.
Cantidad e Importe (opcionales) — inclúyalos si los tiene; si no, Personyze lee los datos del producto, como el título y el precio, de su catálogo.

Dónde subirlo

Vaya a Configuración → Recomendaciones → Seguimiento de productos y abra el asistente Subir eventos de compras pasadas. Tiene tres pasos.

Las cuatro formas de enviar datos de transacciones a Personyze: subir un archivo, un feed por URL/RSS/Atom, SFTP o la API JSON — Paso 1, **Fuente de carga** — elija cómo llegan los datos. En realidad, la elección depende de con qué frecuencia cambian.

Paso 1 — Fuente de carga. Elija cómo llegan los datos a Personyze:

Subir un archivo — un CSV o TSV de su ordenador (hasta 50 MB). Una instantánea única; lo mejor para cargar el historial.
Feed por URL — una URL HTTP(S) que devuelve CSV/JSON (o un feed RSS/Atom). Personyze la consulta periódicamente, así que las transacciones nuevas siguen llegando. Lo mejor para las ventas fuera de línea que no dejan de llegar.
Entrega por SFTP — suba su archivo a la carpeta /upload de sftp://upload.personyze.com; aparece en el asistente en cuanto se detecta. Lo mejor para exportaciones nocturnas grandes. Configure sus propias credenciales en un par de clics con Configurar acceso SFTP — consulte Obtener sus credenciales de SFTP.
API JSON — envíe los registros por POST directamente desde su backend al endpoint de transacciones (social_site_db_products_interactions_archive). Consulte la documentación de la API.

El paso Elegir columnas, que asigna cada columna de origen a un campo de Personyze — Paso 2, **Elegir columnas** — asigne cada una de sus columnas a un campo de Personyze. Los campos obligatorios están marcados con *; se muestra un ejemplo de sus datos para que confirme que se han leído bien.

Paso 2 — Elegir columnas. Personyze lee su fila de encabezado y asigna automáticamente lo que reconoce; ajuste lo que no. Asigne al menos los tres campos obligatorios (Hora o ID de la transacción, ID interno del producto, y Correo del usuario o ID interno del usuario). Cada columna tiene un preprocesamiento opcional (por ejemplo, quitar el símbolo de moneda o los separadores de millares) y una vista previa de ejemplo en directo.

Paso 3 — Listo para importar. Confirme y empiece. Un archivo se carga una vez; una fuente de URL, SFTP o API se puede mantener como feed recurrente — se vuelve a importar periódicamente y aparece en Feeds activos en la pantalla Seguimiento de productos, donde puede volver a importarlo, editar la asignación o cambiar su configuración en cualquier momento.

El Product ID de su feed debe coincidir con la clave que usa su catálogo de productos. Una importación que termina pero «no coincide con ningún producto» casi siempre es un problema de claves — las transacciones se cargaron bien, simplemente no coinciden con el catálogo.

Relacionado

Subir feeds y archivos de datos — el asistente de importación compartido, las reglas de formato y una plantilla de transacciones descargable.
Configurar el feed de productos / contenidos — el catálogo con el que se relacionan estas transacciones.