Subir feeds y archivos de datos (catálogo, intereses, contenidos, usuarios)
Cómo cargar datos en Personyze con el asistente Importar datos desde un archivo o feed: plantillas, las cuatro formas de entrega, la entrega por SFTP, la regla de las comas, la asignación de columnas…
33 min readActualizado hace 41 minutos
Cargar datos en Personyze
Dónde están ahora los datos. Cada tipo de datos tiene su propia pantalla en el panel, y todas abren el mismo asistente Importar datos desde un archivo o feed (las pantallas de catálogo lo muestran como una sección Pipelines de entrada). Vaya a la pantalla de lo que va a cargar:
Lo que va a subir
Dónde subirlo
Catálogo de productos (para las recomendaciones de productos) — incluidos los intereses de producto / etiquetas de afinidad como columnas
Configuración → Recomendaciones → Catálogo de productos
Catálogo de contenidos / artículos (para las recomendaciones de contenido)
Configuración → Recomendaciones → Catálogo de artículos
Transacciones pasadas / fuera de línea (historial de compras)
Configuración → Recomendaciones → Seguimiento de productos
Interacciones pasadas con contenidos (historial de lecturas / vistas)
Configuración → Recomendaciones → Seguimiento de artículos
Listas de usuarios / registros del CRM, campos de perfil, atributos de sesión
Configuración → Atributos de visitantes
Las pantallas de Recomendaciones aparecen cuando su cuenta tiene activados los productos o los artículos. El asistente, los métodos de entrega y las reglas de formato son idénticos en todas las pantallas — esta página es la referencia común; solo cambian las columnas.
El asistente Importar datos desde un archivo o feed (paso 1, Fuente de carga): elija un archivo, un feed por URL, SFTP o la API JSON. Es el mismo asistente en todas las pantallas de datos. Haga clic para ampliar.
Casi todo aquello por lo que personaliza Personyze se le puede dar como archivo de datos — un catálogo de productos para las recomendaciones, un catálogo de contenidos para las recomendaciones de artículos, intereses de producto para la venta cruzada y la segmentación por afinidad, listas de usuarios de su CRM, y más. Todos pasan por el mismo asistente Importar datos desde un archivo o feed; solo cambian las columnas.
Esta página explica cómo hacer entrar el archivo — los métodos de entrega, las reglas de formato que confunden a la gente y el paso de asignación — con ejemplos reales y probados.
Descargar un feed de plantilla
Empiece con un archivo ya preparado en lugar de una página en blanco. Cada plantilla tiene los encabezados correctos, el entrecomillado adecuado y unas cuantas filas de ejemplo con el formato exacto que espera el importador — sustituya las filas de ejemplo por sus propios datos y súbala. Todas usan URL de marcador example.com y productos de demostración genéricos.
Feed
Columnas
Descargar
Catálogo de productos Para las recomendaciones de productos — las columnas básicas.
Internal ID, SKU, Title, Product Page URL, Main Image URL, Price, Sale Price, Is in Stock, Rating, Category, Brand
El identificador de cliente .tsv se descarga como .txt (con las tabulaciones conservadas) — cámbiele el nombre a .tsv si sus herramientas lo esperan, o súbalo tal cual.
¿Prefiere verlo haciendo clic? Este es todo el flujo — elija una fuente, dé formato al archivo, asigne las columnas e importe. La referencia detallada está más abajo.
Subir un feed
Elegir cómo llegan los datos
Vaya a la pantalla de lo que va a cargar — Configuración → Recomendaciones → Catálogo de productos / Catálogo de artículos / Seguimiento de productos, o Configuración → Atributos de visitantes — y abra Importar datos desde un archivo o feed. Elija una fuente: subir un archivo (una sola vez), un feed por URL / RSS / Atom o SFTP (sincronizados), o la API JSON (en tiempo real). El mismo asistente en todas partes — solo cambian los campos.
💡 Un archivo es una instantánea; un feed por URL, SFTP o API se vuelve a sincronizar periódicamente.
Dar formato al archivo
El importador usa comas como delimitador. Cualquier celda que contenga una coma — una lista de intereses, varias categorías — debe ir entre comillas dobles, o se divide en columnas adicionales. Todo lo demás es CSV normal.
💡 El recuento “Se detectaron N columnas” del paso siguiente es su comprobación del análisis — fíese de él antes que de cómo se ve el archivo en Excel.
Asignar las columnas
Relacione cada columna detectada con un campo de Personyze. Una clave es obligatoria — un ID interno (o el SKU / la URL de la página del producto). Asigne el resto a sus campos; añada, si quiere, un Preprocesamiento o una Máscara para limpiar un valor a su entrada.
💡 La clave debe coincidir con la clave de su catálogo. “Se importa bien pero no coincide con nada” es casi siempre un problema de claves.
Revisar e importar
Confirme la asignación e inicie la importación. Un archivo se carga una vez; un feed por URL, SFTP o API sigue sincronizándose desde ese momento — se vuelve a leer más o menos cada pocos minutos para que el stock, los precios y los registros nuevos se mantengan al día.
Listo ✓
Elegir cómo llegan los datos
Vaya a la pantalla de lo que va a cargar — Configuración → Recomendaciones → Catálogo de productos / Catálogo de artículos / Seguimiento de productos, o Configuración → Atributos de visitantes — y abra Importar datos desde un archivo o feed. Elija una fuente: subir un archivo (una sola vez), un feed por URL / RSS / Atom o SFTP (sincronizados), o la API JSON (en tiempo real). El mismo asistente en todas partes — solo cambian los campos.
💡 Un archivo es una instantánea; un feed por URL, SFTP o API se vuelve a sincronizar periódicamente.
Dar formato al archivo
El importador usa comas como delimitador. Cualquier celda que contenga una coma — una lista de intereses, varias categorías — debe ir entre comillas dobles, o se divide en columnas adicionales. Todo lo demás es CSV normal.
💡 El recuento “Se detectaron N columnas” del paso siguiente es su comprobación del análisis — fíese de él antes que de cómo se ve el archivo en Excel.
Asignar las columnas
Relacione cada columna detectada con un campo de Personyze. Una clave es obligatoria — un ID interno (o el SKU / la URL de la página del producto). Asigne el resto a sus campos; añada, si quiere, un Preprocesamiento o una Máscara para limpiar un valor a su entrada.
💡 La clave debe coincidir con la clave de su catálogo. “Se importa bien pero no coincide con nada” es casi siempre un problema de claves.
Revisar e importar
Confirme la asignación e inicie la importación. Un archivo se carga una vez; un feed por URL, SFTP o API sigue sincronizándose desde ese momento — se vuelve a leer más o menos cada pocos minutos para que el stock, los precios y los registros nuevos se mantengan al día.
Listo ✓
Todos los catálogos en una sola pantalla, cada uno con su estado, su última sincronización y su propia forma de entrada. Los opcionales lo indican. Haga clic para ampliar.
La pantalla del catálogo, y lo que le dice
Configuración → Recomendaciones → Catálogo de productos (y Catálogo de artículos para los
contenidos) ya no es un simple formulario de subida. Es un tablero con todos los catálogos que alimentan el motor, cada uno con su propio
estado, así que “¿están mis datos dentro?” se responde mirando, en lugar de volviendo a importar:
Fila
Qué contiene
Feeds activos
Lo que mantiene el catálogo sincronizado, y si está Correcto.
Catálogo de productos
Los propios artículos, con su Última sincronización.
Intereses
Agrupar productos por tema.
Categorías
Las rutas de navegación que siguen los visitantes.
Vínculos manuales de venta cruzada / de venta adicional
Pares que usted indica, por archivo o a mano.
Venta cruzada generada por el sistema
Datos semilla, que ponen en marcha el motor hasta que toman el relevo los datos de compras reales.
Cada fila lleva su propio estado — Correcto, Configurado, Sin definir, Sin
configurar — y todo excepto el propio catálogo está marcado como opcional, para que en una primera
configuración se vea lo que de verdad es obligatorio.
Los datos llegan a cualquiera de ellos de las mismas cuatro formas: subida de archivo, feed por URL, SFTP o API REST. Cada
fila ofrece su propio Subir archivo o configurar feed RSS/Atom, así que no tiene que averiguar a qué pantalla corresponde un
catálogo concreto.
Dos claves, no una
Los productos se pueden asignar a hasta dos claves — ID interno y SKU —, para que los eventos del sitio se relacionen
con el identificador que emita su sitio. Se pueden añadir campos personalizados en cualquier momento; no hay que declarar nada
de antemano.
¿Qué columna es su ID interno?
Equivocarse aquí es el error más caro de un feed: el catálogo se llena, las recomendaciones se muestran
y nada coincide con lo que los visitantes vieron realmente. Por eso el importador lo responde con pruebas en lugar de con una suposición.
Compara cada columna candidata con los ID que su sitio ya está enviando e informa de lo que ha
medido — “coincide con el 96% de los IDs que tu sitio ya envía”, “ninguno de estos valores
aparece en lo que envía tu sitio”, “comprobado en las primeras 500 filas”. Las columnas que no pueden
ser una clave en absoluto — vacías en todas las filas de muestra, ausentes en algunas filas, idénticas a otra columna — se
marcan como tales.
Cuando todavía no han llegado eventos, recurre a otra fuente e indica en qué escalón está:
Medido con eventos reales — la respuesta en la que puede confiar.
Encontrado en la página del artículo — “todavía no ha llegado ningún evento, así que hemos leído una de tus páginas
de artículo”.
Mejor suposición, solo a partir de la forma del archivo — y lo dice: “contrástalo con
lo que envía tu sitio”.
{W}Asigne la URL además del ID. El asesor recomienda las dos — “Asignar ambos: “esta” como
ID interno y “aquella” como URL de la página del producto” — porque hacen trabajos distintos. El ID es lo que
llevan los eventos de carrito y de compra; la URL es lo que permite reconocer una página de entrada como página de producto.
Si solo asigna el ID, la segmentación por página de producto no tiene con qué coincidir.
Previsualizar antes de importar
El resumen Listo para importar incluye Previsualizar cambios — una ejecución de prueba que no escribe nada
y le dice lo que haría la ejecución real:
Cuántas filas son nuevas, han cambiado o no han cambiado. Estos recuentos acompañan a todas las ejecuciones, no solo a la
vista previa.
Qué columnas cambiarían — así un error de asignación aparece como “cambiaría el precio de todas las
filas” en lugar de como una sobrescritura silenciosa.
Hasta cinco ejemplos de antes y después, y hasta cinco de las claves nuevas. Limitado
a propósito: previsualizar un catálogo entero no debería enviar un megabyte de valores al navegador.
{I}Un recuento alto de “nuevas” en una reimportación es la señal de alarma. Reimportar un catálogo que ya
tiene debería dar casi todo sin cambios. Si casi todas las filas son nuevas, la columna clave es incorrecta, y la vista previa
es donde eso se ve claro, en lugar de después de que el catálogo se haya duplicado.
Cuatro formas de entregar un feed
En el primer paso del asistente (Fuente de carga) elige cómo llegan los datos a Personyze. En realidad, la elección depende de con qué frecuencia cambian.
1 Subir un archivo — CSV, TSV o XLSX desde su ordenador. Una instantánea; lo mejor para listas puntuales y exportaciones pequeñas. 2 Feed por URL / RSS / Atom — pegue una URL pública; Personyze la consulta periódicamente (más o menos cada 10 minutos). Lo mejor para un catálogo o una lista que su plataforma o un servicio de feeds mantiene al día. 3 Push por SFTP — deja archivos en un endpoint SFTP configurado. Lo mejor para exportaciones nocturnas grandes desde un almacén de datos. 4 Push por API JSON — envíe registros por POST desde su backend en tiempo real.
Puntual o pequeño → subir un archivo. La forma más rápida de cargar una lista una vez.
Actualizado automáticamente → feed por URL. Apunte Personyze a una URL de feed en directo — un feed de Google Shopping, una exportación de un servicio de feeds, el feed de productos de su plataforma — y lo volverá a leer periódicamente, así que el stock, los precios y los productos nuevos se mantienen al día sin que tenga que volver a subir nada. Es la opción habitual para un catálogo de productos.
Grande y programado → SFTP. Para volcados nocturnos grandes cuando una URL pública no es adecuada. Puede configurar su propia cuenta de SFTP en un par de clics — sin tener que pedírselo a nadie.
En tiempo real y con su propio backend → push por API. Envíe los registros por POST a medida que cambian.
Un feed por URL, SFTP o API sigue sincronizándose después de la primera importación; una subida de archivo es una instantánea de un momento concreto que se vuelve a subir para actualizarla.
Entrega de archivos por SFTP — deje los archivos y olvídese
SFTP es la opción sin intervención. Obtiene una cuenta de subida privada, su script de exportación deja los archivos en su carpeta /upload y cada nueva subida se importa automáticamente unos minutos después de terminar. Nadie hace clic en nada en el panel.
Dónde encontrarlo: sus credenciales de SFTP están en Configuración → Perfil del sitio, en la sección Entrega de archivos por SFTP — es la página que debe abrir cada vez que necesite el host, el usuario o una contraseña nueva. La misma tarjeta de credenciales aparece también allí donde el asistente de importación ofrece SFTP como fuente: Seguimiento de productos y de artículos, las pantallas de catálogo de productos y de artículos, y Atributos de visitantes.
Configuración → Perfil del sitio → Entrega de archivos por SFTP. Un botón configura la cuenta; la tabla de debajo es toda la regla de enrutamiento — el nombre del archivo decide en qué se convierte una subida. Haga clic para ampliar.
Configurar la cuenta
Haga clic en Configurar acceso SFTP.
Personyze crea una cuenta privada para usted. Mientras trabaja muestra “Configurando tu cuenta SFTP; normalmente tarda menos de 5 minutos”, y se rellena sola cuando está lista. Puede salir de la página y volver.
Después, la tarjeta muestra su Host (sftp://upload.personyze.com), su Usuario y su Contraseña — con los botones Mostrar y Copiar.
Una sola cuenta sirve para todos los tipos de archivo de abajo, y pertenece a este perfil del sitio. Ponga todos los archivos en la carpeta /upload — no se recoge nada de ningún otro sitio.
Una vez creada la cuenta, la tarjeta muestra todo lo que necesita para conectarse. La contraseña permanece oculta hasta que pulsa Mostrar o Copiar. Haga clic para ampliar.
La contraseña solo se obtiene cuando pulsa Mostrar o Copiar, nunca con la propia página — así no aparece en el código fuente de la página ni en los registros. Rotar contraseña emite una nueva, y la anterior deja de funcionar en unos minutos, así que cámbiela a la vez en su tarea de exportación. Si soporte configuró su cuenta a mano en el pasado, no hay ninguna contraseña guardada que mostrar; rótela una vez y tendrá una que pueda ver.
El nombre del archivo decide qué es una subida
No hay configuración por subida. El importador enruta cada archivo por su nombre; la extensión solo le indica el formato. Sirven tanto el singular como el plural — product.csv es lo mismo que products.csv.
Extensiones aceptadas: .csv, .json, .xml, .xls, .xlsx. Volver a subir un archivo más reciente lo reimporta — gana el archivo más reciente que coincida —, así que una tarea nocturna puede simplemente sobrescribir el mismo nombre cada vez.
La primera subida: asignarla una vez
Un archivo tiene que estar asignado antes de que se importe nada de él — hay que decirle a Personyze qué columna contiene qué. No lo configura por adelantado: primero deje el archivo, y el panel vendrá a usted.
A los pocos minutos de terminar la subida, aparece un aviso en la pantalla de destino — para users.csv es Configuración → Atributos de visitantes, en Listas de usuarios importadas:
En tu carpeta SFTP: users.csv 1 KB · subido hace 36 min Todavía sin asignar, así que no se está importando nada de él: a Personyze no se le ha dicho qué columna del archivo contiene qué.
Junto a él hay dos botones: Comprobar de nuevo, que vuelve a revisar la carpeta, y Asignar este archivo, que abre la asignación.
El diálogo de asignación
Asignar «users.csv» desde tu carpeta SFTP muestra todo lo que ha deducido del propio archivo:
Nombre de la lista (solo en los feeds de usuarios) — todas las personas del archivo se unen a esta lista, y la lista es lo que segmentan sus campañas. No tiene que crearla antes; al darle nombre aquí se crea.
Una fila por columna, con la columna en el archivo, el campo de perfil al que se asigna y valores de muestra leídos de su propio archivo — para que vea de un vistazo que CRM ID ha ido a parar de verdad a SFTP-TEST-1 y no a otra cosa.
Una línea de resumen: cuántas columnas se han encontrado, cuántas están asignadas y cuántas filas tiene el archivo. Todo lo que se quede en Ignorar no se importa.
Haga clic en Guardar la asignación y el archivo se importa. Es un paso único por nombre de archivo — a partir de entonces, cada subida de users.csv se importa sola con la misma asignación.
Mientras un archivo no esté asignado, no pasa nada — y nada se lo dice a su script. La subida en sí ha funcionado, así que una tarea de exportación ve un éxito mientras los datos siguen sin leerse. Si ha enviado un archivo y las cifras no se han movido, abra la pantalla de destino y busque el aviso de arriba.
Una vez que un feed está en marcha, puede activar Avísame por email si este feed deja de sincronizarse en la misma pantalla — la forma más barata de enterarse de que la exportación de anoche no llegó. La lista de fuentes también se puede filtrar según su procedencia: Subido, RSS / Atom, SFTP o Push por API.
La regla de formato más importante
El importador de archivos de Personyze usa comas como delimitador, y eso no se puede cambiar en el paso de subida. Ese único hecho determina todas las decisiones de formato:
Las columnas se separan con comas. No con punto y coma, ni con barras verticales, ni con tabulaciones (para un feed realmente separado por tabulaciones, vea la nota sobre TSV más abajo).
Si un valor dentro de una celda contiene una coma, esa celda debe ir entre comillas dobles, o el importador la divide en columnas adicionales.
Es CSV estándar, pero es la razón más habitual por la que una importación se comporta mal, así que conviene decirlo claramente.
Ejemplo práctico: intereses de producto
Los intereses son una lista de etiquetas por producto — se usan para la venta cruzada, los segmentos por afinidad y las recomendaciones basadas en intereses. El formato que funciona son dos columnas, Id y Interest, con los intereses separados por comas dentro de una celda entre comillas:
La celda Interest de cada producto contiene un conjunto de etiquetas distinto. Las comillas son lo que permite que se mantengan las comas interiores. Sin ellas, NW-1001,"Sneakers,Footwear,Casual,Running" se convierte en cinco columnas en lugar de dos, y la importación falla.
📥 Descargue el archivo de intereses de ejemplo — ábralo en un editor de texto sin formato (no en una hoja de cálculo) para ver el entrecomillado exactamente como lo necesita el importador.
Separadores — qué funciona y qué no
Objetivo
¿Funciona?
Cómo
Intereses separados por comas en una sola celda
Sí
Ponga la celda entre comillas: "Sneakers,Footwear,Running"
Intereses divididos en una columna cada uno
Sí
Asigne todas las columnas de intereses al mismo campo Intereses
Barra vertical / barra / punto y coma entre intereses
No
El campo Intereses solo acepta comas
Punto y coma como delimitador de columnas
No
El paso de subida está fijado en la coma
Comas sin comillas dentro de una celda
No
El importador las divide en columnas nuevas
Nota sobre TSV: el asistente acepta .tsv, y un feed realmente separado por tabulaciones (como un feed de Google Shopping) se importa sin problemas — las tabulaciones son el delimitador, así que las comas dentro de las descripciones son solo texto. La regla de las comas de arriba se refiere en concreto a los archivos separados por comas.
La misma idea para un campo de categoría
El patrón de la coma en una celda entre comillas no es solo para los intereses — cualquier campo que contenga más de un valor funciona igual. Un campo de categoría es el segundo caso habitual. Dos formas de representarlo, las dos válidas:
Una ruta jerárquica en una sola celda — la convención de los feeds de Google, con > entre niveles. Sin comas, así que no hacen falta comillas:
Varias categorías en una sola celda — si un producto pertenece a varias, sepárelas con comas dentro de comillas, exactamente igual que los intereses:
Category
"Sneakers,Footwear,Running"
La regla es siempre la misma: una coma dentro de un valor significa que la celda debe ir entre comillas. Una ruta delimitada con >o con /no tiene comas, así que va sin comillas.
Llevar campos adicionales en el mismo archivo
No necesita un archivo aparte por atributo. Una fila puede llevar la clave más los intereses, la categoría y cualquier otra cosa que quiera en el registro — marca, disponibilidad, una etiqueta personalizada —, y usted asigna cada columna en el paso Elegir columnas:
Solo las celdas Interest entre comillas contienen comas, así que solo ellas van entre comillas; el resto van como columnas normales. Asigne Id → Internal ID, Interest → Interests, y cada columna restante a su campo de Personyze.
Toda importación necesita una columna clave, o Siguiente sigue desactivado con un “Falta una asignación obligatoria” en rojo:
ID interno — la clave del registro (ID del producto, ID del usuario).
URL de la página del producto — la URL completa de la página, como clave alternativa.
La clave debe coincidir con la clave que ya usa el catálogo. Si su catálogo usa el SKU como clave, la columna Id del archivo debe contener ese mismo SKU. Una importación que termina pero “no coincide con ningún producto” casi siempre es un problema de claves — los ID se cargaron bien, simplemente no coinciden.
Asignar las columnas
En el paso Elegir columnas, Personyze muestra cada columna detectada y le permite asignarla a un campo de Personyze, con un Preprocesamiento y una Máscara opcionales por columna.
El paso de asignación de columnas. Personyze indica cuántas columnas ha detectado y muestra filas de muestra, para que confirme que el archivo se ha leído bien antes de asignar.
El recuento de columnas de este paso es su comprobación del análisis. Para el archivo de intereses de dos columnas debe decir Se detectaron 2 columnas de origen. Si dice 6, el entrecomillado se perdió al exportar — corríjalo y vuelva a subirlo. Juzgue por lo que indica este paso, no por cómo se ve el archivo en Excel o en Numbers.
Para los intereses: asigne Id → ID interno (desaparece el error rojo), asigne Interest → Intereses, deje Preprocesamiento = Pasar tal cual y Máscara = Pasar todo, y continúe hasta Listo para importar.
Crear el archivo (receta repetible)
Si tiene una exportación de origen con una columna de intereses unidos por comas, genere el archivo de dos columnas entre comillas con unas pocas líneas de Python — csv.writer añade automáticamente las comillas alrededor de cualquier campo que contenga una coma:
import csv
rows = list(csv.DictReader(open('source.csv', encoding='utf-8-sig')))
with open('Id_Interest.csv', 'w', newline='', encoding='utf-8-sig') as f:
w = csv.writer(f) # quotes cells with commas automatically
w.writerow(['Id', 'Interest'])
for r in rows:
ints = ','.join(x.strip() for x in r['Interests'].split(',') if x.strip())
w.writerow([r['Product ID'], ints])
Feeds de catálogo de productos
Un catálogo de productos usa como clave un identificador de producto — y puede aportar ID interno, SKU o ambos. Solo una clave es obligatoria.
Cuando no tiene un ID de producto
Si su catálogo no tiene un ID estable, Personyze puede generar uno automáticamente a partir de un hash de la URL de la página del producto. Basta para reconocer un producto en las páginas vistas y los añadidos al carrito — la URL es siempre la misma, así que el hash es estable.
Es en el seguimiento de compras donde un hash de la URL resulta incómodo. Una página de agradecimiento o de confirmación del pedido no suele llevar las URL de los productos comprados, así que no hay nada de lo que calcular el hash. Registrar compras con ID de hash es posible, pero la configuración es delicada. Es mucho más sencillo cuando tiene un ID de producto real que Personyze puede obtener automáticamente de una variable de la página — un valor de la dataLayer, una variable del gestor de etiquetas o un campo del DOM —, porque ese mismo ID relaciona el catálogo, el comportamiento en el sitio y la compra. Si vende, use un ID real. La alternativa del hash de la URL es para la personalización por vistas o clics cuando no existe ningún ID.
El archivo del catálogo
Un catálogo de productos usa más columnas, pero las mismas reglas. Una disposición típica:
Internal ID, SKU, Title, Product Page URL, Main Image URL,
Price, Sale Price, Is in Stock, Rating
Asigne ID interno como clave, URL de la imagen principal y URL de la página del producto para que las tarjetas se muestren y enlacen, y Precio / Precio de oferta / En stock para que los widgets puedan mostrar precios, descuentos e insignias de stock. Las celdas vacías no son un problema — un Precio de oferta en blanco solo significa que no hay descuento.
📥 Descargue el archivo de catálogo de productos de ejemplo — la disposición de columnas real que usa una tienda en funcionamiento.
Para un catálogo en vivo, la configuración práctica es un feed por URL: apunte Personyze a un feed que su plataforma o un servicio de feeds ya genere. Un feed estándar de Google Shopping / Merchant (TSV, con id, title, link, price, availability, image_link, product_type, etc.) funciona directamente — Personyze lee esas columnas y vuelve a consultar la URL para que el stock y los precios se mantengan al día. Si aún no tiene un feed, herramientas como Feedoptimise, DataFeedWatch o la exportación nativa de su plataforma generan uno.
Cada producto necesita una imagen principal para que las tarjetas de recomendación se puedan mostrar. Puede añadir más columnas de imagen además de esa — las imágenes adicionales alimentan los widgets que rotan o cambian la foto al pasar el ratón. Asigne la primera a URL de la imagen principal y el resto a los campos de imagen adicionales.
Lleve tantos campos personalizados como quiera
Además de las columnas estándar, una fila del feed puede contener cualquier dato adicional que tenga — precio del envío, precios por volumen, precios por tipo de cliente, etiquetas, marca, color, lo que sea. Tres cosas que puede hacer con un campo personalizado:
Mostrarlo — en la tarjeta de recomendación (un indicador de “Envío gratis”, un precio para socios).
Filtrar por él — limitar una recomendación a una marca, un color o una categoría.
Entrenar a la IA con él — dar al modelo de recomendación más señal sobre cada producto para que ordene mejor.
La mayoría de las veces son atributos sencillos como la marca o el color; no hay límite, y las columnas sin asignar simplemente se ignoran.
Precios por comprar juntos / condicionales
También puede llevar en el feed un precio por combinación — un precio con descuento que se aplica cuando se compran juntos productos concretos —, para que el precio de un pack salga directamente del catálogo en lugar de calcularse. El concepto y la configuración están en Descuento por comprar juntos para las recomendaciones de e-commerce. (Aquí se añadirá la disposición exacta de las columnas para los precios por combinación.)
Feeds de catálogo de contenidos
Un catálogo de contenidos (artículos, vídeos, guías) alimenta las recomendaciones de contenido. La versión más ligera es solo la URL del contenido — Personyze genera automáticamente un ID y registra la interacción por la URL o la ruta de la URL, así que las vistas y las lecturas se atribuyen correctamente sin que tenga que aportar una clave. También puede aportar su propio ID interno si lo tiene.
Todo lo demás funciona como en el catálogo de productos: una imagen principal (más, opcionales, para los widgets con cambio al pasar el ratón), más las columnas personalizadas que quiera mostrar, filtrar o usar para entrenar — tipo de contenido, categoría, autor, fecha de publicación, etiquetas.
Feeds de listas de usuarios (enriquecimiento con el CRM para la segmentación)
Una lista de usuarios asocia datos del CRM a sus visitantes. Lo mínimo es una clave más un atributo:
Email (o un ID interno / de CRM) como clave, y
al menos una columna adicional — nombre, tipo de cuenta, lo que sea.
Puede añadir tantas columnas de atributos como quiera. Lo importante: todo lo que rellene aquí queda disponible para la segmentación, no solo dentro de la acción que usa la lista. Cargue el nombre o el tipo de cuenta de un visitante y después podrá crear una audiencia que segmente por él — “Tipo de cuenta es VIP”, “Sector es Retail” —, exactamente igual que con cualquier otro campo de perfil. Entréguelo como archivo, o manténgalo sincronizado por SFTP o con una URL de feed.
Pares de venta cruzada y venta adicional (en el catálogo de productos)
Dónde:Configuración → Recomendaciones → Catálogo de productos. Debajo de los feeds y los campos, la pantalla del catálogo tiene dos secciones opcionales para indicar a Personyze qué productos van juntos. Las dos son opcionales — el motor también aprende los emparejamientos por sí solo a partir del comportamiento en vivo —, pero son útiles para lanzar antes de tener datos, o para los emparejamientos que quiere controlar a mano.
La pantalla Catálogo de productos (Configuración → Recomendaciones → Catálogo de productos): su catálogo, más las secciones opcionales Vínculos manuales de venta cruzada, Vínculos manuales de venta adicional y Venta cruzada generada por el sistema (datos semilla). Haga clic para ampliar.
Vínculos manuales de venta cruzada / venta adicional (opcional)
Emparejamientos explícitos que usted define — los vínculos de “se compran juntos con frecuencia” o “quizá también quiera”. Se usan cuando el algoritmo de una campaña de recomendaciones está configurado como “Venta cruzada (manual)” o “Venta adicional (manual)”:
Venta cruzada empareja un producto base con un artículo recomendado.
Venta adicional empareja un producto base con un artículo de más valor.
Añada pares a mano, o importe un archivo — un vínculo por fila, el producto de origen y el vinculado, ambos por su ID interno. Los vínculos son direccionales, así que para recomendar en los dos sentidos añada las dos filas:
Subject Internal ID,Linked Internal ID
AQB14X,AQB15X
AQB15X,AQB14X
BARR4FJ3,LABAR4114
Venta cruzada generada por el sistema — datos semilla (opcional)
Una forma de poner en marcha el motor de recomendación antes de que haya visto compras reales. Añade conjuntos semilla: le dice a Personyze que un par de productos se compró junto, y los recomienda el uno con el otro hasta que toman el relevo los datos de compras en vivo. Cada conjunto semilla es un artículo Asunto (el artículo base), un artículo Recomendado y la interacción que simula — “Comprado → Comprado” pone en marcha la venta cruzada de comprados juntos. Ideal para un catálogo totalmente nuevo sin datos de comportamiento todavía; cuando llegan las compras reales, pesan de forma natural más que las semillas.
1. Cree un conjunto semilla. En la tarjeta Venta cruzada generada por el sistema, haga clic en Nuevo conjunto semilla. Cada semilla empareja un producto Asunto con un producto Recomendado; elija qué Interacción simula (“Comprado → Comprado” pone en marcha la venta cruzada de comprados juntos) y, si quiere, defina la Tasa, el número de usuarios y las transacciones. Haga clic para ampliar.2. Elija los productos. Elija los productos Asunto y Recomendado en la lista con búsqueda (los dos deben estar ya en el catálogo) — cada combinación se convierte en un conjunto semilla — y haga clic en Agregar conjunto semilla. Haga clic para ampliar.3. Se refleja en la lista — la tarjeta pasa a Configurado y cada conjunto semilla muestra su par (con miniaturas), la interacción, la tasa y los recuentos de usuarios y transacciones. El motor recomienda ahora el par hasta que toman el relevo los datos de compras en vivo. Haga clic para ampliar.
Subir las compras pasadas permite a Personyze entrenar las recomendaciones con comportamiento de compra real y segmentar por el historial de compras desde el primer día, antes de haber observado esas compras en vivo. Cada fila es mínima — lo justo para decir quién compró qué, y cuándo:
una clave de cliente — email o ID de CRM;
el ID del producto o SKU que se compró;
la hora de la transacción.
No hace falta título, cantidad, precio ni moneda — Personyze los lee del catálogo. Para la marca de tiempo, use una fecha y hora estándar como 2026-07-21 14:30:00 o una época Unix como 1751389200. (Si tiene dudas, confirme con su gestor de cuenta el formato exacto que se acepta.)
Además de los tipos anteriores, el mismo asistente carga cualquier dato tabular — tablas de afinidad, listas de segmentos, conjuntos de atributos personalizados. Elija el método de entrega, dé bien el formato, asigne una clave y asigne el resto.
Un catálogo de contenidos (artículos, vídeos, guías) funciona igual — las columnas clave pasan a ser el ID y la URL del contenido, con el título, la imagen y los atributos por los que quiera recomendar o segmentar. Lo mismo vale para las tablas de venta cruzada, los datos de afinidad y las listas de usuarios del CRM: elija el método de entrega, dé bien el formato, asigne una clave y asigne el resto.
Terminar la importación
El último paso: revise la asignación e inicie la importación. Un archivo es una carga única; un feed por URL, SFTP o API sigue sincronizándose según su calendario desde ese momento.
Resolución de problemas
Síntoma
Causa
Solución
“Se detectaron 6 columnas de origen” (se esperaban 2)
La celda de intereses no estaba entre comillas, o las comillas se eliminaron al exportar
Vuelva a exportar con la celda entre comillas; confirme que el archivo sin procesar muestra "Sneakers,Footwear,..."
Toda la fila cae en una sola columna
Está juzgando por una hoja de cálculo, no por el importador
Guíese por lo que indica el paso 2/3, no por Excel ni por Numbers
“Falta una asignación obligatoria” (en rojo)
No hay ningún ID interno ni URL de la página del producto asignados
Asigne su columna clave a ID interno (o a URL de la página del producto)
Los intereses se importan como una sola cadena larga
El separador no es una coma
Use comas entre los intereses, nada más
Se importa bien pero no coincide con ningún producto
El Id no coincide con la clave del catálogo
Use el identificador con el que está indexado el catálogo (a menudo el SKU)
Leer un valor en directo de la página
Aparte de la importación de archivos: Personyze también puede leer un valor en directo de una página de producto mientras los visitantes navegan — útil cuando el dato no está en un feed. Esa vía usa un selector CSS o JavaScript en lugar de un archivo, y se explica en Obtener datos de su sitio. Dos notas de campo que conviene tener en cuenta:
Las metaetiquetas no se pueden seleccionar con el selector en la página — están en <head> y no se muestran. Escriba el selector a mano, p. ej. meta[property="og:type"].
En las tiendas renderizadas con JS (VTEX, React), las metaetiquetas y las etiquetas og pueden estar vacías al cargar la página y solo rellenarse después de la hidratación, o servirse solo a los robots de los buscadores mediante prerenderizado. Un selector que no devuelve nada suele deberse a ese desfase de tiempos o de prerenderizado, no a un selector erróneo. Un elemento renderizado en el servidor es más fiable. La dataLayer de GTM también lleva la referencia — pero en las tiendas de una sola página léala con cuidado, porque la dataLayer se acumula entre productos y una entrada anterior puede ser el artículo que se vio antes.
En resumen
Archivo delimitado por comas; ponga entre comillas cualquier celda que contenga una coma; asigne una columna clave (ID interno o URL de la página del producto) que coincida con la clave de su catálogo; asigne el resto. Suba un archivo para una carga puntual, o apunte Personyze a un feed por URL, SFTP o API para mantenerlo sincronizado.
