Jak skonfigurować Universal Commerce Protocol w swoim sklepie.Google musi zatwierdzić integrację, zanim kupujący będzie mógł kupić u Ciebie w AI Mode albo Gemini.

Kupujący w AI Mode od Google prosi o produkt, agent znajduje go w Twoim katalogu, a zakup odbywa się bez tego, by kupujący choć raz wczytał Twoją stronę. Universal Commerce Protocol (UCP) pozwala agentowi to zrobić i działa tylko wtedy, gdy Twój sklep odpowiada poprawnie w chwili, gdy agent pyta. Co musi publikować Twój sklep? Które produkty może kupić agent? Co sprawdza Google, zanim pozwoli Ci uruchomić integrację? W pracach nad UCP, które prowadziliśmy, strona produktu za każdym razem wiedziała więcej niż feed, a endpoint zbudowany tylko na podstawie feedu dałby agentom mniej do pracy, niż kupujący widzi na stronie.

UCP to otwarty standard, a Twój sklep publikuje to, co obsługuje

UCP został opracowany przez Google wspólnie z Shopify, Etsy, Wayfair, Target i Walmart, a jego specyfikacja znajduje się na ucp.dev. Twój sklep jest sprzedawcą (merchant of record): zachowujesz klienta, zamówienie i odpowiedzialność za płatność, a agent działa w imieniu kupującego.

Wszystko zaczyna się od profilu, który Twój sklep publikuje pod adresem /.well-known/ucp. Podaje on wersję protokołu, oferowane usługi i sposób dotarcia do nich, handlery płatności oraz klucze publiczne, za pomocą których agent weryfikuje Twoje podpisane wiadomości. Agent czyta go, zanim zrobi cokolwiek innego.

Wersje UCP to daty. Najnowsza specyfikacja według stanu na październik 2026 to 2026-08-25, a przewodniki wdrożeniowe Google używają wersji 2026-04-08. Sklep może udostępniać REST, MCP, A2A albo osadzony checkout, a REST jest podstawowym z nich.

Krok 1: Popraw błędne dane produktowe

Google odczytuje feed według harmonogramu, ale agent wywołuje endpoint UCP w czasie rzeczywistym, więc wszystko, co jest błędne w Twoich danych, trafia do kupującego w chwili zakupu i nikt nie może tego wyłapać. Poprawiamy błędne dane, zanim cokolwiek dodamy, a te poprawki przynoszą korzyści w Merchant Center niezależnie od tego, czy UCP kiedykolwiek zostanie uruchomiony.

Przechowuj numery GTIN jako tekst na każdym etapie. System, który traktuje je jak liczby, usuwa zera wiodące i GTIN przestaje się zgadzać. Sprawdzaj każdy z nich w rekordzie GS1 producenta, zamiast dopełniać go, aż będzie pasował.

Krok 2: Dodaj dane, których agent potrzebuje do sfinalizowania zakupu

Strony produktów zwykle zawierają więcej niż feed: pełną galerię zdjęć, markę, oceny, prawdziwą cenę katalogową i warunki dostawy. Agent widzi tylko to, co mu wyślesz.

• Rozbudowane opisy. Umieść główny wyróżnik produktu na początku, bo agent może zacytować tylko sam początek. Jasno podaj ograniczenia, takie jak limity wagi, wymagania dotyczące zasilania i miejsca, do których produkt można wysłać, a wymiary podaj w obu systemach miar.
• Osobne warianty. Produkt nadrzędny z rozmiarami lub kolorami spłaszczonymi do jednego wiersza musi stać się jednym wierszem na wariant, pogrupowanym za pomocą item_group_id.
• Wysyłka, zwroty i gwarancja jako dane, a nie tylko jako akapity na stronie z zasadami.
• Każde zdjęcie, które pokazuje strona. Feed, który zawiera tylko pierwsze, zostawia agentowi mniej, niż widzi kupujący.
• Bieżące stany magazynowe zamiast flagi dostępny albo niedostępny. Google wymaga sprawdzenia stanu magazynowego na żywo podczas checkoutu oraz błędu out_of_stock, gdy produkt się wyprzeda.

