Google Universal Cart og UCP: Slik forbereder du WooCommerce for AI-agenter

Utvidet og oppdatert versjon av dette emnet: Universal Commerce Protocol: hvordan KI-agenter endrer netthandel.

#Fra klikk til maskinell handel: Hvorfor den gamle modellen forsvinner

I mer enn tjue år har netthandel via søkemotorer fulgt en fast rutine:

1. Brukeren taster inn et søk (for eksempel vanntette terrengløpesko herre str 43).
2. Søkemotoren viser en liste over organiske treff og Google Shopping-annonser.
3. Brukeren klikker på en lenke og sendes videre til nettbutikkens nettside.
4. På butikkens side må kunden velge størrelse, godta informasjonskapsler, legge varen i handlekurven og manuelt fylle ut betalingsskjemaet.

Med fremveksten av multimodale AI-assistenter og autonome nettleseragenter endrer dette mønsteret seg drastisk. Forbrukere ønsker ikke lenger å besøke ti ulike nettsteder, taste inn adresseopplysninger på nytt eller håndtere uoversiktlige kasser. Oppgaven gis direkte til assistenten: Finn sorte terrengløpesko med Gore-Tex i størrelse 43 levert innen fredag til under 1500 kroner, og kjøp dem.

For å fullføre en slik ordre autonomt trenger AI-agenten:

• Umiddelbar tilgang til å søke i katalogdata basert på presise tekniske spesifikasjoner.
• Sanntidsbekreftelse av lagerbeholdning og endelig totalpris inkludert frakt.
• Et standardisert grensesnitt for å gjennomføre ordren uten manuell klikking.

Det er nettopp dette Universal Commerce Protocol løser. I stedet for å behandle en nettbutikk som en samling HTML-sider som må skrapes, definerer UCP butikken som en strukturert database med tilhørende transaksjons-API-er.

#Arkitekturen bak Universal Commerce Protocol

Universal Commerce Protocol er bygget opp av tre komplementære lag:

#1. Det semantiske oppdagelseslaget (Capabilities)

Dette laget gjør det mulig for nettbutikken å deklarere sin identitet, sine forretningsregler og sine støttede transaksjonsmetoder. Butikken publiserer en standardfil i rotkatalogen: /.well-known/ucp.json

Manifestet informerer AI-agenter om hvilke operasjoner som støttes (for eksempel direkte forespørsel, B2B-pristilbud, nativ Google Pay-betaling eller innebygd iframe-kasse), hvilke valutaer som godtas, og hvor de relevante API-endepunktene befinner seg.

#2. Det strukturerte kataloglaget (Kunnskapsgraf)

UCP bygger videre på Schema.org i JSON-LD-format, men stiller langt strengere krav til fullstendighet enn tradisjonell SEO:

• ItemAvailability: Presise lagerstatusflagg som skiller mellom varer på lager, forhåndsbestilling og midlertidig utsolgte varer.
• PriceSpecification: Tydelig oppdeling av netto- og bruttopriser, merverdiavgift, valuta og eventuelle volumrabatter.
• hasMerchantReturnPolicy: Maskinlesbare returvilkår, inkludert returfrist, hvem som dekker returfrakt, og returadresse.
• DeliveryTimeSpecification: Garanterte leveringsvinduer beregnet ut fra mottakerens postnummer eller region.

#3. Det tilstandsbaserte transaksjonsprotokollet

I motsetning til statiske produktfeeder tilbyr UCP en sikker, toveis dialog under selve kjøpsprosessen:

• Opprettelse av handlekurv: Agenten sender over varenumre (SKU), valgte varianter og leveringsadresse.
• Midlertidig varereservasjon (Hold Lock): Nettbutikken låser varen på lager i et begrenset tidsrom (for eksempel 15 minutter) under en unik idempotensnøkkel.
• Beregning av frakt og avgifter: Butikken returnerer det endelige, garanterte beløpet.
• Betalingsfullføring: Kjøpet autoriseres enten direkte via en digital lommebok eller gjennom en sikker, innebygd iframe.

#Google Merchant Center vs Universal Commerce Protocol

Det er lett å tro at en eksisterende produktfeed til Google Merchant Center er tilstrekkelig. Disse systemene har imidlertid vidt forskjellige formål:

Merchant Center fungerer som et indeksregister. Men i det øyeblikket en kunde i Gemini godkjenner et kjøp, kontakter Googles motor butikkens UCP-endepunkter for å verifisere at pris og lagerbeholdning stemmer nøyaktig der og da.

#Teknisk implementering i WooCommerce

WooCommerce har en fleksibel arkitektur og et veldokumentert REST API (/wp-json/wc/v3/), men krever målrettet optimalisering for å håndtere kravene fra AI-agenter.

#1. Oppsett av /.well-known/ucp.json

Filen må være tilgjengelig på nettstedets rotadresse:

{
  "version": "1.0",
  "name": "Norsk Eksempelbutikk",
  "domain": "eksempelbutikk.no",
  "capabilities": {
    "supportsCart": true,
    "supportsInstantHold": true,
    "supportsQuote": true,
    "checkoutModes": ["native", "iframe"]
  },
  "endpoints": {
    "catalog": "https://eksempelbutikk.no/wp-json/wc/v3/products",
    "availability": "https://eksempelbutikk.no/wp-json/ucp/v1/availability",
    "cart": "https://eksempelbutikk.no/wp-json/ucp/v1/cart",
    "returnPolicy": "https://eksempelbutikk.no/nb/retur-og-reklamasjon/"
  },
  "supportedCurrencies": ["NOK", "EUR"],
  "contactEmail": "[email protected]"
}

