
I segnali di inventario sono i campi espliciti di disponibilità e a livello di variante — in_stock, out_of_stock, preorder, backorder o unknown — insieme ad availability_date e agli ID articolo stabili, che gli agenti AI per gli acquisti leggono per decidere se mostrare o meno il tuo prodotto. La correzione più importante è una sola: fai corrispondere il valore availability nel feed a ciò che chi acquista vede sulla landing page, usando ogni volta che cambia lo stock l'esatta grafia dell'enum che l'agente si aspetta.
In breve:
- Usa i valori di disponibilità esatti accettati per ogni variante; OpenAI rifiuta voci mancanti, vuote o non valide, e ID articolo e offerta stabili mantengono la continuità del tracciamento degli SKU.
- Applica le modifiche di prezzo e disponibilità tramite la Delta API; riserva gli upload completi via SFTP ai nuovi prodotti o ai cambiamenti che interessano l'intero catalogo.
- Per gli articoli preorder o backorder, fornisci availability_date in formato ISO 8601, non oltre un anno nel futuro, e mostrala nella scheda prodotto.
- Allinea la disponibilità del feed ai dati strutturati della landing page e mantieni visibili i prezzi quando i prodotti sono esauriti, perché gli agenti possono confrontare entrambe le fonti.
- Dopo ogni aggiornamento, verifica che lo stato del prodotto elaborato sia attivo; i prodotti contrassegnati come esauriti restano non idonei finché non vengono corretti e rielaborati.
Campi e valori esatti che gli agenti AI si aspettano dal tuo feed
Gli agenti AI per gli acquisti non deducono lo stato delle scorte dal design del tuo sito o dai tuoi testi di marketing. Leggono un piccolo insieme di campi strutturati e, se questi campi mancano, sono scritti in modo errato o sono incoerenti, la riga del prodotto viene esclusa prima ancora che un cliente la veda.
I campi principali che i merchant devono mappare correttamente sono availability (lo stato stesso), un booleano available, availability_date, item_id, group_id, offer_id e un variant_dict per i prodotti con opzioni come taglia o colore. La specifica del feed prodotti di OpenAI richiede un valore availability esplicito in ogni riga e accetta esattamente cinque forme: in_stock, out_of_stock, pre_order, backorder o unknown.
Valori availability omessi, vuoti o non riconosciuti fanno sì che l’intera riga del prodotto venga rifiutata senza appello, il che significa che il prodotto semplicemente non appare mai come candidato per una raccomandazione.
Alcune regole di mapping evitano la maggior parte delle esclusioni:
- Usa una riga per ogni variante invece di accorpare taglie o colori in un’unica scheda prodotto.
- Mantieni item_id e offer_id stabili tra un aggiornamento del feed e l’altro, così l’agente può seguire la stessa variante nel tempo.
- Usa group_id per indicare all’agente quali righe appartengono allo stesso prodotto principale.
- Mantieni i nomi delle opzioni (come “Taglia” o “Colore”) scritti in modo identico in ogni variante di un gruppo.
I dati strutturati della landing page devono rispecchiare esattamente il feed. Se il tuo markup Schema.org indica InStock mentre il tuo feed indica out_of_stock, gli agenti che verificano entrambe le fonti segnaleranno l’incongruenza e potrebbero sopprimere la scheda prodotto invece di ipotizzare quale dei due valori sia corretto.
Cosa succede all'erogazione quando cambia lo stato delle scorte
Impostare un prodotto come out_of_stock non si limita ad aggiungere un’etichetta. Rimuove attivamente il prodotto dall’idoneità finché il feed non viene rielaborato con uno stato corretto.
Secondo la guida ai product feed per Ads di OpenAI, un prodotto out_of_stock smette di essere idoneo alla pubblicazione e non tornerà tale finché non sarà riportato a in_stock e rielaborato. La stessa logica si applica in generale sulle piattaforme di agenti: la disponibilità è trattata come un requisito di accesso, non come un semplice indizio. Anche le impostazioni a livello di feed e un flag is_ads_eligible possono determinare se un prodotto entra del tutto nell’elaborazione degli annunci, separatamente dall’idoneità alle raccomandazioni organiche.
La maggior parte dei problemi di erogazione deriva da un elenco ristretto di cause:
- Un campo availability lasciato vuoto invece di essere impostato su unknown.
- Un valore enum scritto in modo errato, come “instock” invece di in_stock.
- Una landing page che restituisce un errore o un’immagine mancante quando l’agente prova a verificare il prodotto.
- Una regola di filtro o selezione che esclude il prodotto dopo un normale aggiornamento del feed.
Suggerimento pratico: Mantieni il prezzo visibile sulla landing page anche quando un prodotto è esaurito. la guida di Google ai dati di prodotto lo richiede e inoltre mantiene la pagina utilizzabile per i clienti che vi arrivano da una risposta dell’agente memorizzata nella cache.
Quando usare la Delta API invece di un caricamento SFTP completo
Non tutti i cambiamenti di inventario richiedono lo stesso metodo di aggiornamento e usare quello sbagliato è una causa comune di dati di disponibilità non aggiornati.
La guida ai product feed per Ads di OpenAI raccomanda una distinzione chiara: usare la Delta API o una richiesta PATCH per i cambi di prezzo e disponibilità, e riservare i caricamenti completi via SFTP all’aggiunta di nuovi prodotti o a modifiche in blocco dei campi nell’intero catalogo.
- Aggiorna disponibilità e prezzo tramite la Delta API ogni volta che uno SKU va esaurito, torna disponibile o cambia prezzo. È l’aggiornamento con il maggiore impatto per inventari ad alta rotazione, perché raggiunge il feed live senza ricaricare tutto.
- Usa caricamenti completi via SFTP quando lanci nuovi prodotti, riorganizzi gruppi di varianti o modifichi campi che riguardano l’intero catalogo in una sola volta.
- Definisci una cadenza in base alla velocità del catalogo. Gli aggiornamenti delta quasi in tempo reale sono adatti agli SKU che si esauriscono spesso; gli aggiornamenti batch orari o giornalieri coprono la maggior parte dei cataloghi; un refresh completo notturno funziona come fallback per intercettare ciò che gli aggiornamenti delta potrebbero non aver rilevato.
- Mantieni sincronizzato il tuo sistema di inventario di riferimento con le patch delta. Una discrepanza tra il conteggio interno delle scorte e ciò che hai inviato al feed tramite patch crea esattamente il tipo di incoerenza che porterà quelle righe a essere segnalate in seguito.
Dopo ogni aggiornamento, verifica che sia stato effettivamente elaborato. Interroga il prodotto e conferma che la risposta sullo stato del feed mostri “active” invece di pending o rejected, perché una patch che fallisce senza segnalazioni lascia attivo il vecchio valore di disponibilità errato.
Come confermare che i segnali di inventario siano stati acquisiti correttamente
Inviare un aggiornamento non equivale a confermare che un agente lo veda nel modo previsto. Una breve procedura di verifica intercetta le discrepanze prima che compromettano la visibilità.
Inizia dal feed grezzo: estrai un campione di righe e controlla che i valori availability usino esattamente le diciture accettate e che i valori item_id e group_id restino stabili tra un’esportazione e l’altra invece di essere rigenerati a ogni sincronizzazione.
Successivamente, conferma l’elaborazione lato piattaforma. Documentazione Global Catalog di Shopify descrive le risposte del catalogo agenti che includono campi dedotti come available, status e running_low, che gli sviluppatori possono interrogare direttamente per verificare se la disponibilità di una variante è stata elaborata come previsto dal feed.
Alcuni controlli da eseguire regolarmente:
- Confronta il prezzo visibile sulla landing page e la disponibilità Schema.org con il valore del feed per lo stesso SKU.
- Usa una sandbox di test UCP per inviare una query prodotto e ispezionare l’URL di checkout e i dati della variante che un agente riceverebbe realmente.
- Controlla le conferme “status: active” nelle risposte del feed e analizza qualsiasi prodotto che scompare senza segnalazioni dopo un aggiornamento di routine, perché spesso la causa è una regola di filtro.
Suggerimento pratico: Considera i campi dedotti dagli strumenti catalogo storefront di Shopify come un segnale di scoperta, non come un sostituto dei dati di disponibilità e prezzo forniti direttamente da te.
Checklist rapida: risolvi i problemi più critici questa settimana
Non serve rifare l’intera piattaforma per colmare la maggior parte delle lacune nei segnali di inventario. Una settimana di interventi mirati basta per risolvere i problemi che causano più righe rifiutate e perdita di visibilità.
- Esporta un campione di righe prodotto e verifica ogni valore availability rispetto alle cinque diciture accettate: in_stock, out_of_stock, preorder, backorder, unknown.
- Mappa gli stati interni delle scorte a questi enum canonici, quindi instrada le modifiche a prezzo e disponibilità tramite la Delta API invece di aspettare il successivo caricamento completo.
- Aggiungi availability_date in formato ISO 8601 per ogni articolo preorder o backorder e mostra quella data direttamente sulla landing page.
- Interroga i dati prodotto elaborati e conferma che lo stato del feed sia “active”. Ripeti il ciclo di esportazione e controllo finché nessuna riga non risulta più rifiutata.
Questa sequenza affronta prima le correzioni con il ritorno più rapido: valori canonici e ID stabili, poi velocità di aggiornamento, gestione dei preorder e infine verifica. Ogni passaggio chiude una lacuna che altrimenti escluderebbe silenziosamente i prodotti dalla selezione.
Definizione e importanza dei segnali di inventario nei contesti AI
Nel contesto degli acquisti tramite AI, un segnale di inventario è qualsiasi dato strutturato che indica a un agente AI per gli acquisti se un prodotto può essere acquistato in quel momento e a quali condizioni. Include l’enum availability, il booleano available, availability_date per gli articoli non ancora spedibili e lo stato a livello di variante per ogni opzione di taglia o colore.
Questi segnali contano più che nella ricerca tradizionale o nella pubblicità display, perché un agente formula una raccomandazione per conto dell’acquirente, spesso senza che quest’ultimo abbia prima visitato la pagina. Se l’agente consiglia un prodotto che poi risulta esaurito, il problema è immediatamente visibile e riduce la fiducia nei suggerimenti dell’agente, non solo nel tuo brand.
Questa dinamica spinge le piattaforme verso controlli più rigorosi rispetto ai vecchi feed ecommerce. La specifica prodotto di OpenAI rifiuta direttamente le righe con valori availability mancanti o malformati invece di assegnare uno stato presunto. Non esiste un fallback “probabilmente disponibile”.
Per i merchant, questo trasforma i dati di inventario da tema operativo backend a tema di visibilità. Un prodotto con testi eccellenti, immagini efficaci e prezzi competitivi comunque non verrà mostrato se il campo availability è vuoto o scritto in modo errato. Il segnale stesso è diventato un meccanismo di blocco, quindi configurarlo correttamente è un prerequisito per qualsiasi altra ottimizzazione, non un’attività parallela.
Come i segnali di inventario influenzano la previsione della domanda guidata dall’AI
Dati di disponibilità accurati e aggiornati con continuità fanno molto più che mantenere visibile un singolo prodotto. Modellano il modo in cui un agente, o i sistemi che alimentano le sue raccomandazioni, interpretano nel tempo i pattern di domanda all’interno di un catalogo.
Quando la disponibilità passa in modo affidabile e rapido tra in_stock e out_of_stock, questo schema diventa un segnale utile: frequenti esaurimenti di uno SKU suggeriscono una domanda elevata rispetto all’offerta, mentre uno SKU che raramente esce dallo stato in_stock indica una disponibilità più stabile e prevedibile. Segnali obsoleti o incoerenti interrompono questo schema. Un prodotto che continua a risultare in_stock dopo essere realmente esaurito non inganna solo il cliente, ma altera anche qualsiasi inferenza successiva sulla reale velocità di vendita dell’articolo.
La gestione degli articoli in preorder e backorder incide direttamente su questo aspetto. Le linee guida di Merchant Center di Google richiedono per questi articoli il campo availability_date in formato ISO 8601, con una data che non superi un anno nel futuro. In questo modo, i sistemi che leggono il feed possono distinguere tra disponibilità futura confermata e semplice esaurimento delle scorte senza un piano di riassortimento. Questa distinzione fornisce un’informazione utile: un articolo in backorder con una data ravvicinata comunica qualcosa di molto diverso rispetto a uno senza alcuna data.
Per i merchant, la conclusione pratica è che la qualità delle previsioni a valle dipende dall’igiene del feed a monte. Gli aggiornamenti delta applicati tempestivamente, invece di essere raggruppati una volta a settimana, mantengono il segnale abbastanza fresco da riflettere la domanda reale invece di una sua fotografia in ritardo.
Best practice per integrare i segnali di inventario con gli algoritmi AI
I merchant che evitano la maggior parte dei problemi legati ai segnali di inventario tendono a seguire poche abitudini consolidate invece di sistemi complessi.
Per prima cosa, tratta il feed come unica fonte di verità e invia immediatamente ogni modifica tramite esso, invece di aggiornare prima il sito e poi il feed. La documentazione Ads di OpenAI specifica colonne obbligatorie tra cui item_id, title, description, url, brand, image_url, price e availability, e richiede che questi campi restino aggiornati tramite la Delta API anziché esportazioni periodiche.
Secondo, mantieni coerenti i dati delle varianti. Le linee guida sui fragment di prodotto di OpenAI raccomandano una riga per variante con ID stabili e opzioni denominate in modo coerente all’interno dello stesso gruppo, perché denominazioni incoerenti (ad esempio chiamare il campo colore di una variante “Color” e quello di un’altra “colour”) impediscono all’agente di raggrupparle correttamente.
Terzo, evita qualsiasi divergenza tra landing page e feed. I dati strutturati della pagina devono indicare lo stesso valore availability del feed e il prezzo deve restare visibile anche quando l’articolo non è disponibile, perché diverse piattaforme fanno riferimento allo stato della pagina per verificare quanto dichiarato nel feed.
Quarto, costruisci l’automazione degli aggiornamenti attorno agli eventi di inventario invece che alle esportazioni manuali. Un webhook che si attiva al cambiamento del livello di scorte e avvia una patch Delta API riduce il divario tra il momento in cui un articolo si esaurisce davvero e quello in cui il feed lo riflette, aspetto particolarmente importante per gli SKU a maggiore rotazione.
Problemi comuni e criticità nell’uso dei segnali di inventario per l’AI
La maggior parte dei problemi nei segnali di inventario deriva da un piccolo insieme di errori ricorrenti piuttosto che da casi limite complessi.
Il più comune è lasciare vuoto il campo availability invece di impostarlo esplicitamente su unknown. La specifica di OpenAI tratta un valore vuoto allo stesso modo di uno non valido: in entrambi i casi la riga viene rifiutata, quindi non esiste un valore predefinito sicuro.
Subito dopo viene la deriva nelle diciture. I sistemi interni usano spesso etichette come “Available”, “In Stock” oppure “0” e “1” per gli stati booleani, e un’esportazione diretta senza mappatura raramente corrisponde esattamente agli enum richiesti da un agente. Qualsiasi livello di mapping tra il sistema di inventario e il feed deve tradurre in modo coerente, non solo durante la configurazione iniziale ma ogni volta che viene introdotto internamente un nuovo stato.
Le discrepanze tra landing page e feed causano un problema diverso: la riga può superare la validazione, ma il controllo incrociato dell’agente con la pagina trova una contraddizione e sopprime comunque la scheda prodotto. Succede spesso con la cache, quando un aggiornamento del feed viene inviato subito ma la pagina prodotto del sito continua a mostrare per minuti o ore un vecchio stato di disponibilità.
La gestione delle varianti crea un problema meno visibile ma costoso. I merchant che comprimono tutte le varianti in una sola riga o che rigenerano i valori item_id a ogni esportazione rendono difficile per un agente tracciare la cronologia di uno SKU specifico, influenzando il livello di fiducia con cui verrà raccomandato.
Infine, l’eccessiva dipendenza dai campi dedotti è una criticità crescente. Le piattaforme generano sempre più dati supplementari automaticamente, ma Shopify è chiara nel definire i campi dedotti come strumenti di scoperta, non sostituti dei dati di disponibilità e prezzo forniti dal merchant.

