Google Universal Cart i UCP: Jak przygotować WooCommerce na zakupy przez AI

Rozszerzona i aktualna wersja tego tematu: Universal Commerce Protocol: jak agenci AI zmieniają zakupy w internecie.

#Od kliknięcia do transakcji: Dlaczego tradycyjny model e-commerce się zmienia

Przez ponad dwie dekady mechanizm działania wyszukiwarek w handlu internetowym był niezmienny:

1. Użytkownik wpisywał zapytanie w Google (np. buty do biegania w terenie męskie 43).
2. Wyszukiwarka prezentowała listę linków organicznych lub kafelków produktowych (Google Shopping / Merchant Center).
3. Użytkownik klikał w odnośnik, przechodząc na stronę zewnętrznego sklepu.
4. Na stronie docelowej użytkownik zapoznawał się z kartą produktu, wybierał rozmiar, dodawał produkt do koszyka i przechodził manualny proces checkoutu.

Wraz z rozwojem asystentów multimodalnych i agentów autonomicznych (takich jak OpenAI Operator, Claude Computer Use czy Google Gemini) użytkownicy przestają chcieć manualnie przeklikiwać dziesiątki sklepów, zamykać banery cookie i wypełniać powtarzalne formularze adresowe. Asystent AI otrzymuje polecenie: Znajdź czarne buty do biegania w terenie rozmiar 43 z membraną gore-tex z dostawą do piątku do 600 zł i kup je.

W takim scenariuszu agent AI potrzebuje:

• Błyskawicznego przeszukania bazy ofert spełniających ścisłe kryteria techniczne.
• Odpytania sklepu o precyzyjną, bieżącą dostępność magazynową i ostateczną cenę z uwzględnieniem kosztów wysyłki.
• Zainicjowania procesu zakupowego w sposób ustrukturyzowany, bez renderowania warstwy wizualnej strony.

Właśnie tę rolę spełnia Universal Commerce Protocol. Zamiast traktować sklep internetowy jak dokument HTML do przeczytania (scrapowania), UCP traktuje sklep jak bazę danych i zestaw deterministycznych procedur transakcyjnych.

#Czym jest Universal Commerce Protocol (UCP)

Universal Commerce Protocol to otwarty standard komunikacji stworzony z myślą o ujednoliceniu interakcji między agentami AI a platformami handlowymi. Architektura UCP opiera się na trzech warstwach:

#1. Warstwa semantyczna (Discovery & Capabilities)

Odpowiada za publiczne zadeklarowanie tożsamości sklepu, jego możliwości transakcyjnych oraz reguł biznesowych. Sklep publikuje w standardowej lokalizacji plik manifestu: /.well-known/ucp.json

Manifest ten informuje agentów AI, jakiego typu operacje są obsługiwane (np. zapytanie o ofertę, wycena B2B, natywny checkout, checkout osadzony w iframe), jakie waluty są akceptowane oraz gdzie znajdują się dedykowane endpointy API.

#2. Warstwa danych katalogowych (Structured Product Knowledge)

UCP wykorzystuje i rozbudowuje standard Schema.org w formacie JSON-LD. W przeciwieństwie do uproszczonych implementacji SEO, UCP wymaga precyzyjnego mapowania takich właściwości jak:

• ItemAvailability: precyzyjny stan magazynowy z rozróżnieniem na wysyłkę natychmiastową, zamówienie przedsprzedażowe czy brak towaru.
• PriceSpecification: ceny netto/brutto, stawki podatkowe, waluta oraz progi ilościowe.
• hasMerchantReturnPolicy: formalne reguły zwrotów (czas na zwrot, koszt odesłania, adres centrum zwrotów).
• DeliveryTimeSpecification: gwarantowane okna czasowe doręczenia na podstawie lokalizacji zamawiającego.

#3. Warstwa transakcyjna (Cart & Checkout Protocol)

Jest to serce protokołu, które odróżnia UCP od tradycyjnych feedów XML. UCP definiuje bezpieczny, dwukierunkowy protokół stanowy umożliwiający:

• Utworzenie sesji koszyka (Create Cart Session): Agent przekazuje identyfikatory SKU, wybrane warianty i adres dostawy.
• Tymczasową rezerwację stanu (Hold Inventory): Sklep blokuje sztukę magazynową na określony czas (np. 15 minut) pod unikalnym kluczem idempotencji.
• Kalkulację podatków i logistyki (Calculate Final Totals): Sklep zwraca ostateczną kwotę do autoryzacji.
• Przetworzenie płatności (Payment Handshake): W zależności od konfiguracji realizowane natywnie (poprzez Google Pay / portfel agenta z tokenizacją) lub w bezpiecznej, certyfikowanej ramce iframe.