#2. Berikelse av Schema.org i PHP

For at AI-agenter skal kunne bekrefte fraktkostnader og leveringstider, må dataene legges inn i produktets strukturerte data:

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' => 'NO',
        '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' => '79.00',
            'currency' => get_woocommerce_currency()
        ],
        'shippingDestination' => [
            '@type' => 'DefinedRegion',
            'addressCountry' => 'NO'
        ],
        'deliveryTime' => [
            '@type' => 'ShippingDeliveryTime',
            'handlingTime' => [
                '@type' => 'QuantitativeValue',
                'minValue' => 0,
                'maxValue' => 1,
                'unitCode' => 'DAY'
            ],
            'transitTime' => [
                '@type' => 'QuantitativeValue',
                'minValue' => 1,
                'maxValue' => 3,
                'unitCode' => 'DAY'
            ]
        ]
    ];

    return $offer;
}, 10, 2);

#3. Raske endepunkter for lagersjekk og reservasjon

Ordinære WooCommerce-kassesteg krever ofte betydelig prosessorkraft. Forespørsler fra AI-agenter må derimot besvares på under 150 millisekunder.

Løsningen er å registrere et lettvektsendepunkt:

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

function handle_ucp_fast_availability(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', 'Produktet finnes ikke', ['status' => 404]);
    }

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

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

    return rest_ensure_response([
        'sku' => $sku,
        'available' => $is_available,
        'stockQuantity' => $stock_qty,
        'price' => wc_format_decimal($product->get_price(), 2),
        'currency' => get_woocommerce_currency(),
        'holdDurationSeconds' => 900 // 15 minutters reservasjonsgaranti
    ]);
}

#4. Idempotens for trygg ordrehåndtering

Når en AI-agent utfører handlinger over nettverket, vil midlertidige forsinkelser føre til at agenten sender forespørselen på nytt. Uten sikring risikerer butikken å reservere eller belaste samme vare to ganger.

Dette løses ved at agenten sender en unik X-Idempotency-Key i HTTP-hodet. Butikken lagrer resultatet av transaksjonen i hurtigminnet (f.eks. Redis). Dersom samme nøkkel mottas på nytt, returneres det lagrede svaret umiddelbart uten nye databaseendringer.

#Utfordringen med UTM-parametre: Slik sikres analysen

Nyere undersøkelser viser at AI-assistenter som ChatGPT og Perplexity fjerner sporingskoder som UTM-parametre fra utgående lenker. Formålet er å beskytte brukernes personvern og rydde opp i lenkestrukturer.

For nettbutikker skaper dette store utfordringer:

• Trafikk fra AI-anbefalinger registreres feilaktig som direkte trafikk (Direct) i analyseverktøyene.
• Det blir umulig å beregne den faktiske avkastningen av synlighet i generativ AI (GEO).

#Løsning: Sporing via document.referrer

Når URL-parametrene er fjernet, er HTTP-referansen i nettleseren den eneste pålitelige informasjonen.

Nettbutikkens sporingsskript må fange opp document.referrer ved første sidevisning:

• Henvisninger fra chatgpt.com, chat.openai.com eller mobilapp-ID-er klassifiseres som ai:chatgpt.
• Tilsvarende gjelder for perplexity.ai, claude.ai og gemini.google.com.
• Denne informasjonen lagres i sesjonsminnet slik at den følger kunden frem til et eventuelt kjøp, selv om brukeren klikker seg gjennom flere undersider.

#Samspillet mellom UCP, Anthropic MCP og WordPress

I diskusjoner om AI og WordPress møter man ofte både UCP og MCP (Model Context Protocol):

• Model Context Protocol (MCP): En åpen standard utviklet av Anthropic i november 2024. Den definerer hvordan AI-modeller kaller verktøy, søker i databaser og leser innhold. Det er et generelt grensesnitt for verktøybruk.
• Universal Commerce Protocol (UCP): En spesialisert forretningsstandard for handel. UCP definerer spillereglene for handlekurver, lagerlåsing, betalingssikkerhet og returer.

I moderne installasjoner utfyller disse hverandre. En MCP-server gir agenten mulighet til å navigere i katalogen og stille spørsmål om produkter, mens UCP håndterer den sikre transaksjonen. Automattics visjon om WordPress som et operativsystem for den agentiske weben understreker fordelen med åpne kilder: butikkeieren beholder full kontroll over egne kundeforhold og transaksjonsdata.

#Oppsummering og anbefalte tiltak

Lanseringen av Google Universal Cart markerer starten på en ny ære for netthandel.

Anbefalte tiltak for WooCommerce-butikker:

1. Gjennomfør en Schema-gjennomgang: Sørg for at priser, returregler og leveringsbetingelser er oppgitt i henhold til Schema.org.
2. Etabler UCP-manifestet: Plasser en gyldig /.well-known/ucp.json-fil på nettstedet.
3. Optimaliser REST API: Skill lagersjekk og handlekurvlåsing fra tunge frontend-prosesser for å sikre svartider under 150 ms.
4. Oppgrader analysen: Legg inn referrersporing for å fange opp trafikk fra AI-plattformer uten UTM-koder.

Ta gjerne kontakt med oss for bistand med arkitektur og implementering. Les mer om våre tjenester innen Universal Commerce Protocol og AI-integrasjon for WordPress, eller send oss en henvendelse via vårt kontaktskjema.