Merchant Center ogranicza opis do 5,000 znaków i nie chce w nim szczegółów promocyjnych, takich jak ceny czy oferty wysyłki, natomiast opis w UCP może zawierać dostawę, gwarancję i ograniczenia. Napisz pełną wersję dla UCP i skróć ją na potrzeby feedu.

Ceny w UCP to liczby całkowite w najmniejszej jednostce waluty, więc $129.99 jest wysyłane jako 12999. Błąd w jednostce zmienia cenę produktu stukrotnie, w jedną lub w drugą stronę, więc sprawdź to, zanim cokolwiek zostanie uruchomione.

Krok 3: Zdecyduj, które produkty agent może kupić

Wytyczne Google dotyczące Merchant Center wykluczają z checkoutu przez agentów całe kategorie, w tym:

• subskrypcje oraz plany ratalne i finansowania;
• produkty personalizowane, artykuły odnowione, używane i bez możliwości zwrotu oraz przedsprzedaż;
• usługi w pakiecie, takie jak montaż lub rozszerzone gwarancje, fracht i dostawę premium oraz aktywację w sklepie;
• produkty z ograniczeniem wiekowym i zabronione, usługi, wynajem i przedmioty wirtualne.

Pomiń je, a pozostałe zgłaszaj produkt po produkcie.

Drogi produkt, który wielu kupujących kupuje w ramach planu finansowania, może sprzedawać się gorzej przez checkout z portfelem cyfrowym, który tego planu nie oferuje. Zmierz, ile zamówień na ten produkt korzysta z finansowania, zanim włączysz dla niego checkout przez agentów. Sklep może też publikować swój katalog dla agentów i zachować checkout na własnej stronie, co jest prawidłową konfiguracją UCP i często właściwym pierwszym etapem.

Krok 4: Przygotuj Merchant Center

Przewodnik wdrożeniowy Google zaczyna się od Merchant Center: konto musi mieć dobry status, a produkty muszą być zatwierdzone do bezpłatnych informacji o produktach.

• Zasady zwrotów. Ustaw koszt zwrotu, termin zwrotu i link do pełnych zasad, na poziomie konta albo dla każdego produktu za pomocą atrybutu returns. Google pokazuje je na ekranie checkoutu.
• Obsługa klienta. Dodaj co najmniej jedną metodę kontaktu: stronę pomocy, adres e-mail albo numer telefonu. Na tej podstawie działa link “Contact Merchant” w potwierdzeniu zamówienia.
• Zgłoś produkty. Ustaw native_commerce(checkout_eligibility) na TRUE dla każdego kwalifikującego się produktu. Google zaleca dodatkowe źródło danych, aby zgłoszenie nie zakłócało Twojego głównego feedu.
• Informacje regulacyjne. Produkty z zastrzeżeniem prawnym, ostrzeżeniem dotyczącym bezpieczeństwa lub ostrzeżeniem Proposition 65 wymagają atrybutu consumer_notice z typem i komunikatem o długości do 1,000 znaków.
• Zgodne identyfikatory. id w feedzie musi odpowiadać identyfikatorowi produktu, którego oczekuje Twój checkout. Jeśli się różnią, wyślij merchant_item_id.

Krok 5: Zapisz się na listę oczekujących Google

Google podaje, że integracja “musi zostać zatwierdzona przez Google, zanim będzie można ją uruchomić” w AI Mode i Gemini. Drogą do tego jest formularz zgłaszania zainteresowania integracją UCP w Centrum pomocy Merchant Center, który umieszcza Twój sklep na liście oczekujących. Osadzony checkout, w którym Twój własny checkout działa wewnątrz interfejsu Google, jest dostępny tylko dla zatwierdzonych sprzedawców. Wyślij formularz, gdy budujesz integrację, bo zatwierdzenie to etap, którego nie możesz samodzielnie przyspieszyć.

Krok 6: Zbuduj profil i endpointy

Sklep albo korzysta z obsługi UCP wbudowanej w swoją platformę e-commerce, albo ją buduje. Tam, gdzie budujemy, umieszczamy przed sklepem cienką usługę, która komunikuje się z agentami w UCP, a ze sklepem przez własne API platformy, osadzoną w domenie sklepu, aby profil i endpointy miały jeden origin. UCP jest często zmieniany, a trzymanie go poza platformą oznacza, że nowa wersja nie czeka na wydanie platformy.