Casi studio ed esempi di segnali di inventario che funzionano come previsto
Alcuni scenari concreti mostrano come questi meccanismi si manifestano nella pratica.
Considera un merchant che lancia una vendita flash su un lotto limitato di uno SKU popolare. Man mano che le unità vengono vendute, il sistema interno di inventario scende a zero, ma il merchant aggiorna solo il sito web e non il feed, aspettando il successivo caricamento completo SFTP programmato per quella notte. Per diverse ore l’agente continua a trattare lo SKU come in_stock e continua a raccomandarlo, causando checkout falliti. Se il merchant avesse instradato quella modifica tramite la Delta API nel momento in cui le scorte hanno raggiunto lo zero, il cambio di disponibilità sarebbe arrivato all’agente nel normale ciclo delle patch invece di aspettare un processo batch.
Un secondo caso riguarda il lancio di un prodotto in preorder. Un commerciante imposta availability su preorder ma lascia availability_date vuoto, presumendo che il campo sia facoltativo. Secondo le regole di Merchant Center di Google, questa omissione è proprio il tipo di lacuna che crea ambiguità per qualsiasi sistema che debba decidere se vale la pena raccomandare il prodotto ora o più avanti. Aggiungere una data ISO 8601 formattata correttamente e mostrarla nella pagina di destinazione elimina l’ambiguità e permette al prodotto in preorder di comparire normalmente.
Un terzo esempio, più strutturale: una linea di abbigliamento con più varianti in cui ogni taglia usava una capitalizzazione diversa per lo stesso nome colore tra un ciclo di esportazione e l’altro (“Navy” contro “navy”). L’incoerenza non ha causato un rifiuto, dato che il campo aveva comunque un valore, ma ha frammentato il gruppo di varianti, così l’agente ha interpretato i prodotti come articoli separati e non correlati invece che come un unico prodotto con opzioni di taglia. Standardizzare i nomi delle opzioni al momento dell’esportazione ha risolto la frammentazione.

