Introduzione a OpenAI Commerce
OpenAI Commerce è una piattaforma di distribuzione che consente ai commercianti di esporre i propri cataloghi prodotti attraverso canali di ricerca e checkout integrati. Il feed prodotti costituisce il fondamento della presenza commerciale su questa piattaforma: ogni campo deve essere compilato con precisione per garantire che i prodotti siano idonei per la ricerca, il checkout e le campagne pubblicitarie.
A differenza di semplici aggregatori di prodotti, OpenAI Commerce collega direttamente i dati del catalogo alle funzionalità di acquisto e scoperta. La qualità del feed determina non solo se i tuoi prodotti vengono trovati, ma anche se gli acquirenti possono completare transazioni senza attrito.
Campi di eligibilità e visibilità
I tre campi di eligibilità controllano dove e come i tuoi prodotti possono apparire sulla piattaforma.
is_eligible_search
Questo campo booleano (vero/falso) determina se un prodotto può apparire nei risultati di ricerca su OpenAI Commerce. Un prodotto contrassegnato come non idoneo per la ricerca rimane invisibile ai clienti che navigano o cercano cataloghi.
I prodotti vengono contrassegnati come non idonei quando:
- Mancano dati obbligatori come title, description, price, image_url o availability.
- Il prezzo non è in un formato valido o è assente.
- L'immagine principale non rispetta i requisiti tecnici (dimensioni, formato, risoluzione).
- Il prodotto è fuori stock e non ha una availability_date.
- Il brand non è riconosciuto o il seller_name manca.
Per garantire l'eligibilità di ricerca, verifica che ogni prodotto nel feed contenga tutti i campi obbligatori correttamente formattati e che le immagini siano ospitate su URL stabili e raggiungibili.
is_eligible_checkout
L'eligibilità di checkout è più restrittiva di quella di ricerca. Un prodotto può apparire nei risultati di ricerca ma non essere acquistabile se non soddisfa criteri aggiuntivi.
Per essere idoneo al checkout, un prodotto deve avere:
- Un return_policy chiaramente definito e conforme alle normative del target_countries.
- Un seller_name e seller_url verificati.
- Una disponibilità immediata (availability = 'in stock') oppure una availability_date futura valida.
- Un prezzo trasparente senza ambiguità su tasse o spese di spedizione nascoste.
- Un seller_privacy_policy e seller_tos accessibili e conformi.
I commercianti che desiderano abilitare il checkout devono fornire documentazione legale completa e mantenere tassi di adempimento elevati.
is_eligible_ads
Questo campo controlla se un prodotto può essere incluso in campagne pubblicitarie sulla piattaforma. I criteri di eligibilità per gli annunci sono ancora più severi e includono:
- Conformità alle politiche pubblicitarie della piattaforma (nessun contenuto vietato, nessun prodotto contraffatto).
- Immagini di alta qualità con contrasto adeguato e nessun testo sovrapposto eccessivo.
- Una descrizione prodotto che non contenga affermazioni non verificabili o fuorvianti.
- Un brand e un seller con reputazione positiva e nessuna violazione precedente.
I prodotti non idonei per gli annunci rimangono visibili nella ricerca organica ma non verranno promossi.
Identificazione e struttura prodotto
item_id e group_id
L'item_id è l'identificatore univoco per ogni variante di prodotto nel tuo feed. Deve essere unico all'interno del tuo catalogo e coerente ad ogni aggiornamento del feed. Se un item_id cambia, la piattaforma lo tratterà come un prodotto completamente nuovo, perdendo la cronologia di vendite e valutazioni.
Il group_id raggruppa varianti dello stesso prodotto (ad esempio, diverse taglie o colori di una maglietta). Tutti gli item_id con lo stesso group_id vengono visualizzati insieme nelle pagine di dettaglio del prodotto, consentendo ai clienti di selezionare facilmente la variante desiderata. Se ometti group_id, ogni variante appare come prodotto separato, frammentando le vendite e riducendo il ranking nei risultati di ricerca.
gtin, mpn e condition
Il gtin (Global Trade Item Number, comunemente noto come codice a barre o EAN) è lo standard internazionale per l'identificazione dei prodotti. Fornire il gtin corretto migliora la corrispondenza con le banche dati di prodotti globali e aumenta la fiducia dei clienti.
L'mpn (Manufacturer Part Number) è il numero di parte del produttore. Insieme al brand, il gtin e l'mpn aiutano la piattaforma a deduplicare i tuoi prodotti e a collegarli a schede prodotto canoniche, riducendo la frammentazione nei risultati di ricerca.
Il condition (condizione) specifica se il prodotto è nuovo, ricondizionato o usato. La piattaforma applica filtri di ricerca basati sulla condizione, quindi un valore errato può escludere il tuo prodotto dai risultati quando i clienti cercano specificamente prodotti nuovi o usati.
Dati descrittivi e visivi
title, description e product_category
Il title deve essere conciso (massimo 150 caratteri) e contenere le parole chiave principali del prodotto. Evita di ripetere il brand o di includere il prezzo nel titolo. La piattaforma utilizza il titolo per l'indicizzazione di ricerca e per la visualizzazione nei risultati.
La description fornisce il contesto che il titolo non può contenere. Deve includere caratteristiche principali, materiali, dimensioni e vantaggi. Una descrizione vaga o incompleta riduce la probabilità che i clienti clicchino sul prodotto e aumenta i tassi di rimbalzo, danneggiando il ranking.
Il product_category classifica il prodotto all'interno della tassonomia di OpenAI Commerce. Categorie errate rendono il prodotto non scopribile nei filtri di navigazione e possono causare l'esclusione dai risultati di ricerca per determinate query.
image_url e additional_image_urls
L'image_url è l'immagine principale visualizzata nei risultati di ricerca e nelle miniature. Deve avere una risoluzione minima di 400 x 400 pixel, preferibilmente 1200 x 1200 pixel, e deve mostrare il prodotto in modo chiaro su uno sfondo neutro.
Le additional_image_urls forniscono viste alternative (angoli diversi, dettagli, varianti di colore). La piattaforma visualizza queste immagini nella pagina di dettaglio del prodotto. I clienti che vedono più immagini hanno una probabilità significativamente più alta di completare l'acquisto.
Le immagini devono essere ospitate su URL stabili con certificati SSL validi. Se un URL diventa irraggiungibile, il prodotto potrebbe perdere l'eligibilità di ricerca.
Prezzi e promozioni
price, sale_price e date di validità
Il price è il prezzo regolare del prodotto. Deve essere un numero positivo in formato standard (ad esempio, 29.99 o 29,99 a seconda della localizzazione). Prezzi nulli o negativi causano l'esclusione automatica dal feed.
Il sale_price rappresenta un prezzo promozionale temporaneo. Deve essere inferiore al price regolare. Se sale_price è superiore a price, la piattaforma contrassegna il prodotto come non conforme e lo esclude dalla ricerca.
I campi sale_price_start_date e sale_price_end_date definiscono il periodo di validità della promozione in formato ISO 8601 (YYYY-MM-DD). Se ometti queste date, la piattaforma assume che la promozione sia permanente. Se la data di fine è nel passato, il sale_price viene ignorato e il prezzo regolare viene utilizzato.
I commercianti che applicano promozioni con date di fine nel passato vedono cali improvvisi di traffico quando la piattaforma applica il prezzo regolare, quindi aggiorna le date di promozione con almeno una settimana di anticipo.
unit_pricing_measure e base_measure
Questi campi forniscono il prezzo per unità di misura (ad esempio, prezzo per litro o prezzo per chilogrammo). Sono obbligatori per prodotti come alimenti, bevande e articoli misurati per peso o volume. Fornire il prezzo per unità consente ai clienti di confrontare il valore tra diverse confezioni e marchi, aumentando la fiducia nella trasparenza dei prezzi.
Disponibilità e logistica
availability e availability_date
L'availability indica lo stato attuale dello stock: 'in stock', 'out of stock' o 'preorder'. Un prodotto con availability = 'out of stock' non è idoneo per il checkout immediato, ma rimane visibile nella ricerca.
L'availability_date specifica quando un prodotto attualmente esaurito tornerà disponibile (formato ISO 8601). Se fornisci una data futura, i clienti possono pre-ordinare o ricevere notifiche di disponibilità. Senza una availability_date, i prodotti esauriti rimangono in stock indefinitamente, creando confusione e causando ordini annullati.
pickup_method e pickup_sla
Il pickup_method specifica come il cliente riceve il prodotto: 'ship', 'local_pickup' o 'digital'. Se supporti il ritiro locale, il pickup_sla (Service Level Agreement) definisce il tempo massimo di attesa (ad esempio, '1 giorno' o '3 giorni'). Questa informazione influenza la decisione di acquisto, soprattutto per clienti che cercano consegne rapide.
Dettagli del venditore e conformità legale
seller_name, seller_url, seller_privacy_policy e seller_tos
Il seller_name è il nome aziendale del venditore. Deve corrispondere al nome registrato presso le autorità di regolamentazione. Nomi incoerenti o vaghi riducono la fiducia dei clienti e possono causare l'esclusione dal checkout.
Il seller_url deve puntare alla homepage del sito web del venditore, non a una pagina di prodotto. La piattaforma verifica che il dominio sia raggiungibile e che il certificato SSL sia valido.
Il seller_privacy_policy e seller_tos sono URL che puntano rispettivamente alla politica sulla privacy e ai termini di servizio del venditore. Questi documenti sono obbligatori per l'eligibilità di checkout in tutti i target_countries. Se gli URL non sono accessibili o i documenti non sono in lingua locale, il prodotto viene escluso dal checkout.
return_policy
La return_policy specifica i termini di restituzione: numero di giorni, condizioni di restituzione (ad esempio, 'restituito non utilizzato' o 'restituzione incondizionata'), e se le spese di restituzione sono a carico del cliente o del venditore. Una return_policy chiara e generosa aumenta i tassi di conversione, mentre politiche ambigue o restrittive riducono gli acquisti.
Le politiche di restituzione devono conformarsi alle normative locali di ciascun target_countries. Ad esempio, l'Unione Europea richiede almeno 14 giorni di diritto di recesso, mentre altri paesi hanno periodi più brevi o più lunghi.
Localizzazione geografica
target_countries e store_country
Il target_countries specifica i paesi in cui il prodotto può essere venduto. Deve essere un elenco di codici di paese ISO 3166-1 alfa-2 (ad esempio, 'IT', 'DE', 'FR'). Se ometti questo campo, la piattaforma assume che il prodotto sia disponibile solo nel store_country.
Il store_country è il paese in cui il venditore è registrato o dove ha sede l'operazione. Questo campo influenza il calcolo delle tasse, le normative sulla protezione dei consumatori e la visibilità geografica nei risultati di ricerca.
I commercianti che vendono a livello internazionale devono fornire una return_policy e un seller_tos conformi a ogni target_countries. Una politica unica che non rispetta le normative locali può causare l'esclusione dalla piattaforma in determinati paesi.
Attributi del prodotto
size, size_system, color, gender e age_group
Il size specifica la dimensione del prodotto (ad esempio, 'M', 'L', '42', '10'). Il size_system definisce il sistema di dimensionamento utilizzato ('US', 'EU', 'UK', 'IT', 'metric', ecc.). Fornire sia size che size_system consente ai clienti di filtrare per dimensione e riduce i resi dovuti a misure errate.
Il color specifica il colore del prodotto. Se un prodotto è disponibile in più colori, crea varianti separate con group_id identico e item_id univoci, ognuna con il proprio color.
Il gender specifica il genere a cui il prodotto è rivolto ('male', 'female', 'unisex'). Questo campo viene utilizzato per i filtri di ricerca e per la personalizzazione dei risultati.
L'age_group specifica la fascia d'età target ('newborn', 'infant', 'toddler', 'kids', 'adult'). È obbligatorio per i prodotti per bambini e influenza la conformità alle normative sulla sicurezza dei prodotti.
Dimensioni e peso
weight, item_weight_unit, length, width, height e dimensions_unit
Il weight specifica il peso del prodotto in unità definite da item_weight_unit ('kg', 'g', 'lb', 'oz'). Questo campo è utilizzato per calcolare le spese di spedizione e per i filtri di ricerca (ad esempio, 'prodotti leggeri').
I campi length, width e height specificano le dimensioni del prodotto in unità definite da dimensions_unit ('cm', 'in', 'm'). Questi dati sono utilizzati per determinare se il prodotto si qualifica per determinati metodi di spedizione e per calcolare le dimensioni della confezione.
Se ometti peso e dimensioni, la piattaforma non può calcolare accuratamente le spese di spedizione, portando a sorprese al checkout e a un aumento dei tassi di abbandono del carrello.
Material e altri attributi
material
Il material specifica i materiali principali del prodotto (ad esempio, 'cotone', 'acciaio inossidabile', 'plastica riciclata'). Questo campo è utilizzato dai clienti per filtrare i prodotti in base alle preferenze di materiale e per identificare prodotti sostenibili o ipoallergenici.
Offerte e varianti
offer_id
L'offer_id è un identificatore univoco per una specifica offerta di prodotto da parte di un venditore. Se lo stesso prodotto (stesso gtin e brand) è offerto da più venditori, ogni venditore fornisce un offer_id univoco. Questo consente ai clienti di confrontare prezzi e condizioni tra diversi venditori dello stesso prodotto.
Ottimizzazione pratica del feed
Audit dei campi obbligatori
Prima di inviare il feed a OpenAI Commerce, verifica che ogni prodotto contenga:
- item_id (univoco)
- title (conciso e ricco di parole chiave)
- description (dettagliata e accurata)
- price (formato valido, numero positivo)
- availability (in stock, out of stock o preorder)
- image_url (URL raggiungibile, risoluzione almeno 400 x 400)
- brand (riconoscibile e coerente)
- seller_name (registrato e verificato)
- product_category (conforme alla tassonomia della piattaforma)
Un audit automatico può identificare rapidamente i prodotti mancanti di campi obbligatori, riducendo il tempo di correzione manuale.
Validazione dei dati
Implementa controlli di validazione nel tuo sistema di gestione del catalogo:
- I prezzi devono essere numeri positivi.
- Le date devono essere in formato ISO 8601.
- Gli URL devono iniziare con 'https://' e essere raggiungibili.
- I codici di paese devono essere codici ISO 3166-1 alfa-2 validi.
- I valori di availability devono corrispondere a un elenco predefinito.
La validazione dei dati prima dell'invio del feed riduce i rifiuti e accelera l'approvazione dei prodotti.
Aggiornamenti incrementali
Non inviare l'intero catalogo ad ogni aggiornamento. Utilizza aggiornamenti incrementali che includono solo i prodotti modificati (prezzo, disponibilità, immagini). Gli aggiornamenti incrementali riducono il carico sulla piattaforma e consentono ai cambiamenti di propagarsi più rapidamente.
Monitoraggio dell'eligibilità
Utilizza i rapporti di eligibilità della piattaforma per identificare i prodotti non idonei per ricerca, checkout o annunci. Ogni rapporto deve specificare il motivo dell'esclusione (campo mancante, formato non valido, violazione della politica, ecc.). Correggere i problemi di eligibilità è il modo più veloce per aumentare la visibilità e le vendite.
Sincronizzazione dell'inventario
Sincronizza l'availability e l'availability_date con il tuo sistema di gestione dell'inventario in tempo reale. Se il feed contiene prodotti esauriti con una availability_date nel passato, i clienti vedono 'esaurito' e non possono acquistare, causando frustrazione e abbandono del carrello.
Localizzazione delle politiche legali
Se vendi a livello internazionale, crea versioni localizzate di return_policy, seller_privacy_policy e seller_tos per ogni target_countries. Una politica generica che non rispetta le normative locali può causare l'esclusione dal checkout in determinati paesi.
Riepilogo
Il feed OpenAI Commerce è il fondamento della tua presenza commerciale sulla piattaforma. Ogni campo serve uno scopo specifico: controllare l'eligibilità, migliorare la scoperta, facilitare la transazione e conformarsi alle normative locali.
I commercianti che investono nel mantenimento di un feed di alta qualità vedono tassi di eligibilità più alti, ranking migliori nei risultati di ricerca, tassi di conversione più elevati e minori problemi di conformità legale.
L'audit regolare dei campi obbligatori, la validazione dei dati, gli aggiornamenti incrementali dell'inventario e la localizzazione delle politiche legali sono le pratiche fondamentali per ottimizzare il feed e massimizzare il ritorno sull'investimento nella distribuzione su OpenAI Commerce.