• Publikuj tylko to, co działa. Agent, który znajdzie checkout w Twoim profilu, spróbuje z niego skorzystać. Pierwsze wydanie może deklarować samo wyszukiwanie i pobieranie produktów z katalogu, a checkout dodać, gdy będzie gotowy.
• Używaj prawdziwych kluczy podpisu. Klucze publiczne w profilu weryfikują Twoje podpisane aktualizacje zamówień, więc wygeneruj parę kluczy i trzymaj część prywatną na serwerze.
• Zadbaj o bezpieczne ponowienia. Akceptuj klucz idempotencji w wywołaniach checkoutu, aby powtórzone żądanie nie obciążyło klienta dwa razy.
• Udostępniaj wszystko przez HTTPS. Specyfikacja REST wymaga co najmniej TLS 1.3.
• Waliduj adresy. Zwracaj adres, pod który nie da się dostarczyć, jako błąd możliwy do naprawienia, aby kupujący mógł go poprawić, zamiast utknąć w ślepej uliczce.
• Podlinkuj swoje zasady. Twoje warunki obowiązują przy każdym zakupie przez UCP, więc umieść w odpowiedzi checkoutu linki do polityki prywatności, regulaminu, zasad zwrotu pieniędzy i zasad wysyłki.

Krok 7: Podłącz płatności

Na ścieżce natywnego checkoutu Google Twój profil deklaruje handler płatności Google Pay. Nie potrzebujesz Google Pay API na własnej stronie, ale Twój operator płatności musi akceptować tokeny płatności Google, a większość dużych operatorów to robi. FAQ Google zaznacza, że interfejsy AI Google używają wyłącznie metody autoryzacji PAN_ONLY, a ustawienia Google Pay w profilu używają nazw w formacie snake_case. Trzymaj dane uwierzytelniające operatora dla środowiska testowego i produkcyjnego osobno i nigdy ich nie zapisuj w logach.

Krok 8: Testuj tak, jak będzie testować Google

Google wysyła kontrole stanu z user agentem Google-UCP-Prober/1.0, a żądania agentów oznacza nagłówkiem UCP-Agent i user agentem zaczynającym się od Google/UCP. Zanim złożysz zgłoszenie, odpytaj własne endpointy tak, jak zrobiłby to Google.

• Czy /.well-known/ucp dociera do Twojego sklepu? Reguła serwera WWW może odpowiedzieć na tę ścieżkę własnym błędem 404, zanim żądanie w ogóle dotrze do aplikacji, nawet gdy Twoje endpointy UCP działają.
• Czy Twoja zapora przepuszcza Google? Ochrona przed botami, która blokuje ruch skryptowy, zablokuje też sondę, więc przepuszczaj żądania UCP od Google na podstawie ich nagłówków, a nie adresu.
• Czy chronione endpointy działają poprawnie? Endpointy checkoutu, płatności i zamówień powinny odrzucać żądania bez danych uwierzytelniających i akceptować te od Google.

Krok 9: Zaplanuj kolejną wersję UCP

Specyfikacja 2026-08-25 dodaje standardowe zasady zwrotów i gwarancji, których nie ma 2026-04-08, a Google dokumentuje 2026-04-08. Dopóki przewodniki Google nie przyjmą nowszej wersji, tę informację przekazują Twoje zasady zwrotów w Merchant Center. Gdy przyjmiesz nową wersję, Google zaleca udostępnianie jej z osobnego endpointu, aby w razie awarii móc skierować ruch z powrotem do starej.

WISLR konfiguruje UCP dla marek i dla klientów agencji

Każdy powyższy krok jest częścią usługi Agentic Commerce Optimization od WISLR. Audytujemy katalog pod kątem wymagań Google, poprawiamy i uzupełniamy dane produktowe, przygotowujemy Merchant Center i feed zgłoszeniowy oraz budujemy i testujemy profil UCP i endpointy, aż integracja będzie gotowa do zatwierdzenia przez Google. Marki zlecają nam to bezpośrednio, a agencje zlecają nam to pod własną nazwą, aby skonfigurować UCP dla swoich klientów. Zobacz, jak konfigurujemy UCP i poproś o ocenę swojego katalogu.