Prospettiva esperta: priorità quando le risorse di engineering sono limitate
La maggior parte dei team non ha la capacità di risolvere tutto contemporaneamente, quindi la sequenza delle priorità conta più della completezza. La mappatura canonica della disponibilità viene per prima: è la singola correzione che evita il rifiuto diretto e nient’altro conta se la riga non entra mai nel sistema. L’automazione Delta per gli SKU a maggiore rotazione viene subito dopo, perché è lì che una disponibilità obsoleta costa di più in termini di raccomandazioni perse.
I team con risorse limitate dovrebbero resistere alla tentazione di investire troppo nell’arricchimento (descrizioni più ricche, attributi estesi) prima di aver consolidato le basi. Un valore availability coerente e scritto correttamente su ogni pagina vale più di una scheda prodotto scritta perfettamente ma che contraddice silenziosamente il proprio feed. Una volta stabilite le fondamenta, l’automazione guidata da webhook le mantiene solide senza richiedere lavoro manuale continuo.
— Xhurian
Come ecentic ti aiuta a colmare più rapidamente le lacune nei segnali di inventario
Individuare una discrepanza tra feed e pagina confrontando manualmente le righe con le landing page richiede ore che un piccolo team raramente ha a disposizione. Abbiamo creato la nostra piattaforma per simulare il modo in cui ChatGPT, Gemini, Claude e Perplexity valutano realmente le tue schede prodotto, così puoi vedere esattamente dove disponibilità, dati delle varianti o dati strutturati presentano problemi prima che ti costino una raccomandazione.

