Formato del Catálogo

Fanplayr consume datos de productos de forma nativa en el formato descrito en esta documentación. Proporcionar su catálogo en este formato es la vía recomendada y garantiza la experiencia de integración más fluida.

Si su plataforma no puede producir este formato directamente, hable con su gerente de cuenta sobre sus opciones. Independientemente de cómo se entreguen sus datos, comprender esta estructura es valioso, ya que le indica con qué sabe trabajar Fanplayr, y cuantos más datos de productos pueda proporcionar, mejores serán las recomendaciones y la segmentación de Fanplayr.

TIP

¿Listo para implementar? Consulte la Referencia de Campos para ver la especificación técnica completa.

Conceptos Fundamentales

Productos y Variantes

Fanplayr modela los productos utilizando una relación PRINCIPAL / VARIANTE, lo que se corresponde con la forma en que la mayoría de las tiendas de comercio electrónico organizan su inventario.

Un producto PRINCIPAL es el producto de nivel superior tal como aparece en su catálogo, por ejemplo, una "Zapatilla Clásica de Correr". Un producto VARIANTE es una variación específica de ese producto principal, por ejemplo, la misma zapatilla en talla 10, color Azul.

PRIMARY: Classic Running Shoe  // id: "shoe-001"
├── VARIANT: Size 8 / Red      // id: "shoe-001-8-red", primaryProductId: "shoe-001"
├── VARIANT: Size 8 / Blue
├── VARIANT: Size 10 / Red
└── VARIANT: Size 10 / Blue

Las variantes comparten la mayoría de sus atributos con su producto PRINCIPAL padre (como el título, la descripción y la marca), pero difieren en atributos como la talla, el color y el precio.

Por qué es importante: Las recomendaciones de Fanplayr operan a nivel de producto PRINCIPAL por defecto. Proporcionar datos precisos de las variantes permite a Fanplayr tener en cuenta la disponibilidad y los precios en tiempo real de todas las variantes al hacer recomendaciones.

Cómo se mapea esto a sus datos

Su tienda puede referirse a estos como "productos padre/hijo", "productos configurables/simples", o simplemente listar cada variante como un SKU separado. Cualquiera de estos puede mapearse al modelo PRINCIPAL/VARIANTE.

Categorías

Fanplayr utiliza las categorías de productos para comprender la estructura de su catálogo y para potenciar las recomendaciones y la segmentación basadas en categorías.

Las categorías deben representar la ruta de navegación completa de un producto en su tienda, utilizando > como separador:

"Shoes & Accessories > Shoes > Heels"
"Sports & Fitness > Athletic Clothing > Shoes"

Un producto puede pertenecer a múltiples categorías. Cuanto más precisas y completas sean sus rutas de categoría, mejor podrá Fanplayr dirigir las recomendaciones dentro de secciones específicas de su tienda.

Precios

Fanplayr admite tanto un precio actual como un precio original (el precio antes de cualquier descuento). Proporcionar ambos permite a Fanplayr:

• Mostrar precios precisos en los widgets de recomendación
• Identificar y segmentar productos en oferta y con descuento
• Informar sobre el beneficio bruto cuando también se proporcionan datos de costo

Disponibilidad

Fanplayr rastrea la disponibilidad del producto para que los productos agotados no se recomienden a los compradores. Los estados de disponibilidad admitidos son:

Valor	Significado
IN_STOCK	Disponible para comprar ahora
OUT_OF_STOCK	No disponible actualmente
PREORDER	Aún no lanzado, pero disponible para preordenar
BACKORDER	Temporalmente agotado, pero disponible para reservar (en espera de stock)

Imágenes

Las imágenes de los productos se muestran directamente en los widgets de recomendación mostrados a los compradores. Proporcionar imágenes de alta calidad de 500x500px o más grandes asegura que las recomendaciones sean visualmente atractivas y efectivas.

Audiencia, Color y Otros Atributos

Campos como audience (género, grupo de edad), colorInfo, sizes, materials y patterns ayudan a Fanplayr a comprender la naturaleza de cada producto con más detalle. Estos atributos mejoran la relevancia de las recomendaciones, por ejemplo, asegurando que un zapato de hombre no se recomiende en una página de categoría de mujer.

Estos campos son opcionales pero valiosos, especialmente para tiendas con gamas de productos amplias y variadas.

---

Campos Obligatorios de un Vistazo

Los siguientes campos son los mínimos necesarios para que Fanplayr indexe y recomiende un producto de manera efectiva:

Campo	Descripción
id	Identificador único del producto — debe coincidir con el ID rastreado en su integración de Fanplayr
title	El nombre del producto
categories	Al menos una ruta de categoría
priceInfo	Precio actual y código de moneda
uri	URL de la página del producto

Todos los demás campos son opcionales, pero proporcionar datos más enriquecidos mejora la calidad de las recomendaciones.

Formato del archivo de catálogo

El formato del archivo de catálogo de productos tiene los siguientes requisitos:

• Cada elemento del catálogo debe estar contenido en una sola línea.
• El tamaño total del archivo no debe exceder los 50 MB sin comprimir. Si su catálogo excede este tamaño, divídalo e impórtelo en varios archivos.
• Todos los elementos deben usar el mismo idioma y moneda. No es posible mezclar idiomas o monedas dentro de un mismo catálogo, ya que esto afectaría el entrenamiento del modelo de IA. Gestione catálogos separados si su tienda tiene múltiples vistas con diferentes idiomas o monedas.

A continuación se muestra un archivo de catálogo válido que contiene dos productos:

{"id":"SHOE-001","type":"PRIMARY","categories":["Women > Shoes","Sports & Fitness > Athletic Clothing > Shoes"],"title":"Classic Running Shoe","description":"Lightweight everyday running shoe with cushioned sole.","brands":["Stridewell"],"availability":"IN_STOCK","availableQuantity":142,"languageCode":"en","priceInfo":{"price":89.99,"originalPrice":119.99,"currencyCode":"USD"},"uri":"https://www.store.com/shoes/classic-running-shoe","images":[{"uri":"https://www.store.com/images/SHOE-001.jpg","width":500,"height":500}],"colorInfo":{"colorFamilies":["White"],"colors":["Cloud White"]},"sizes":["US:WOMENS:7","US:WOMENS:8","US:WOMENS:9","US:WOMENS:10"],"audience":{"genders":["female"],"ageGroups":["adult"]}}
{"id":"JACK-042","type":"PRIMARY","categories":["Men > Clothing > Jackets","Sale > Men"],"title":"Merino Wool Jacket","description":"Slim-fit merino wool jacket suitable for smart casual occasions.","brands":["Nordvik"],"availability":"IN_STOCK","availableQuantity":37,"languageCode":"en","priceInfo":{"price":149.00,"currencyCode":"USD"},"uri":"https://www.store.com/jackets/merino-wool-jacket","images":[{"uri":"https://www.store.com/images/JACK-042.jpg","width":500,"height":500}],"colorInfo":{"colorFamilies":["Gray"],"colors":["Charcoal"]},"sizes":["US:MENS:S","US:MENS:M","US:MENS:L","US:MENS:XL"],"audience":{"genders":["male"],"ageGroups":["adult"]}}

Próximos Pasos

• Lea la Referencia de Campos para obtener la especificación completa de cada campo admitido, incluyendo tipos, restricciones y ejemplos.
• Hable con su equipo de integración de Fanplayr sobre cómo su feed de productos existente se mapea a esta estructura.

Formatos Heredados

Una versión anterior del formato de catálogo también está disponible como referencia. Las nuevas integraciones deben usar el formato actual.

Ver la referencia del formato heredado →