#Różnice architektoniczne: Google Merchant Center vs UCP

Wielu właścicieli sklepów zadaje pytanie: Skoro od lat wysyłam feed produktowy do Google Merchant Center, czy muszę cokolwiek zmieniać?

Odpowiedź brzmi: tak, ponieważ Google Merchant Center i Universal Commerce Protocol realizują zupełnie inne cele w architekturze wyszukiwania.

Klasyczny feed Merchant Center jest dla agenta jedynie indeksem pomocniczym. Kiedy użytkownik podejmuje decyzję w Gemini o zakupie, silnik Google odpytuje bezpośrednio endpointy UCP sklepu, aby upewnić się, że cena i wariant nie zmieniły się w ciągu ostatnich sekund.

#Jak przygotować WooCommerce do integracji z UCP

WooCommerce dzięki swojej modularnej architekturze i wbudowanemu REST API (/wp-json/wc/v3/) stanowi doskonałą bazę do wdrożenia standardu UCP. Nie wystarczy jednak standardowa instalacja: konieczne jest dostosowanie kilku kluczowych obszarów platformy.

#Krok 1: Wdrożenie pliku manifestu /.well-known/ucp.json

Każda domena uczestnicząca w ekosystemie handlu agentowego powinna serwować plik manifestu w katalogu głównym. W środowisku WordPress można to zrealizować poprzez regułę w serwerze www (Nginx/Cloudflare) lub dedykowany endpoint w WordPressie:

{
  "version": "1.0",
  "name": "Przykładowy Sklep WooCommerce",
  "domain": "twojsklep.pl",
  "capabilities": {
    "supportsCart": true,
    "supportsInstantHold": true,
    "supportsQuote": true,
    "checkoutModes": ["native", "iframe"]
  },
  "endpoints": {
    "catalog": "https://twojsklep.pl/wp-json/wc/v3/products",
    "availability": "https://twojsklep.pl/wp-json/ucp/v1/availability",
    "cart": "https://twojsklep.pl/wp-json/ucp/v1/cart",
    "returnPolicy": "https://twojsklep.pl/pl/zwroty-i-reklamacje/"
  },
  "supportedCurrencies": ["PLN", "EUR"],
  "contactEmail": "[email protected]"
}

Taki manifest informuje agenta Google o parametrach technicznych sklepu jeszcze przed rozpoczęciem operacji na konkretnym produkcie.

#Krok 2: Wzbogacenie danych Schema.org o kluczowe atrybuty logistyczne

Podstawowy kod Schema.org generowany przez popularne wtyczki SEO często ogranicza się do nazwy, zdjęcia i prostej ceny. Dla agentów realizujących zakupy to za mało.

Do tablicy Product i Offer należy wstrzyknąć parametry hasMerchantReturnPolicy oraz shippingDetails. Oto przykład filtru PHP dla WooCommerce:

add_filter('woocommerce_structured_data_product_offer', function($offer, $product) {
    if (!$product instanceof WC_Product) {
        return $offer;
    }

    $offer['priceSpecification'] = [
        '@type' => 'PriceSpecification',
        'price' => wc_format_decimal($product->get_price(), 2),
        'priceCurrency' => get_woocommerce_currency(),
        'valueAddedTaxIncluded' => wc_prices_include_tax() ? 'true' : 'false'
    ];

    $offer['hasMerchantReturnPolicy'] = [
        '@type' => 'MerchantReturnPolicy',
        'applicableCountry' => 'PL',
        'returnPolicyCategory' => 'https://schema.org/MerchantReturnFiniteReturnWindow',
        'merchantReturnDays' => 30,
        'returnMethod' => 'https://schema.org/ReturnByMail',
        'returnFees' => 'https://schema.org/FreeReturn'
    ];

    $offer['shippingDetails'] = [
        '@type' => 'OfferShippingDetails',
        'shippingRate' => [
            '@type' => 'MonetaryAmount',
            'value' => '15.00',
            'currency' => get_woocommerce_currency()
        ],
        'shippingDestination' => [
            '@type' => 'DefinedRegion',
            'addressCountry' => 'PL'
        ],
        'deliveryTime' => [
            '@type' => 'ShippingDeliveryTime',
            'handlingTime' => [
                '@type' => 'QuantitativeValue',
                'minValue' => 0,
                'maxValue' => 1,
                'unitCode' => 'DAY'
            ],
            'transitTime' => [
                '@type' => 'QuantitativeValue',
                'minValue' => 1,
                'maxValue' => 2,
                'unitCode' => 'DAY'
            ]
        ]
    ];

    return $offer;
}, 10, 2);

