I tuoi clienti hanno iniziato a chiedere a ChatGPT cosa acquistare. “Uno zaino da cabina che stia sotto il sedile”, “un ventilatore silenzioso per una camera da letto piccola”, e l’assistente può rispondere con prodotti reali: immagini, prezzi e un link a un negozio. Dati di prodotto accurati aiutano ChatGPT a capire cosa vendi, e un feed di prodotto è il modo strutturato per fornirli. L’invio di un feed non garantisce che i tuoi prodotti appaiano in una determinata risposta, ma senza di esso, ChatGPT non ha nulla di affidabile su cui lavorare.
Un feed di prodotto è un file strutturato che elenca i tuoi prodotti e i relativi dati (titolo, prezzo, disponibilità, immagini e altro) nel formato previsto da un canale. Per ChatGPT, quel formato è quello proprietario di OpenAI. Potresti essere in grado di partire dal feed di Google Shopping che già possiedi: OpenAI accetta il proprio formato e, per le integrazioni confermate, può accettare anche un feed compatibile con Google. La prima domanda è quale di questi si applichi alla tua configurazione, e questa guida ti accompagna sia attraverso i requisiti che nella preparazione del file con Koongo.
Prima di iniziare. Il caricamento di un feed di prodotto su OpenAI è attualmente aperto ai partner approvati e alle integrazioni registrate, e la disponibilità degli annunci ChatGPT a pagamento dipende dal tuo mercato e dal tuo account. Conferma che il canale sia disponibile per il tuo account e per i mercati di destinazione prima di investire tempo nel feed. Questa guida si concentra sul feed di prodotto CSV e non copre la gestione di campagne a pagamento.
In questa guida
- Cosa copre questa guida
- Perché i feed di prodotto accurati sono importanti
- Discovery, Ads e checkout: tre cose separate
- Come configurare il tuo feed di prodotto per ChatGPT con Koongo
- I campi richiesti e un esempio di feed
- Varianti, prezzi e altri dettagli tecnici
- Consegna, aggiornamenti e gestione degli errori
- Checklist pre-lancio
- Domande frequenti
Cosa copre questa guida
ChatGPT mostra i prodotti all’interno delle sue risposte alle domande di shopping. Alcuni posizionamenti sono organici; altri sono a pagamento. Entrambi attingono agli stessi dati di prodotto sottostanti ed entrambi indirizzano l’acquirente al tuo negozio per completare l’acquisto.
Come funziona ChatGPT Shopping: un acquirente fa una domanda, ChatGPT può consigliare dei prodotti e l’acquirente clicca per andare al tuo negozio.
Questa guida copre ciò che il file del feed deve contenere, da come viene scritto un prezzo a come viene raggruppata una variante, come prepararlo e consegnarlo con Koongo e come verificare che sia stato elaborato. Non copre la configurazione o le offerte per le campagne a pagamento, che avvengono nell’Ads Manager di OpenAI.
Perché i feed di prodotto accurati sono importanti
Un feed fornito dal merchant offre a OpenAI dati strutturati direttamente sul tuo catalogo, invece di lasciare che l’assistente li metta insieme da solo. Il feed funge da unica fonte di verità per i tuoi dati di prodotto: titoli, descrizioni, prezzo attuale, stock e disponibilità, brand e identificatori.
Cosa offre un feed di prodotto a OpenAI: dati strutturati e accurati su ciò che vendi.
Ecco perché la specifica è esigente riguardo all’accuratezza, all’identità del venditore, ai resi e alla consegna. L’assistente legge i tuoi dati, l’acquirente clicca e tu chiudi la vendita nel tuo checkout. Ciò che fornisci è un catalogo completo e accurato nell’esatta forma richiesta da OpenAI.
Discovery, Ads e checkout: tre cose separate
Si è tentati di pensare che un unico file preparato correttamente attivi tutto in una volta. Non è così. OpenAI tratta discovery, Ads e checkout come livelli separati, ognuno con il proprio accesso, idoneità e requisiti. Si inizia con i dati di discovery, quindi si aggiunge ciò di cui ogni ulteriore integrazione ha bisogno. (Specifica del feed di prodotto OpenAI.)
Discovery e annunci a pagamento attingono allo stesso feed, ma hanno accessi e requisiti separati.
Discovery (organico). ChatGPT può mostrare i tuoi prodotti nelle risposte in base alla pertinenza e alla qualità dei dati. Questo è il livello base: un feed di discovery valido nel formato di OpenAI.
Ads (a pagamento). Le campagne feed di prodotto a pagamento vengono eseguite tramite l’Ads Manager su uno schema simile a Google Merchant Center. Il sistema crea unità di prodotti sponsorizzati dal tuo feed, ma ogni prodotto che vuoi promuovere deve avere il flag di idoneità agli annunci impostato, e le campagne hanno il proprio accesso e configurazione. Un feed di discovery valido è un prerequisito, non una campagna a pagamento di per sé.
Checkout. Se abiliti l’acquisto all’interno di ChatGPT, ciò aggiunge ulteriori campi obbligatori e URL delle policy oltre alla discovery. Si tratta di un’integrazione a parte.
Preparare un feed valido è un passo importante. Il fatto che i tuoi prodotti appaiano poi organicamente, o vengano eseguiti come annunci, o supportino il checkout in-chat, dipende da questi livelli separati.
Come configurare il tuo feed di prodotto per ChatGPT con Koongo
Il Feed Manager di Koongo crea e aggiorna i feed di prodotto per oltre 500 canali da una singola copia del tuo catalogo, così non devi rinominare colonne o creare manualmente un CSV. Mappa i dati del tuo negozio sui nomi dei campi di OpenAI, trasforma i valori con il Rules Editor (lo strumento no-code di Koongo per rimodellare i dati dei prodotti), mantiene intatti gli identificatori come testo e formatta i prezzi con la giusta precisione per valuta.
Come Koongo prepara i tuoi dati di prodotto come feed pronto per ChatGPT.
Ad alto livello, la configurazione del feed si presenta così:
- Collega il tuo negozio. Collega la tua piattaforma, ad esempio Shopify o WooCommerce, in modo che Koongo possa leggere il tuo catalogo.
- Scegli il template del feed. Seleziona il template del feed di prodotto per ChatGPT.
- Mappa i tuoi campi. Mappa i dati del tuo negozio sui nomi dei campi di OpenAI e usa il Rules Editor per inserire o derivare valori dove i tuoi dati sorgente sono frammentari.
- Controlla l’esportazione. Verifica il file generato rispetto ai campi richiesti e al formato del prezzo prima di consegnarlo.
- Consegna il feed. Consegna il file a OpenAI tramite il metodo di onboarding approvato (SFTP, caricamento file o un URL ospitato).
- Conferma l’elaborazione. Dopo la consegna, conferma che il feed sia stato accettato e monitora eventuali errori durante le prime esecuzioni.
Per essere chiari sull’ambito: Koongo genera e aggiorna il file del feed. Non gestisce le tue campagne ChatGPT, non imposta le offerte né gestisce i budget, e trattandosi di un’integrazione di feed, non importa gli ordini. Il tuo checkout esistente gestisce la vendita.
I campi richiesti e un esempio di feed
Questa è la sezione che vale la pena leggere due volte, perché è qui che i caricamenti falliscono. Il feed di OpenAI è un file piatto, una riga per prodotto o variante, codificato in UTF-8. Anche i campi che già possiedi devono essere rinominati con i nomi di OpenAI. Un feed di discovery richiede questi nove su ogni riga. (Specifica del feed di prodotto OpenAI.)
| Campo OpenAI | Cosa contiene |
|---|---|
| item_id | Un ID stabile e unico per articolo o variante, mai riutilizzato per un articolo diverso |
| title | Nome del prodotto (fino a 150 caratteri), inclusa la variante quando pertinente |
| description | Una descrizione fattuale del prodotto in testo semplice (fino a 5.000 caratteri) |
| url | Il link alla pagina del prodotto, con la variante selezionata dove possibile |
| brand | Il brand del prodotto come mostrato sulla pagina (fino a 70 caratteri) |
| seller_name | Il nome del venditore che fornisce l’offerta, un nome reale, non un segnaposto |
| image_url | Un URL diretto all’immagine principale del prodotto (JPEG o PNG, preferibilmente HTTPS) |
| availability | Uno di cinque valori esatti (sotto) |
| price | Importo con la valuta all’interno del valore |
I nove campi di discovery richiesti in un feed di prodotto OpenAI. Il prezzo riporta la valuta all’interno del valore.
Formati supportati. La configurazione per il caricamento dei file di OpenAI preferisce Parquet e supporta anche JSONL compresso, CSV e TSV. Non utilizza XML. Questa guida si concentra sul CSV. (Panoramica della consegna del feed OpenAI.)
I cinque valori di disponibilità
availability deve essere esattamente uno tra in_stock, out_of_stock, pre_order, backorder o unknown. Un valore omesso, vuoto o scritto in modo errato comporta il rifiuto della riga. Usa unknown esplicitamente quando non sai davvero; non significa “in stock”. Nota l’underscore in pre_order: il percorso compatibile con Google lo scrive preorder e non accetta unknown, quindi l’ortografia corretta dipende dal formato che carichi.
Meccanismi CSV che interrompono i feed silenziosamente
Poiché si tratta di un’integrazione CSV, queste regole di formattazione sono importanti:
- Racchiudi tra virgolette qualsiasi cella contenente una virgola, virgolette o un’interruzione di riga, e raddoppia ogni virgoletta incorporata. I titoli e le descrizioni contengono quasi sempre virgole, quindi devono essere racchiusi tra virgolette.
- Mantieni gli identificatori come stringhe in modo che gli zeri iniziali sopravvivano. Un GTIN come 09506000134352 perde lo zero iniziale nel momento in cui un foglio di calcolo lo tratta come un numero.
- Immagini multiple vanno in una cella come elenco separato da virgole; se un URL contiene una virgola, codificala in percentuale come %2C.
- Un valore JSON in una cella CSV, come variant_dict, viene serializzato come JSON e poi racchiuso tra virgolette, quindi le virgolette doppie appaiono così: ”{””color””:””Slate blue””,””size””:””750 ml””}”.
Un esempio minimo e valido di due varianti con i campi richiesti:
item_id,group_id,listing_has_variations,variant_dict,title,description,url,brand,seller_name,image_url,availability,price
BTL-SLATE-750,BTL-INS,true,”{””color””:””Slate blue””,””size””:””750 ml””}”,”Larkmont insulated water bottle, 750 ml, slate blue”,”Double-walled stainless steel bottle that keeps drinks cold for 24 hours.”,https://example.com/insulated-bottle?c=slate&s=750,Larkmont,Larkmont Supply,https://example.com/img/bottle-slate.jpg,in_stock,29.00 EUR
BTL-SAND-750,BTL-INS,true,”{””color””:””Sand””,””size””:””750 ml””}”,”Larkmont insulated water bottle, 750 ml, sand”,”Double-walled stainless steel bottle that keeps drinks cold for 24 hours.”,https://example.com/insulated-bottle?c=sand&s=750,Larkmont,Larkmont Supply,https://example.com/img/bottle-sand.jpg,out_of_stock,29.00 EUR
Varianti, prezzi e altri dettagli tecnici
Varianti: group_id e una riga per opzione
Invii una riga separata per ogni variante, una per ogni colore e dimensione, con il proprio item_id, prezzo, disponibilità, URL e immagine. Le colleghi insieme con tre campi:
- group_id: un ID di inserzione principale stabile condiviso da ogni variante dello stesso prodotto. Deve differire da ogni item_id.
- listing_has_variations: impostato su true in ogni riga della variante.
- variant_dict: una piccola mappa delle opzioni selezionate, ad esempio {”color”:”Slate blue”,”size”:”750 ml”}.
Mantieni i nomi delle opzioni coerenti all’interno di un gruppo (“color” ovunque, non “colour” in alcune righe) e mantieni stabili ogni item_id, group_id e qualsiasi offer_id anche quando il prezzo o lo stock cambiano. Una regola da ricordare: non inserire mai il prezzo all’interno di un ID offerta.
Raggruppamento di varianti con un group_id condiviso, una riga per opzione.
Il campo prezzo
Il prezzo viene scritto come un importo, uno spazio e un codice valuta ISO 4217 di tre lettere maiuscole, ad esempio, 29.00 EUR. Usa il punto decimale, nessun separatore delle migliaia e nessuna notazione esponenziale: 1299.00 EUR, mai 1,299 EUR. La specifica è chiara sul fatto che 79.99 USD significa 79 dollari e 99 centesimi, quindi non omettere i decimali. Convalida il formato del prezzo prima del caricamento, perché una riga di intestazione o un formato di valuta non corrispondenti sono un motivo comune per cui un’esportazione Google riutilizzata viene rifiutata.
Per uno sconto, aggiungi sale_price nella stessa valuta, maggiore di zero e rigorosamente inferiore a price. Un prezzo di vendita uguale, superiore o in una valuta diversa dal prezzo normale viene ignorato, senza errori e senza che venga mostrato alcuno sconto.
Identificatori: regole GTIN che vengono controllate
Un GTIN, EAN o MPN con il brand è il segnale di identità più forte che puoi inviare. Se fornisci un GTIN, deve essere esattamente di 8, 12, 13 o 14 cifre con una cifra di controllo valida, con gli zeri iniziali preservati e senza spazi o separatori. Un UPC-A è un GTIN a 12 cifre; un ISBN-13 può essere inserito come GTIN a 13 cifre, ma un ISBN-10 no. Non inventare un MPN per sostituire un GTIN mancante; ometti invece l’identificatore.
Campi aggiuntivi per discovery, Ads e checkout
Oltre ai nove campi di discovery richiesti, OpenAI definisce ulteriori campi, e quelli necessari dipendono dal livello che stai configurando:
- Dettagli di discovery opzionali. Campi come immagini aggiuntive e informazioni sui resi (un URL della politica di reso e una finestra di reso in giorni) sono opzionali per la discovery ma vale la pena includerli dove disponibili, in modo che ChatGPT possa rispondere a “è facile da restituire?”
- Flag di idoneità. is_eligible_search e is_eligible_checkout controllano se un prodotto è individuabile o acquistabile; l’idoneità al checkout si applica solo quando è attiva anche la ricerca.
- Ads. Per le campagne a pagamento, is_ads_eligible è richiesto condizionalmente: impostalo su true su ogni prodotto che Ads dovrebbe elaborare. (Guida ai feed di prodotto per gli annunci.)
- Checkout. L’abilitazione dell’acquisto all’interno di ChatGPT aggiunge gli URL delle policy richiesti (privacy policy e termini di servizio su HTTPS) oltre alla discovery.
Perché altre guide elencano nomi di campi diversi: i rinominamenti della beta
Se due tutorial non concordano sui nomi dei campi, ecco perché. OpenAI ha rinominato diversi campi durante la beta. I vecchi nomi funzionano ancora come alias, ma invia solo un nome per valore, e il nome attuale ha la precedenza:
| Vecchio nome (ancora accettato) | Nome attuale |
|---|---|
| id o sku | item_id |
| item_group_id | group_id |
| enable_search | is_eligible_search |
| enable_checkout | is_eligible_checkout |
| is_eligible_ads | is_ads_eligible |
| return_window | return_deadline_in_days |
Rinominamenti dei campi beta di OpenAI: i vecchi nomi funzionano ancora come alias, ma i nomi attuali hanno la precedenza.
Fai corrispondere il tuo file alla versione della specifica in vigore quando lo crei e non mescolare un vecchio nome e il suo sostituto nello stesso feed.
Una nota per i venditori europei: il mercato predefinito
Il caricamento standard in formato OpenAI punta a un singolo mercato predefinito a meno che non sia confermata l’elaborazione multi-paese per la tua integrazione, e le colonne del paese a livello di riga non cambiano questo aspetto da sole. Quindi un merchant europeo non può semplicemente aggiungere una colonna target_countries e aspettarsi di servire i Paesi Bassi. Conferma i paesi e le valute consentiti durante l’onboarding prima di pianificare un mercato intorno ad essi.
Cosa rende un feed efficace
Queste non sono garanzie di visibilità, ma offrono a ChatGPT dati accurati e specifici con cui lavorare e mantengono valido il tuo file.
Dati di feed efficaci rispetto ai comuni errori dei feed.
- Titoli secondo lo schema usato dagli acquirenti: brand, prodotto, attributo chiave, variante. “Larkmont insulated water bottle, 750 ml, slate blue” si legge meglio di “Larkmont water bottle, spedizione gratuita!”
- Descrizioni che siano fattuali e complete: materiali, dimensioni, compatibilità e cosa c’è nella confezione.
- Prezzo e disponibilità che corrispondano alla landing page nel momento in cui un acquirente arriva.
- Corretto raggruppamento delle varianti e un’immagine primaria pulita, oltre ad angolazioni aggiuntive dove disponibili.
Motivi comuni per cui i feed vengono rifiutati: nomi di colonne che non sono quelli di OpenAI, campi obbligatori mancanti, un prezzo senza codice valuta o con numeri malformati, URL di immagini o prodotti non validi, valori item_id non univoci e prezzo o disponibilità che non concordano con la pagina del prodotto live.
Consegna, aggiornamenti e gestione degli errori
Non incolli l’URL di un feed pubblico in un modulo. L’onboarding è attualmente aperto ai partner approvati e consegni il file tramite SFTP, caricamento file o un URL ospitato a seconda della tua configurazione. Gli articoli sono trattati come deperibili, quindi il feed deve essere aggiornato.
Koongo aggiorna il tuo feed secondo una pianificazione; OpenAI lo acquisisce come passaggio separato.
Qui contano due passaggi separati. Koongo può aggiornare il file del tuo feed secondo una pianificazione (più frequentemente nei piani a pagamento, una volta al giorno nel piano Free), il che mantiene il file che consegni aggiornato con il tuo negozio. OpenAI acquisisce quindi quel file dal proprio lato, il che è un passaggio separato e non è istantaneo. In altre parole, aggiornare più spesso in Koongo mantiene aggiornato il tuo lato, ma la rapidità con cui una modifica raggiunge ChatGPT dipende anche dall’acquisizione di OpenAI.
Una buona notizia sugli errori: una singola riga malformata può essere rifiutata mentre il resto delle righe valide continua a essere elaborato, e la cronologia dei caricamenti ti dice quali colonne o valori sono falliti, così puoi correggere il problema specifico invece dell’intero file.
Checklist pre-lancio
- Conferma l’accesso. Verifica che il canale sia disponibile per il tuo account e per i mercati di destinazione.
- Crea il file secondo le specifiche di OpenAI: nomi delle colonne corretti, valuta all’interno del prezzo, una riga per variante.
- Compila i campi necessari per il tuo livello: i nove campi di discovery, più i campi Ads o checkout se li stai configurando.
- Completa i tuoi identificatori: un GTIN o MPN valido, più il brand, ovunque possibile.
- Scrivi titoli e descrizioni come fatti. Rimuovi il linguaggio promozionale; aggiungi gli attributi che una persona direbbe ad alta voce.
- Valida la parità di prezzo e stock tra feed e pagina del prodotto.
- Consegna e conferma l’elaborazione, quindi monitora le prime esecuzioni per eventuali errori.
- Tagga i tuoi link con parametri UTM in modo che le sessioni provenienti da ChatGPT siano separabili negli analytics.
Domande frequenti
Cos’è un feed per ChatGPT Shopping?
Un feed per ChatGPT Shopping è un file di prodotto strutturato che elenca il tuo catalogo nel formato richiesto da OpenAI, in modo che ChatGPT possa utilizzare dati accurati sui tuoi prodotti e indirizzare gli acquirenti al tuo negozio. Utilizza i nomi delle colonne e i campi obbligatori di OpenAI, che differiscono da quelli di un feed di Google Shopping.
Posso usare il mio feed di Google Shopping per ChatGPT?
Possibilmente, come punto di partenza. OpenAI supporta il proprio formato e, per le integrazioni confermate, può anche accettare un feed compatibile con Google e mappare da solo i campi supportati. Quale si applichi dipende dalla tua configurazione registrata, quindi controlla prima invece di presumere che un’esportazione esistente funzioni senza modifiche. Koongo può generare per te il feed nella struttura propria di OpenAI.
L’invio di un feed garantisce che i miei prodotti appaiano in ChatGPT?
No. Un feed valido offre a ChatGPT dati accurati con cui lavorare, ma non garantisce che i tuoi prodotti appaiano in una determinata risposta o posizionamento pubblicitario. Discovery organica, Ads a pagamento e checkout sono livelli separati con la propria idoneità e requisiti.
Come scrivo il prezzo in un feed di prodotto OpenAI?
Come un importo, uno spazio e un codice valuta ISO 4217 di tre lettere, ad esempio, 29.00 EUR. Usa il punto decimale, nessun separatore delle migliaia e il giusto numero di decimali per la valuta. Un prezzo di vendita deve essere nella stessa valuta e rigorosamente inferiore al prezzo normale, altrimenti viene ignorato.
Come vengono gestite le varianti di prodotto?
Invia una riga per variante, ognuna con il proprio item_id, prezzo e stock. Colleghale insieme con un group_id condiviso (diverso da ogni item_id), imposta listing_has_variations su true ed elenca le opzioni selezionate in variant_dict, ad esempio {”color”:”Slate blue”,”size”:”750 ml”}. Mantieni i nomi delle opzioni coerenti all’interno del gruppo.
Cosa succede quando rimuovo un prodotto dal mio feed?
Non viene necessariamente rimosso da ChatGPT immediatamente. Per il caricamento snapshot documentato, una riga che elimini non viene cancellata istantaneamente; l’ultimo record elaborato può persistere fino a 14 giorni. Per rimuovere prontamente un prodotto, segui i controlli di rimozione supportati dalla tua integrazione invece di omettere solo la riga.
Koongo importa gli ordini da ChatGPT?
No. L’integrazione Koongo qui descritta genera e aggiorna il tuo feed di prodotto; non importa gli ordini. ChatGPT Shopping indirizza l’acquirente al tuo sito per l’acquisto, quindi gli ordini sono gestiti dal tuo checkout esistente, proprio come qualsiasi altro canale di feed.
Ho bisogno di un piano Koongo a pagamento per creare un feed per ChatGPT?
Feed Manager è incluso in ogni piano Koongo, incluso il piano gratuito. I piani a pagamento aggiornano il file del tuo feed più frequentemente, il che mantiene aggiornato il tuo lato; la rapidità con cui una modifica raggiunge poi ChatGPT dipende anche dall’acquisizione di OpenAI. Consulta la pagina dei prezzi di Koongo per i piani attuali.
Per iniziare
ChatGPT Shopping è un nuovo modo per i clienti di trovare prodotti. Entrare è una sequenza, non un interruttore: conferma che il canale sia disponibile per il tuo account e per i tuoi mercati, prepara un feed valido nel formato di OpenAI, consegnalo e monitora come viene elaborato dopo il lancio. Koongo ti aiuta con la parte che puoi controllare più direttamente: produrre e aggiornare un feed correttamente strutturato dal tuo catalogo esistente.
Sei pronto a preparare il tuo feed? Inizia con il Feed Manager di Koongo. È disponibile un piano gratuito senza carta di credito richiesta, e i piani a pagamento partono da 24 €/mese con una prova gratuita di 7 giorni.
Continue reading →