El catálogo es aquello a partir de lo que recomienda Personyze: títulos, precios, imágenes, disponibilidad — y los nombres de los atributos que contiene son los que usa en los widgets, los filtros y la segmentación. Los feeds de productos y de contenidos comparten la misma estructura y las mismas opciones; todo lo que sigue se aplica a ambos.
Lo que permite el catálogo
- Los algoritmos de recomendación tienen artículos que ordenar y campos completos que mostrar.
- Los eventos de interacción se asocian a productos reales (los ID deben coincidir).
- Los filtros y la segmentación pueden usar cualquier campo que incluya — marca, categoría, margen, etiquetas.
Formas de cargarlo
| Vía | Cuándo |
|---|---|
| URL de feed en directo | Su feed de productos actual (el formato de Google Shopping sirve) — Personyze lo vuelve a leer periódicamente, así que el stock y los precios se mantienen al día. La opción recomendada por defecto. |
| Subida de hoja de cálculo | Sirve para una primera configuración o para un catálogo estable; vuelva a subirla para actualizar. Todas las fuentes de subida y la programación: subir feeds y archivos de datos. |
| Sincronización con la plataforma | Shopify y WooCommerce / sitemap de WP se sincronizan con un interruptor. |
| API REST | Envíe y actualice artículos mediante programación: products / articles. POST fusiona por internal_id, así que reenviar es seguro. |
Qué campos importan
- Obligatorios en la práctica:
internal_id(la clave con la que se relaciona todo),title, URL del artículo, imagen, precio,is_in_stock. - Recomendados: categoría (activa la lógica y la jerarquía de categorías), marca, precio de oferta.
- Cualquier otra cosa que envíe se convierte en un campo — utilizable en el diseño de las tarjetas, los filtros y la segmentación. Más datos significa widgets más completos; empiece con el conjunto obligatorio y vaya ampliándolo.

Editar y comprobar
El visor del catálogo (Configuración → Recomendaciones → Catálogo de productos, o el paso Catálogo del asistente) muestra lo que ha llegado — compruebe que las imágenes se ven, que los precios se interpretan bien y que los indicadores de stock tienen sentido. Los campos individuales se pueden editar ahí mismo; los precios condicionales también se gestionan aquí.
Errores habituales
- Los ID no coinciden con las interacciones — el
internal_iddel feed debe ser igual a lo que notifica su seguimiento de interacciones (confundir SKU e ID es el error clásico). - URL de imagen relativas — use URL absolutas para que los widgets puedan mostrarlas en cualquier sitio.
- Artículos agotados — manténgalos en el feed con
is_in_stock=0en lugar de eliminarlos, para que el historial y los filtros sigan intactos.