Riferimento ai campi del feed di prodotto per OpenAI

Funzionamento delle mappature predefinite

Il feed di prodotto per OpenAI utilizza un sistema di mappatura basato sui dati per trasformare i dati di prodotto di B2C Commerce nel formato richiesto da OpenAI. Quando è in grado di derivare un valore utilizzando gli attributi standard di B2C Commerce, B2C Commerce crea una mappatura predefinita che specifica la modalità di derivazione del valore:

• Mappature dei campi: Mappare direttamente a un singolo attributo di prodotto B2C Commerce, ad esempio nome, marca o prezzo.
• Mappature derivate: È possibile calcolare i valori da più attributi o applicare trasformazioni, ad esempio rimuovendo il codice HTML dalle descrizioni o formattando i prezzi con i codici di valuta.
• Mappature costanti: Utilizzare un valore fisso per tutti i prodotti. Ad esempio, is_eligible_checkout è sempre false. Il checkout istantaneo in ChatGPT non è supportato.
• Mappature di fallback: Mappare prima all'attributo principale, quindi eseguire il fallback su un'alternativa se l'attributo principale è vuoto per quel prodotto. Ad esempio, il titolo utilizza il nome, ricorrendo a masterProductName se il nome è vuoto.

È possibile personalizzare i campi contrassegnati come Sostituibili: Sì in Business Manager. Campi contrassegnati come sovrascrivibili: No sono gestiti dal sistema e visibili nella tabella Mappatura campi, ma non è possibile modificarne le mappature.

Formattazione automatica dei campi

B2C Commerce applica la formattazione automatica ai valori dei campi prima che vengano scritti nel feed. Questa formattazione avviene indipendentemente dal fatto che si mantenga la mappatura predefinita o la si sostituisca con un attributo diverso. Quando si sostituisce una mappatura predefinita, non è necessario adattare i dati del catalogo in modo che corrispondano al formato di OpenAI: B2C Commerce gestisce la trasformazione.

La formattazione si applica come segue:

• Date: I valori di data e dataora sono formattati in aaaa-mm-gg (ISO 8601). Le date non valide vengono omesse dal feed.
• Booleani: I valori vengono convertiti in true o false.
• Numeri: I valori numerici vengono formattati con la precisione richiesta (ad esempio, numeri interi senza decimali o due posizioni decimali per valutazioni e prezzi). I valori non validi o null vengono omessi.
• Prezzi: I valori positivi vengono formattati con due cifre decimali e concatenati con il codice della valuta.
• Descrizioni: I tag HTML vengono rimossi dal testo.
• Enumerazioni: Valori quali disponibilità e age_group vengono convalidati in base ai valori consentiti predefiniti.

Ereditarietà degli attributi personalizzati per le varianti

Quando si esegue il mapping di un attributo personalizzato a un campo OpenAI, B2C Commerce risolve automaticamente i valori degli attributi per le varianti di prodotto utilizzando la seguente catena di ereditarietà:

1. Prodotto variante: B2C Commerce controlla innanzitutto il valore dell'attributo nella variante di prodotto.
2. Gruppo di variazioni: Se la variante non ha il valore dell'attributo, B2C Commerce controlla il gruppo di variazioni (se pertinente).
3. Prodotto principale: Se il valore non è valido per il gruppo di variazioni, B2C Commerce controlla il prodotto principale.

Questa catena di ereditarietà garantisce che gli attributi personalizzati definiti a livello di master o di gruppo di variazioni vengano ereditati automaticamente dalle varianti senza richiedere l'immissione di dati duplicati.

Idoneità del prodotto

I prodotti visualizzati nel feed sono controllati da due livelli:

• Regole di filtro prodotto: Regole di inclusione ed esclusione configurabili che determinano quali prodotti vengono inviati a OpenAI. Per impostazione predefinita, le regole corrispondono a prodotti online e ricercabili, ma è possibile modificarle. Vedere Regole di filtro dei prodotti per il feed dei prodotti.
• Esclusioni automatiche: Indipendentemente dalle regole di filtro, B2C Commerce esclude sempre dal feed:
  • Prodotti principali (le varianti vengono invece esportate)
  • Gruppi di variazioni (le varianti vengono invece esportate)
  • Set di prodotti. ChatGPT non è in grado di gestire la selezione dinamica dei componenti richiesta dai set di prodotti. I bundle, che hanno componenti fissi, sono supportati e vengono inviati a OpenAI come prodotti autonomi.

Derivazione del prezzo di listino

Il campo prezzo viene mappato al prezzo normale (di listino) di un prodotto. B2C Commerce non dispone di un concetto di "prezzo di listino" incorporato; I team di storefront implementano i prezzi di listino utilizzando diverse strategie per i listini prezzi. Per soddisfare questa varietà, B2C Commerce ricava il prezzo di listino del feed in due passaggi:

1. Listino prezzi di listino selezionato. Se si seleziona un listino prezzi in Listino prezzi di listino nella scheda Impostazioni generali, B2C Commerce utilizza il prezzo di tale listino. Il menu a discesa contiene solo i listini prezzi attivi e i cui prezzi sono espressi nella valuta del feed. Se in seguito si disattiva il listino prezzi selezionato, riconfigurare il listino prezzi di listino in modo che punti a un listino prezzi diverso.
2. Percorso del listino prezzi di vendita. Se non si seleziona un listino prezzi di listino, B2C Commerce ricava il prezzo di listino dal listino prezzi di vendita selezionato dal motore di ricerca B2C Commerce per il prodotto. Il motore prezzi valuta tutti i listini prezzi applicabili al prodotto, non solo quelli attivi, e restituisce il prezzo migliore (più basso) insieme al relativo listino prezzi di origine. Da tale listino prezzi di vendita, B2C Commerce applica una delle due regole seguenti:
   • Se il listino prezzi di vendita ha un listino prezzi padre, B2C Commerce segue la catena principale fino alla radice e restituisce il prezzo dal listino prezzi radice. Questo corrisponde al comportamento predefinito degli storefront SFRA e SiteGenesis.
   • Se il listino prezzi di vendita non ha un listino prezzi principale, B2C Commerce restituisce il prezzo massimo in tutti i listini prezzi applicabili per il prodotto. Questo corrisponde al comportamento predefinito degli storefront PWA Kit.

Nota Se il prezzo di listino risolto è uguale al prezzo scontato, B2C Commerce compila solo il campo prezzo e omette sale_price dalla voce del feed del prodotto. In questo modo si evita di mostrare un prezzo barrato in ChatGPT per i prodotti che non sono in saldo.

L'impostazione del listino prezzi di listino nella scheda Impostazioni generali è il modo più affidabile per garantire che il prezzo di listino nel feed corrisponda a ciò che gli acquirenti vedono nello storefront, in particolare per gli storefront con logica di determinazione dei prezzi personalizzata, prezzi basati su zone o listini multivaluta.

Derivazione del prezzo di vendita

Il campo sale_price viene mappato all'attributo salePrice di B2C Commerce più la valuta configurata. Il valore salePrice non viene ricavato da un singolo listino prezzi: il motore prezzi di B2C Commerce seleziona il prezzo migliore (più basso) tra tutti i listini prezzi applicabili per il prodotto, indipendentemente dalla gerarchia del listino prezzi o dalla configurazione di una gerarchia.

Poiché lo stesso motore popola il prezzo visualizzato dal tuo storefront, il valore sale_price inviato a OpenAI corrisponde a ciò che gli acquirenti vedono sul tuo sito.

Se il prezzo scontato risolto è uguale al prezzo di listino risolto (campo prezzo ), B2C Commerce omette sale_price dalla voce del feed del prodotto. In questo modo si evita di mostrare un prezzo barrato in ChatGPT per i prodotti che non sono effettivamente in saldo. Vedere Derivazione del prezzo di listino.

Se lo storefront utilizza una logica di determinazione dei prezzi personalizzata, ad esempio la selezione del listino prezzi in base alla zona o in base all'area geografica, il calcolo del prezzo scontato predefinito potrebbe non corrispondere a quello visualizzato dagli acquirenti. In questi casi, l'impostazione del listino prezzi di listino nella scheda Impostazioni generali è il modo più affidabile per allineare il feed allo storefront.

Campi obbligatori

I seguenti campi sono obbligatori per una voce di feed di prodotto valida. I prodotti a cui mancano i campi obbligatori sono comunque inclusi nel feed, ma OpenAI potrebbe rifiutare quelle singole righe. Utilizza l'anteprima del feed di prodotto per identificare i prodotti con campi obbligatori mancanti e correggerli prima di attivare la sincronizzazione giornaliera dei feed. Vedere Anteprima del feed di prodotto.

Avvertenza Se a più del 30% dei tuoi prodotti mancano i campi obbligatori, OpenAI potrebbe rifiutare l'intero feed. Verificare che i dati del catalogo siano completi prima di attivare la sincronizzazione giornaliera dei feed.

Nota Alcuni campi obbligatori non hanno una mappatura predefinita. Configurare questi campi in Business Manager prima di generare il feed. Si dividono in due gruppi:

• Nella scheda Impostazioni generali, nella sezione Dettagli attività, configurare quanto segue:
  • seller_name: Il nome del tuo negozio o del tuo marchio come mostrato agli acquirenti in ChatGPT.
• Configurare nella scheda Catalogo, nella sezione Mappatura campi, utilizzando Sostituisci con valore o modello costante:
  • seller_url: Un URL che rimanda alla home page dello storefront.
  • return_policy: Un URL che rimanda alla pagina relativa alla politica di restituzione.

Campi facoltativi

I seguenti campi sono facoltativi e possono migliorare i tuoi elenchi di prodotti in ChatGPT. I campi facoltativi vengono omessi dal feed quando l'attributo mappato o il valore costante è vuoto.