Le nostre diagnostiche segnalano enum non corrispondenti, campi availability_date mancanti e contraddizioni tra feed e pagina in linguaggio chiaro, quindi ti permettono di pubblicare direttamente la correzione sulla tua piattaforma ecommerce con un clic. Inizia con una controllo gratuito oppure confronta i nostri piani nella pagina prezzi per vedere quale si adatta meglio alla dimensione del tuo catalogo.
FAQ
Quali sono i valori availability accettati per i feed AI shopping?
I valori accettati sono in_stock, out_of_stock, pre_order (o preorder), backorder e unknown, e il campo deve contenere esattamente una di queste diciture. La specifica del feed prodotto di OpenAI rifiuta qualsiasi riga con un valore availability mancante, vuoto o non riconosciuto.
Qual è la differenza tra la Delta API e i caricamenti SFTP?
La Delta API è progettata per modifiche frequenti e mirate, come aggiornamenti di prezzo o disponibilità su singoli prodotti, mentre i caricamenti completi tramite SFTP sono più adatti a modifiche su larga scala o all’aggiunta di nuovi prodotti al catalogo. Le linee guida OpenAI per i feed Ads raccomandano l’uso dei delta per prodotti ad alta rotazione e di riservare i caricamenti completi alle modifiche più ampie del catalogo.
Contrassegnare un prodotto come out of stock lo rimuove immediatamente?
Sì. Secondo la documentazione Ads di OpenAI, un prodotto out_of_stock smette di essere idoneo alla distribuzione e alle raccomandazioni finché non viene aggiornato nuovamente a in_stock e rielaborato. Non esiste un periodo di tolleranza durante il quale un articolo esaurito continua a essere mostrato normalmente.
Come devono essere formattate le date preorder e backorder?
Il campo availability_date dovrebbe usare il formato ISO 8601 e può essere impostato fino a un anno in anticipo, secondo la specifica dei dati di prodotto di Merchant Center di Google. Questa data dovrebbe comparire anche nella pagina di destinazione del prodotto, così chi acquista vede le stesse informazioni fornite dal feed.
ecentic può correggere automaticamente le discrepanze nei segnali di inventario?
La nostra piattaforma diagnostica le discrepanze tra feed e landing page e offre la pubblicazione con un clic per applicare i campi corretti in Shopify o WooCommerce. I prezzi partono dal piano Compete a $14.90 al mese, con livelli superiori disponibili per cataloghi più grandi.
Link principali a specifiche e documentazione per gli implementatori
Per casi limite e regole di validazione precise, consulta direttamente la documentazione ufficiale invece di affidarti a riassunti di terze parti. La specifica del feed prodotto OpenAI e le linee guida Ads sui feed prodotto trattano nel dettaglio campi obbligatori, valori enum e canali di aggiornamento. La guida di Merchant Center di Google documenta availability_date e le regole di corrispondenza con la pagina di destinazione, mentre la documentazione Global Catalog di Shopify spiega come le risposte del catalogo agli agenti gestiscono la disponibilità dedotta e quella delle singole varianti. Per implementare dati strutturati insieme a questi feed, questa guida al markup schema copre i tipi che i merchant devono in genere implementare per primi.