Een shopper in AI Mode van Google vraagt om een product, de agent vindt het in je catalogus, en de aankoop gebeurt zonder dat de shopper ooit je site laadt. Het Universal Commerce Protocol (UCP) maakt dat mogelijk voor de agent, en het werkt alleen als je winkel correct antwoordt op het moment dat de agent het vraagt. Wat moet je winkel publiceren? Welke producten kan een agent kopen? Wat controleert Google voordat je live mag gaan? In het UCP-werk dat we hebben gedaan, wist de productpagina telkens meer dan de feed, en een endpoint dat alleen op de feed is gebouwd zou agents minder geven om mee te werken dan een shopper op de pagina ziet.
UCP is een open standaard, en je winkel publiceert wat hij ondersteunt
UCP is door Google ontwikkeld samen met Shopify, Etsy, Wayfair, Target en Walmart, en de specificatie staat op ucp.dev. Je winkel is de merchant of record: je houdt de klant, de bestelling en de aansprakelijkheid voor de betaling, en de agent handelt namens de shopper.
Alles begint met een profiel dat je winkel publiceert op /.well-known/ucp. Het noemt de protocolversie, de services die je aanbiedt en hoe ze te bereiken zijn, je betaalhandlers, en de publieke sleutels waarmee een agent je ondertekende berichten verifieert. Een agent leest het voordat hij iets anders doet.
| Wat je publiceert | Wat het doet | Nodig voor checkout via Google |
|---|---|---|
UCP-profiel op /.well-known/ucp |
Declareert je versie, services, betaalhandlers en ondertekeningssleutels | Ja |
| Checkout | Maakt een checkoutsessie aan, werkt die bij en rondt die af | Ja, op het native checkoutpad |
| Google Pay-betaalhandler | Laat de agent betalen met een Google Pay-token dat je betaalverwerker accepteert | Ja, op het native checkoutpad |
| Orderlevenscyclus | Stuurt na de aankoop ondertekende orderupdates, zoals verzonden en bezorgd | Ja, op het native checkoutpad |
| Winkelwagen | Draagt een op Google samengestelde winkelwagen over aan je eigen site om af te ronden | Het alternatief voor native checkout |
| Accountkoppeling | Koppelt het account van een shopper met OAuth 2.0 in plaats van afrekenen als gast | Optioneel |
| Kortingen | Past promotiecodes toe tijdens de checkout | Optioneel |
| Zoeken en opvragen in de catalogus | Laat een agent rechtstreeks producten opvragen | Optioneel in de specificatie |
UCP-versies zijn datums. De nieuwste specificatie per oktober 2026 is 2026-08-25, en de implementatiehandleidingen van Google gebruiken 2026-04-08. Een winkel kan REST, MCP, A2A of een ingebedde checkout aanbieden, en REST is de kern.
Stap 1: Corrigeer de productdata die niet klopt
Google leest een feed volgens een schema, maar een agent roept een UCP-endpoint in realtime aan, dus wat er in je data niet klopt bereikt de shopper op het moment van aankoop, zonder dat iemand het kan opvangen. We corrigeren foute data voordat we iets toevoegen, en deze correcties betalen zich uit in Merchant Center, of UCP er nu ooit komt of niet.
| Probleem | Waarom het ertoe doet voor een agent |
|---|---|
| Twee verschillende producten die één GTIN delen, zoals een nieuw exemplaar en de refurbished versie ervan | De agent kan niet zien welke hij koopt |
| Een SKU gekopieerd in het GTIN-veld, of een GTIN met de verkeerde lengte of het verkeerde controlecijfer | Het product kan niet worden gekoppeld aan het record van de fabrikant |
| Een aanbiedingsprijs gelijk aan de normale prijs | Die verbergt de echte catalogusprijs, dus de korting die de shopper ziet klopt niet |
| Productlinks die doorverwijzen | De link van de agent en je checkout zijn het oneens over het adres van het product |
| Voorraadvelden die elkaar tegenspreken | De agent biedt iets aan dat niet verzonden kan worden |
Houd GTIN’s van begin tot eind als tekst. Een systeem dat ze als getallen behandelt, verwijdert de voorloopnullen, en dan klopt de GTIN niet meer. Controleer elke GTIN tegen het GS1-record van de fabrikant in plaats van hem aan te vullen tot hij past.
Stap 2: Voeg de data toe die een agent nodig heeft om een aankoop af te ronden
Productpagina’s bevatten meestal meer dan de feed: de volledige fotogalerij, het merk, beoordelingen, de echte catalogusprijs en de leveringsvoorwaarden. Een agent ziet alleen wat je hem stuurt.
- Uitgebreide beschrijvingen. Zet het belangrijkste onderscheid van het product vooraan, want een agent citeert misschien alleen het begin. Noem beperkingen duidelijk, zoals gewichtslimieten, stroombehoefte en waarheen het verzonden kan worden, en geef maten in beide eenheidsstelsels.
- Aparte varianten. Een hoofdproduct met maten of kleuren samengeperst in één rij moet één rij per variant worden, gegroepeerd met
item_group_id. - Verzending, retouren en garantie als data, niet alleen als alinea’s op een beleidspagina.
- Elke afbeelding die de pagina toont. Een feed die alleen de eerste meestuurt, geeft de agent minder dan de shopper ziet.
- Live voorraadniveaus in plaats van een vlag voor op voorraad of niet op voorraad. Google vereist een live voorraadcontrole bij de checkout, en een
out_of_stock-fout wanneer het artikel is uitverkocht.
Merchant Center beperkt een beschrijving tot 5,000 tekens en wil er geen promotionele details zoals prijzen of verzendaanbiedingen in, terwijl een UCP-beschrijving levering, garantie en beperkingen kan bevatten. Schrijf de volledige versie voor UCP en kort die in voor de feed.
Prijzen in UCP zijn hele getallen in de kleinste eenheid van de valuta, dus $129.99 wordt verstuurd als 12999. Een verkeerde eenheid zet de prijs van het product een factor honderd verkeerd, in beide richtingen, dus controleer het voordat er iets live gaat.
Stap 3: Bepaal welke producten een agent kan kopen
De Merchant Center-richtlijnen van Google sluiten hele categorieën uit van checkout via agents, waaronder:
- abonnementen en afbetalings- of financieringsregelingen;
- gepersonaliseerde producten, refurbished en gebruikte artikelen, artikelen zonder retourrecht, en pre-orders;
- gebundelde diensten zoals installatie of verlengde garanties, vracht en premium bezorging, en activering in de winkel;
- producten met een leeftijdsgrens en verboden producten, diensten, verhuur en virtuele artikelen.
Laat die weg, en meld de rest product voor product aan.
Een duur product dat veel shoppers met een financieringsregeling kopen, verkoopt mogelijk slechter via een wallet-checkout die die regeling niet aanbiedt. Meet hoeveel bestellingen voor dat product financiering gebruiken voordat je checkout via agents ervoor inschakelt. Een winkel kan ook zijn catalogus publiceren voor agents en de checkout op de eigen site houden, wat een legitieme UCP-configuratie is en vaak de juiste eerste fase.
Stap 4: Bereid Merchant Center voor
De implementatiehandleiding van Google begint bij Merchant Center: het account moet een goede status hebben, met producten die zijn goedgekeurd voor gratis vermeldingen.
- Retourbeleid. Stel de retourkosten, de retourtermijn en een link naar het volledige beleid in, op accountniveau of per product met het kenmerk
returns. Google toont het op het checkoutscherm. - Klantenservice. Voeg minstens één contactmethode toe: een supportpagina, een e-mailadres of een telefoonnummer. Daarmee werkt de link “Contact Merchant” op de orderbevestiging.
- Producten aanmelden. Zet
native_commerce(checkout_eligibility)opTRUEvoor elk geschikt product. Google raadt een aanvullende gegevensbron aan, zodat de aanmelding je hoofdfeed niet verstoort. - Wettelijke meldingen. Producten met een juridische disclaimer, een veiligheidswaarschuwing of een Proposition 65-waarschuwing hebben een
consumer_noticenodig, met het type en een bericht van maximaal 1,000 tekens. - Overeenkomende ID’s. De
idin de feed moet overeenkomen met de product-ID die je checkout verwacht. Waar ze verschillen, stuur jemerchant_item_id.
Stap 5: Meld je aan voor de wachtlijst van Google
Google zegt dat een integratie “door Google moet worden goedgekeurd voordat je live kunt gaan” in AI Mode en Gemini. De weg erin is het interesseformulier voor UCP-integratie in de Merchant Center Help, dat je winkel op de wachtlijst zet. Ingebedde checkout, waarbij je eigen checkout binnen de omgeving van Google draait, is beperkt tot goedgekeurde verkopers. Dien het formulier in terwijl je bouwt, want goedkeuring is de stap die je zelf niet kunt versnellen.
Stap 6: Bouw het profiel en de endpoints
Een winkel gebruikt de UCP-ondersteuning die in zijn commerceplatform is ingebouwd, of bouwt die zelf. Waar wij bouwen, zetten we een dunne service voor de winkel die UCP spreekt naar agents en de eigen API van het platform naar de winkel, gemount onder het domein van de winkel, zodat het profiel en de endpoints één origin delen. UCP wordt vaak herzien, en doordat het buiten het platform blijft, wacht een nieuwe versie niet op een release van het platform.
- Publiceer alleen wat werkt. Een agent die checkout in je profiel vindt, zal die proberen te gebruiken. Een eerste release kan alleen zoeken en opvragen in de catalogus aanbieden, en checkout toevoegen wanneer die klaar is.
- Gebruik echte ondertekeningssleutels. De publieke sleutels in het profiel verifiëren je ondertekende orderupdates, dus genereer een sleutelpaar en houd de private helft op de server.
- Maak herhaalpogingen veilig. Accepteer een idempotentiesleutel bij checkoutaanroepen, zodat een herhaald verzoek niet twee keer afschrijft.
- Lever het via HTTPS. De REST-specificatie vereist minimaal TLS 1.3.
- Valideer adressen. Geef een onbezorgbaar adres terug als herstelbare fout, zodat de shopper het kan corrigeren in plaats van vast te lopen.
- Link je beleid. Je voorwaarden gelden voor elke UCP-aankoop, dus neem in de checkoutrespons links op naar je privacybeleid, voorwaarden, terugbetalingsbeleid en verzendbeleid.
Stap 7: Koppel betalingen
Op het native checkoutpad van Google declareert je profiel de Google Pay-betaalhandler. Je hebt de Google Pay API niet nodig op je eigen site, maar je betaalverwerker moet de betaaltokens van Google accepteren, en de meeste grote verwerkers doen dat. De FAQ van Google vermeldt dat de AI-omgevingen van Google alleen de autorisatiemethode PAN_ONLY gebruiken en dat de Google Pay-instellingen in het profiel namen in snake_case gebruiken. Houd test- en productiegegevens van de verwerker gescheiden, en log ze nooit.
Stap 8: Test zoals Google zal testen
Google stuurt healthchecks met de user agent Google-UCP-Prober/1.0, en markeert agentverzoeken met een UCP-Agent-header en een user agent die begint met Google/UCP. Vraag je eigen endpoints op zoals Google dat zou doen, voordat je je aanmeldt.
- Bereikt
/.well-known/ucpje winkel? Een webserverregel kan dat pad met een eigen 404 beantwoorden voordat het verzoek de applicatie bereikt, zelfs terwijl je UCP-endpoints werken. - Laat je firewall Google door? Botbescherming die geautomatiseerd verkeer blokkeert, blokkeert ook de prober, dus laat de UCP-verzoeken van Google door op basis van hun headers in plaats van hun adres.
- Gedragen beschermde endpoints zich correct? Checkout-, betaal- en orderendpoints moeten verzoeken zonder inloggegevens weigeren en die van Google accepteren.
Stap 9: Plan voor de volgende UCP-versie
De specificatie 2026-08-25 voegt standaardbeleid voor retouren en garantie toe dat 2026-04-08 niet heeft, en Google documenteert 2026-04-08. Totdat de handleidingen van Google een nieuwere versie overnemen, draagt je retourbeleid in Merchant Center die informatie. Wanneer je een nieuwe versie overneemt, raadt Google aan die vanaf een apart endpoint te leveren, zodat het verkeer kan terugsturen naar het oude als er iets misgaat.
WISLR stelt UCP in voor merken en voor klanten van bureaus
Elke stap hierboven maakt deel uit van de dienst Agentic Commerce Optimization van WISLR. We toetsen de catalogus aan de eisen van Google, corrigeren en vervolledigen de productdata, bereiden Merchant Center en de aanmeldfeed voor, en bouwen en testen het UCP-profiel en de endpoints tot de integratie klaar is voor de goedkeuring van Google. Merken schakelen ons rechtstreeks in, en bureaus schakelen ons in onder hun eigen naam om het voor hun klanten in te stellen. Bekijk hoe we UCP instellen en vraag een beoordeling van je catalogus aan.