Dzięki temu agent w Google Gemini może bezbłędnie ocenić, czy dany produkt dotrze do klienta na czas i ile wyniesie całkowity koszt zakupu.

#Krok 3: Szybkie endpointy sprawdzania dostępności i rezerwacji koszyka

Standardowe endpointy WooCommerce bywają obciążone ciężkimi procesami (inicjalizacja sesji, hooki motywu, sprawdzanie rabatów koszyka). Zapytanie od agenta AI musi otrzymać odpowiedź w czasie poniżej 150 milisekund.

Zalecanym podejściem jest stworzenie lekkiego kontrolera REST API rejestrowanego w WordPressie:

add_action('rest_api_init', function () {
    register_rest_route('ucp/v1', '/availability', [
        'methods' => 'POST',
        'callback' => 'handle_ucp_availability_check',
        'permission_callback' => '__return_true',
    ]);
});

function handle_ucp_availability_check(WP_REST_Request $request) {
    $sku = sanitize_text_field($request->get_param('sku'));
    $quantity = max(1, intval($request->get_param('quantity')));

    $product_id = wc_get_product_id_by_sku($sku);
    if (!$product_id) {
        return new WP_Error('not_found', 'Produkt nie istnieje', ['status' => 404]);
    }

    $product = wc_get_product($product_id);
    $in_stock = $product->is_in_stock();
    $stock_qty = $product->get_stock_quantity();

    $available = $in_stock && ($stock_qty === null || $stock_qty >= $quantity);

    return rest_ensure_response([
        'sku' => $sku,
        'available' => $available,
        'stockQuantity' => $stock_qty,
        'price' => wc_format_decimal($product->get_price(), 2),
        'currency' => get_woocommerce_currency(),
        'holdDurationSeconds' => 900 // Gwarancja rezerwacji ceny/stanu na 15 min
    ]);
}

Endpoint ten nie ładuje zbędnego narzutu wizualnego, operuje bezpośrednio na identyfikatorach magazynowych i zwraca ścisły, zwięzły format JSON.

#Krok 4: Zabezpieczenie idempotentności i integralności zamówień

Głównym wyzwaniem w komunikacji między agentami AI a sklepem internetowym są zakłócenia sieciowe oraz powtórzenia zapytań (retry logic). Jeżeli agent po wysłaniu żądania rezerwacji nie otrzyma odpowiedzi w ciągu 3 sekund, wyśle żądanie ponownie.

Bez odpowiednich zabezpieczeń sklep mógłby dwukrotnie obciążyć konto klienta lub zarezerwować dwie sztuki towaru zamiast jednej.

Rozwiązaniem jest klucz idempotencji (Idempotency Key):

1. Agent generuje unikalny token UUIDv4 dla każdej intencji transakcyjnej i przesyła go w nagłówku X-Idempotency-Key.
2. WooCommerce zapisuje wynik operacji powiązany z tym kluczem w pamięci podręcznej (np. Redis lub dedykowanej tabeli bazy danych) na określony czas.
3. Wszelkie kolejne zapytania z tym samym kluczem nie wykonują ponownie logiki biznesowej, lecz zwracają zapisany wcześniej wynik.

#Problem utraty tagów UTM: Jak poprawnie mierzyć ruch z platform AI

Jednym z najważniejszych odkryć ostatnich miesięcy w analityce e-commerce jest zjawisko wycinania parametrów śledzących przez systemy AI.

Badania nad zachowaniem platform takich jak ChatGPT, Gemini czy Perplexity (w tym szeroko dyskutowane analizy opublikowane jesienią 2026 roku) wykazały, że linki wychodzące prezentowane użytkownikom w odpowiedziach generatywnych bardzo często są pozbawiane parametrów utm_source, utm_medium czy utm_campaign. Systemy te dążą do oczyszczenia adresu URL z identyfikatorów śledzących w trosce o prywatność i czytelność.

Konsekwencje dla sklepów są dotkliwe:

• W panelu Google Analytics 4 wizyty z rekomendacji AI są błędnie klasyfikowane jako ruch bezpośredni (Direct).
• Zespoły marketingowe nie są w stanie oszacować rzeczywistego zwrotu z inwestycji (ROI) w optymalizację pod kątem silników generatywnych (GEO).

