Formato del catalogo

Fanplayr elabora nativamente i dati dei prodotti nel formato descritto in questa documentazione. Fornire il catalogo in questo formato è il percorso consigliato e garantisce l'esperienza di integrazione più fluida.

Se la tua piattaforma non è in grado di produrre direttamente questo formato, parlane con il tuo account manager per esplorare le opzioni. Indipendentemente da come vengono consegnati i tuoi dati, comprendere questa struttura è prezioso: ti dice con cosa Fanplayr sa lavorare e più dati di prodotto puoi fornire, migliori saranno i consigli e il targeting di Fanplayr.

TIP

Pronto per l'implementazione? Consulta il Riferimento dei campi per le specifiche tecniche complete.

Concetti chiave

Prodotti e varianti

Fanplayr modella i prodotti utilizzando una relazione PRODOTTO PRINCIPALE / VARIANTE, che corrisponde al modo in cui la maggior parte degli e-commerce organizza il proprio inventario.

Un PRODOTTO PRINCIPALE è il prodotto di livello superiore così come appare nel tuo catalogo, ad esempio, una "Scarpa da corsa classica". Un prodotto VARIANTE è una variazione specifica di quel prodotto principale, ad esempio, la stessa scarpa nella taglia 43, colore blu.

PRIMARY: Scarpa da corsa classica  // id: "shoe-001"
├── VARIANT: Taglia 8 / Rossa      // id: "shoe-001-8-red", primaryProductId: "shoe-001"
├── VARIANT: Taglia 8 / Blu
├── VARIANT: Taglia 10 / Rossa
└── VARIANT: Taglia 10 / Blu

Le varianti condividono la maggior parte dei loro attributi con il prodotto PRINCIPALE genitore (come titolo, descrizione e marca) ma differiscono in attributi come taglia, colore e prezzo.

Perché questo è importante: i consigli di Fanplayr operano al livello di prodotto PRINCIPALE per impostazione predefinita. Fornire dati accurati sulle varianti consente a Fanplayr di considerare la disponibilità e i prezzi in tempo reale di tutte le varianti quando fornisce consigli.

Come si mappa ai tuoi dati

Il tuo negozio potrebbe riferirsi a questi come "prodotti padre/figlio", "prodotti configurabili/semplici", o semplicemente elencare ogni variante come SKU separato. Qualsiasi di questi può essere mappato al modello PRODOTTO PRINCIPALE/VARIANTE.

Categorie

Fanplayr utilizza le categorie di prodotti per comprendere la struttura del tuo catalogo e per alimentare consigli e targeting basati sulle categorie.

Le categorie dovrebbero rappresentare il percorso di navigazione completo di un prodotto nel tuo negozio, utilizzando > come separatore:

"Scarpe e Accessori > Scarpe > Tacchi"
"Sport e Fitness > Abbigliamento Sportivo > Scarpe"

Un prodotto può appartenere a più categorie. Più precisi e completi sono i tuoi percorsi di categoria, migliore sarà la capacità di Fanplayr di indirizzare i consigli all'interno di sezioni specifiche del tuo negozio.

Prezzi

Fanplayr supporta sia un prezzo corrente sia un prezzo originale (il prezzo prima di qualsiasi sconto). Fornire entrambi consente a Fanplayr di:

• Visualizzare prezzi accurati nei widget di raccomandazione
• Identificare e indirizzare prodotti in saldo e scontati
• Riportare il profitto lordo quando vengono forniti anche i dati sui costi

Disponibilità

Fanplayr tiene traccia della disponibilità dei prodotti in modo che i prodotti esauriti non vengano consigliati agli acquirenti. Gli stati di disponibilità supportati sono:

Valore	Significato
IN_STOCK	Disponibile per l'acquisto ora
OUT_OF_STOCK	Attualmente non disponibile
PREORDER	Non ancora rilasciato, ma disponibile per il pre-ordine
BACKORDER	Temporaneamente esaurito, ma disponibile per il backorder

Immagini

Le immagini dei prodotti vengono visualizzate direttamente nei widget di raccomandazione mostrati agli acquirenti. Fornire immagini di alta qualità a 500×500px o più grandi garantisce che i consigli siano visivamente accattivanti ed efficaci.

Pubblico, Colore e altri attributi

Campi come audience (genere, fascia d'età), colorInfo, sizes, materials e patterns aiutano Fanplayr a comprendere la natura di ogni prodotto in modo più dettagliato. Questi attributi migliorano la rilevanza dei consigli, ad esempio, assicurando che una scarpa da uomo non venga consigliata su una pagina di categoria da donna.

Questi campi sono opzionali ma preziosi, in particolare per i negozi con gamme di prodotti ampie e variegate.

---

Campi richiesti in sintesi

I seguenti campi sono il minimo necessario affinché Fanplayr possa indicizzare e raccomandare un prodotto in modo efficace:

Campo	Descrizione
id	Identificatore di prodotto univoco - deve corrispondere all'ID tracciato nella tua integrazione Fanplayr
title	Il nome del prodotto
categories	Almeno un percorso di categoria
priceInfo	Prezzo corrente e codice valuta
uri	URL della pagina del prodotto

Tutti gli altri campi sono opzionali, ma fornire dati più ricchi migliora la qualità delle raccomandazioni.

Formato del file catalogo

Il formato del file catalogo prodotti ha i seguenti requisiti:

• Ogni elemento del catalogo deve essere contenuto su una singola riga.
• La dimensione totale del file non deve superare i 50 MB non compressi. Se il tuo catalogo supera questa dimensione, dividilo e importalo in più file.
• Tutti gli elementi devono utilizzare la stessa lingua e valuta. Non è possibile mescolare lingue o valute all'interno di un singolo catalogo, in quanto ciò influenzerebbe l'addestramento del modello AI. Gestisci cataloghi separati se il tuo negozio ha più visualizzazioni con lingue o valute diverse.

Di seguito viene mostrato un file catalogo valido contenente due prodotti:

{"id":"SHOE-001","type":"PRIMARY","categories":["Donne > Scarpe","Sport e Fitness > Abbigliamento sportivo > Scarpe"],"title":"Scarpa da corsa classica","description":"Scarpa da corsa leggera per tutti i giorni con suola ammortizzata.","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":["Bianco"],"colors":["Bianco Nuvola"]},"sizes":["US:WOMENS:7","US:WOMENS:8","US:WOMENS:9","US:WOMENS:10"],"audience":{"genders":["female"],"ageGroups":["adult"]}}
{"id":"JACK-042","type":"PRIMARY","categories":["Uomini > Abbigliamento > Giacche","Saldi > Uomini"],"title":"Giacca in lana merino","description":"Giacca in lana merino slim-fit adatta per occasioni smart casual.","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":["Grigio"],"colors":["Antracite"]},"sizes":["US:MENS:S","US:MENS:M","US:MENS:L","US:MENS:XL"],"audience":{"genders":["male"],"ageGroups":["adult"]}}

Prossimi passi

• Leggi il Riferimento dei campi per le specifiche complete di ogni campo supportato, inclusi tipi, vincoli ed esempi.
• Parla con il tuo team di integrazione Fanplayr su come il tuo feed di prodotti esistente si mappa a questa struttura.

Formati legacy

Una versione precedente del formato del catalogo è disponibile anche per riferimento. Le nuove integrazioni dovrebbero utilizzare il formato attuale.

Visualizza il riferimento del formato legacy →