Un acquirente in AI Mode di Google chiede un prodotto, l’agente lo trova nel vostro catalogo, e l’acquisto avviene senza che l’acquirente carichi mai il vostro sito. L’Universal Commerce Protocol (UCP) permette all’agente di farlo, e funziona solo quando il vostro negozio risponde correttamente nel momento in cui l’agente chiede. Che cosa deve pubblicare il vostro negozio? Quali prodotti può acquistare un agente? Che cosa controlla Google prima di lasciarvi andare live? Nel lavoro su UCP che abbiamo svolto, la pagina prodotto ha sempre contenuto più informazioni del feed, e un endpoint costruito solo dal feed darebbe agli agenti meno materiale di quello che un acquirente vede sulla pagina.
UCP è uno standard aperto, e il vostro negozio pubblica ciò che supporta
UCP è stato sviluppato da Google insieme a Shopify, Etsy, Wayfair, Target e Walmart, e la sua specifica si trova su ucp.dev. Il vostro negozio è il merchant of record: mantenete il cliente, l’ordine e la responsabilità del pagamento, e l’agente agisce per conto dell’acquirente.
Tutto parte da un profilo che il vostro negozio pubblica in /.well-known/ucp. Indica la versione del protocollo, i servizi che offrite e come raggiungerli, i vostri gestori di pagamento e le chiavi pubbliche che un agente usa per verificare i vostri messaggi firmati. Un agente lo legge prima di fare qualsiasi altra cosa.
| Cosa pubblicate | Cosa fa | Necessario per il checkout di Google |
|---|---|---|
Profilo UCP in /.well-known/ucp |
Dichiara la vostra versione, i servizi, i gestori di pagamento e le chiavi di firma | Sì |
| Checkout | Crea, aggiorna e completa una sessione di checkout | Sì, nel percorso di checkout nativo |
| Gestore di pagamento Google Pay | Permette all’agente di pagare con un token Google Pay che il vostro processore accetta | Sì, nel percorso di checkout nativo |
| Ciclo di vita dell’ordine | Invia aggiornamenti firmati sull’ordine dopo l’acquisto, come spedito e consegnato | Sì, nel percorso di checkout nativo |
| Carrello | Passa un carrello creato su Google al vostro sito per completare l’acquisto | L’alternativa al checkout nativo |
| Collegamento dell’identità | Collega l’account di un acquirente con OAuth 2.0 invece del checkout come ospite | Facoltativo |
| Sconti | Applica codici promozionali durante il checkout | Facoltativo |
| Ricerca e consultazione del catalogo | Permette a un agente di interrogare direttamente i prodotti | Facoltativo nella specifica |
Le versioni di UCP sono date. La specifica più recente a ottobre 2026 è la 2026-08-25, e le guide di implementazione di Google usano la 2026-04-08. Un negozio può servire REST, MCP, A2A o un checkout incorporato, e REST è quello principale.
Passo 1: Correggere i dati di prodotto sbagliati
Google legge un feed secondo una pianificazione, ma un agente chiama un endpoint UCP in tempo reale, quindi qualunque errore nei vostri dati raggiunge l’acquirente al momento dell’acquisto, senza nessuno lì a intercettarlo. Correggiamo i dati sbagliati prima di aggiungere qualsiasi cosa, e queste correzioni danno risultati in Merchant Center che UCP venga lanciato o meno.
| Problema | Perché conta per un agente |
|---|---|
| Due prodotti diversi che condividono un GTIN, come un’unità nuova e la sua versione ricondizionata | L’agente non riesce a capire quale dei due sta acquistando |
| Uno SKU copiato nel campo GTIN, o un GTIN con lunghezza o cifra di controllo errata | Il prodotto non può essere abbinato al record del produttore |
| Un prezzo scontato uguale al prezzo normale | Nasconde il vero prezzo di listino, quindi lo sconto che vede l’acquirente è sbagliato |
| Link di prodotto che reindirizzano | Il link dell’agente e il vostro checkout non concordano sull’indirizzo del prodotto |
| Campi di disponibilità che si contraddicono | L’agente offre qualcosa che non può essere spedito |
Conservate i GTIN come testo dall’inizio alla fine. Un sistema che li tratta come numeri elimina gli zeri iniziali, e il GTIN smette di corrispondere. Verificate ciascuno con il record GS1 del produttore invece di riempirlo finché non torna.
Passo 2: Aggiungere i dati che servono a un agente per completare un acquisto
Le pagine prodotto di solito contengono più del feed: la galleria completa di immagini, il brand, le valutazioni, il vero prezzo di listino e le condizioni di consegna. Un agente vede solo ciò che gli inviate.
- Descrizioni estese. Mettete per prima la differenza principale del prodotto, perché un agente potrebbe citare solo l’inizio. Indicate i vincoli in modo chiaro, come limiti di peso, requisiti di alimentazione e dove può essere spedito, e date le misure in entrambi i sistemi di unità.
- Varianti separate. Un prodotto padre con taglie o colori appiattiti in una sola riga deve diventare una riga per variante, raggruppate con
item_group_id. - Spedizione, resi e garanzia come dati, non solo come paragrafi in una pagina delle politiche.
- Ogni immagine che mostra la pagina. Un feed che porta solo la prima lascia all’agente meno di ciò che vede l’acquirente.
- Livelli di stock in tempo reale invece di un indicatore disponibile o esaurito. Google richiede un controllo dell’inventario in tempo reale al checkout, e un errore
out_of_stockquando l’articolo è esaurito.
Merchant Center limita una descrizione a 5.000 caratteri e non vuole al suo interno dettagli promozionali come prezzi o offerte di spedizione, mentre una descrizione UCP può contenere consegna, garanzia e vincoli. Scrivete la versione completa per UCP e riducetela per il feed.
In UCP i prezzi sono numeri interi nella più piccola unità della valuta, quindi $129,99 viene inviato come 12999. Sbagliare l’unità altera il prezzo del prodotto di un fattore cento, in una direzione o nell’altra, quindi controllatelo prima che qualsiasi cosa vada live.
Passo 3: Decidere quali prodotti può acquistare un agente
Le indicazioni di Google per Merchant Center escludono intere categorie dal checkout tramite agente, tra cui:
- abbonamenti e piani rateali o di finanziamento;
- prodotti personalizzati, articoli ricondizionati, usati e in vendita finale, e preordini;
- servizi abbinati come installazione o garanzie estese, trasporto merci e consegna premium, e attivazione in negozio;
- prodotti soggetti a limiti di età e prodotti vietati, servizi, noleggi e articoli virtuali.
Escludete quelli, e attivate il resto prodotto per prodotto.
Un prodotto di prezzo elevato che molti acquirenti comprano con un piano di finanziamento può vendere peggio tramite un checkout con wallet che non offre il piano. Misurate quanti ordini per quel prodotto usano un finanziamento prima di attivare il checkout tramite agente per quel prodotto. Un negozio può anche pubblicare il proprio catalogo per gli agenti e mantenere il checkout sul proprio sito, che è una configurazione UCP legittima e spesso la prima fase giusta.
Passo 4: Preparare Merchant Center
La guida di implementazione di Google parte da Merchant Center: l’account deve essere in regola, con prodotti approvati per le schede gratuite.
- Politica di reso. Impostate il costo del reso, il periodo per il reso e un link alla politica completa, a livello di account o per singolo prodotto con l’attributo
returns. Google la mostra nella schermata di checkout. - Assistenza clienti. Aggiungete almeno un metodo di contatto: una pagina di assistenza, un indirizzo email o un numero di telefono. Alimenta il link “Contact Merchant” nella conferma d’ordine.
- Attivate i prodotti. Impostate
native_commerce(checkout_eligibility)suTRUEper ogni prodotto idoneo. Google consiglia un’origine dati supplementare, così l’attivazione non interferisce con il feed principale. - Avvisi normativi. I prodotti che riportano un’avvertenza legale, un avviso di sicurezza o un avviso Proposition 65 richiedono un
consumer_notice, con il suo tipo e un messaggio fino a 1.000 caratteri. - ID corrispondenti. L’
iddel feed deve corrispondere all’ID prodotto che il vostro checkout si aspetta. Dove sono diversi, inviatemerchant_item_id.
Passo 5: Iscriversi alla lista d’attesa di Google
Google afferma che un’integrazione “deve essere approvata da Google prima che possiate andare live” in AI Mode e Gemini. La via d’accesso è il modulo di interesse per l’integrazione UCP nella Guida di Merchant Center, che inserisce il vostro negozio nella lista d’attesa. Il checkout incorporato, in cui il vostro checkout funziona all’interno della superficie di Google, è limitato ai merchant approvati. Inviate il modulo mentre sviluppate, poiché l’approvazione è il passaggio che non potete accelerare da soli.
Passo 6: Costruire il profilo e gli endpoint
Un negozio o usa il supporto UCP integrato nella propria piattaforma di commercio o lo costruisce. Quando lo costruiamo noi, mettiamo davanti al negozio un servizio leggero che parla UCP con gli agenti e l’API della piattaforma con il negozio, montato sotto il dominio del negozio, così il profilo e gli endpoint condividono un’unica origine. UCP viene rivisto spesso, e tenerlo fuori dalla piattaforma significa che una nuova versione non deve aspettare un rilascio della piattaforma.
- Pubblicate solo ciò che funziona. Un agente che trova il checkout nel vostro profilo proverà a usarlo. Un primo rilascio può dichiarare solo la ricerca e la consultazione del catalogo, e aggiungere il checkout quando è pronto.
- Usate chiavi di firma reali. Le chiavi pubbliche del profilo verificano i vostri aggiornamenti d’ordine firmati, quindi generate una coppia di chiavi e tenete la metà privata sul server.
- Rendete sicuri i tentativi ripetuti. Accettate una chiave di idempotenza nelle chiamate di checkout, così una richiesta ripetuta non addebita due volte.
- Servitelo tramite HTTPS. La specifica REST richiede almeno TLS 1.3.
- Convalidate gli indirizzi. Restituite un indirizzo non consegnabile come errore recuperabile, così l’acquirente può correggerlo invece di trovarsi in un vicolo cieco.
- Collegate le vostre politiche. I vostri termini si applicano a ogni acquisto UCP, quindi includete nella risposta di checkout i link alle vostre politiche su privacy, termini, rimborsi e spedizioni.
Passo 7: Collegare i pagamenti
Nel percorso di checkout nativo di Google, il vostro profilo dichiara il gestore di pagamento Google Pay. Non vi serve la Google Pay API sul vostro sito, ma il vostro processore di pagamento deve accettare i token di pagamento di Google, e la maggior parte dei principali processori lo fa. Le FAQ di Google indicano che le sue superfici IA usano solo il metodo di autorizzazione PAN_ONLY e che le impostazioni di Google Pay nel profilo usano nomi in snake_case. Tenete separate le credenziali del processore per test e produzione, e non registratele mai nei log.
Passo 8: Testare come farà Google
Google invia i controlli di stato con lo user agent Google-UCP-Prober/1.0 e contrassegna le richieste degli agenti con un’intestazione UCP-Agent e uno user agent che inizia con Google/UCP. Prima di fare domanda, interrogate i vostri endpoint come farebbe Google.
/.well-known/ucpraggiunge il vostro negozio? Una regola del server web può rispondere a quel percorso con un proprio 404 prima che la richiesta arrivi all’applicazione, anche mentre i vostri endpoint UCP funzionano.- Il vostro firewall lascia entrare Google? Una protezione anti-bot che blocca il traffico automatizzato bloccherà anche il prober, quindi lasciate passare le richieste UCP di Google in base alle loro intestazioni anziché all’indirizzo.
- Gli endpoint protetti si comportano correttamente? Gli endpoint di checkout, pagamento e ordine dovrebbero rifiutare le richieste senza credenziali e accettare quelle di Google.
Passo 9: Pianificare la prossima versione di UCP
La specifica 2026-08-25 aggiunge politiche standard di reso e garanzia che la 2026-04-08 non ha, e Google documenta la 2026-04-08. Finché le guide di Google non adottano una versione più recente, è la politica di reso in Merchant Center a portare quell’informazione. Quando adottate una nuova versione, Google consiglia di servirla da un endpoint separato, così da poter rimandare il traffico a quella vecchia se qualcosa si rompe.
WISLR configura UCP per i brand e per i clienti delle agenzie
Ogni passo descritto sopra fa parte del servizio Agentic Commerce Optimization di WISLR. Verifichiamo il catalogo rispetto ai requisiti di Google, correggiamo e completiamo i dati di prodotto, prepariamo Merchant Center e il feed di attivazione, e costruiamo e testiamo il profilo UCP e gli endpoint finché l’integrazione non è pronta per l’approvazione di Google. I brand ci coinvolgono direttamente, e le agenzie ci coinvolgono con il proprio nome per configurarlo per i loro clienti. Scoprite come configuriamo UCP e richiedete una valutazione del vostro catalogo.