#Rozwiązanie: Atrybucja oparta na document.referrer

Gdy parametry URL zostają wyczyszczone, jedynym wiarygodnym źródłem informacji po stronie przeglądarki staje się nagłówek Referer (dostępny w obiekcie document.referrer).

Nowoczesna warstwa analityczna powinna przechwytywać ten sygnał w momencie wejścia użytkownika na stronę i mapować go na odpowiedni kanał:

• Źródła takie jak https://chatgpt.com/, https://chat.openai.com/ lub referencje aplikacji mobilnej android-app://com.openai.chatgpt powinny być automatycznie mapowane na źródło ai:chatgpt oraz medium ai-referral.
• Podobnie referencje z domen https://www.perplexity.ai/, https://claude.ai/ czy https://gemini.google.com/.

Co kluczowe: dane te muszą zostać utrwalone w sesji użytkownika (First-Touch Attribution), aby w momencie, gdy użytkownik po zapoznaniu się z ofertą przejdzie do kontaktu lub zakupu kilka podstron później, pierwotne źródło pozyskania nie zostało zastąpione przez wewnętrzne odnośniki. Taki model pozwala na precyzyjne wykazanie, ile zamówień w WooCommerce miało swój początek w rekomendacji asystenta AI.

#Relacja między UCP, Model Context Protocol (MCP) i WordPress

W dyskusjach na temat sztucznej inteligencji w WordPressie często pojawiają się dwa skróty: UCP oraz MCP. Warto precyzyjnie wyjaśnić ich role:

1. Model Context Protocol (MCP): To otwarta specyfikacja opublikowana przez firmę Anthropic pod koniec 2024 roku. MCP definiuje, w jaki sposób modele językowe łączą się z zewnętrznymi narzędziami i bazami wiedzy. W kontekście WordPressa, serwer MCP umożliwia modelowi AI np. bezpieczne odczytanie artykułów, pobranie listy kategorii czy stworzenie szkicu wpisu. To interfejs funkcyjny dla asystenta.
2. Universal Commerce Protocol (UCP): To standard biznesowy i transakcyjny skoncentrowany na handlu. Podczas gdy MCP mówi jak wywołać funkcję, UCP definiuje co oznacza koszyk, jak wygląda gwarancja ceny, kiedy następuje autoryzacja płatności i jak sformalizować politykę zwrotów.

W zaawansowanych wdrożeniach WooCommerce te dwa światy się uzupełniają. Sklep udostępnia serwer MCP do zadań analitycznych i eksploracji katalogu, natomiast transakcje finansowe i rezerwację stanów powierza zoptymalizowanym procedurom UCP.

Stanowisko Automattic z kwietnia 2026 roku, wskazujące WordPress jako naturalny system operacyjny dla agentowej sieci web, potwierdza ten kierunek: otwarty ekosystem WordPressa stanowi idealną przeciwwagę dla zamkniętych platform SaaS, dając właścicielom sklepów pełną suwerenność nad danymi transakcyjnymi i relacjami z klientami.

#Podsumowanie i plan działania dla właścicieli sklepów

Uruchomienie Google Universal Cart w wyszukiwarce i Gemini to wyraźny sygnał: zakupy przez asystentów AI przestały być eksperymentem laboratoryjnym, a stały się elementem codzienności rynkowej.

Aby Twój sklep WooCommerce był przygotowany na tę zmianę:

1. Wykonaj audyt danych strukturalnych: Upewnij się, że Twoje produkty zwracają precyzyjne właściwości cenowe, logistyczne i warunki zwrotów zgodne z najnowszymi wytycznymi Schema.org.
2. Opublikuj manifest UCP: Przygotuj plik /.well-known/ucp.json deklarujący gotowość Twojego sklepu do współpracy z agentami.
3. Zoptymalizuj REST API: Zadbaj o to, aby endpointy sprawdzające stany magazynowe i koszyk odpowiadały natychmiastowo i obsługiwały klucze idempotencji.
4. Wdróż odporną analitykę: Nie polegaj wyłącznie na tagach UTM. Zadbaj o rejestrowanie referencji pochodzących z systemów AI w kodzie śledzącym.

Jeżeli potrzebujesz wsparcia architektonicznego lub wdrożeniowego w przygotowaniu swojego sklepu WooCommerce na wymogi handlu agentowego, zapraszamy do zapoznania się z naszą ofertą wdrożeń Universal Commerce Protocol oraz integracji AI w WordPressie. Skontaktuj się z nami poprzez formularz kontaktowy, aby omówić szczegóły projektu.