Cara menyediakan Universal Commerce Protocol untuk kedai anda.Google perlu meluluskan integrasi itu sebelum pembeli boleh membeli daripada anda dalam AI Mode atau Gemini.

Seorang pembeli dalam AI Mode Google bertanya tentang sesuatu produk, ejen menemuinya dalam katalog anda, dan pembelian berlaku tanpa pembeli pernah memuatkan laman anda. Universal Commerce Protocol (UCP) membolehkan ejen melakukannya, dan ia hanya berfungsi apabila kedai anda menjawab dengan betul pada saat ejen bertanya. Apakah yang perlu diterbitkan oleh kedai anda? Produk mana yang boleh dibeli oleh ejen? Apakah yang disemak oleh Google sebelum membenarkan anda disiarkan secara langsung? Dalam kerja UCP yang telah kami lakukan, halaman produk sentiasa mengandungi lebih banyak maklumat daripada suapan, dan endpoint yang dibina daripada suapan sahaja akan memberi ejen kurang bahan berbanding apa yang dilihat pembeli pada halaman.

UCP ialah standard terbuka, dan kedai anda menerbitkan apa yang disokongnya

UCP dibangunkan oleh Google bersama Shopify, Etsy, Wayfair, Target dan Walmart, dan spesifikasinya terdapat di ucp.dev. Kedai anda ialah merchant of record: anda mengekalkan pelanggan, pesanan dan liabiliti pembayaran, dan ejen bertindak bagi pihak pembeli.

Semuanya bermula dengan profil yang diterbitkan oleh kedai anda di /.well-known/ucp. Ia menamakan versi protokol, perkhidmatan yang anda tawarkan dan cara untuk mencapainya, pengendali pembayaran anda, dan kunci awam yang digunakan oleh ejen untuk mengesahkan mesej anda yang ditandatangani. Ejen membacanya sebelum melakukan apa-apa yang lain.

Versi UCP ialah tarikh. Spesifikasi terkini setakat Oktober 2026 ialah 2026-08-25, dan panduan pelaksanaan Google menggunakan 2026-04-08. Sesebuah kedai boleh menyajikan REST, MCP, A2A atau checkout terbenam, dan REST ialah yang teras.

Langkah 1: Betulkan data produk yang salah

Google membaca suapan mengikut jadual, tetapi ejen memanggil endpoint UCP dalam masa nyata, jadi apa sahaja yang salah dalam data anda sampai kepada pembeli pada titik pembelian, tanpa sesiapa di situ untuk mengesannya. Kami membetulkan data yang salah sebelum menambah apa-apa, dan pembetulan ini memberi hasil dalam Merchant Center sama ada UCP dilancarkan atau tidak.

Simpan GTIN sebagai teks dari awal hingga akhir. Sistem yang menganggapnya sebagai nombor akan membuang sifar pendahulu, dan GTIN itu tidak lagi sepadan. Semak setiap satu dengan rekod GS1 pengeluar dan bukannya menambah pad sehingga ia muat.

Langkah 2: Tambah data yang diperlukan ejen untuk menyelesaikan pembelian

Halaman produk biasanya membawa lebih banyak maklumat daripada suapan: galeri imej penuh, jenama, penarafan, harga senarai sebenar dan terma penghantaran. Ejen hanya melihat apa yang anda hantar kepadanya.

• Huraian panjang. Letakkan perbezaan utama produk dahulu, kerana ejen mungkin hanya memetik bahagian permulaan. Nyatakan kekangan dengan jelas, seperti had berat, keperluan kuasa dan ke mana ia boleh dihantar, dan berikan ukuran dalam kedua-dua sistem unit.
• Varian berasingan. Produk induk dengan saiz atau warna yang diratakan ke dalam satu baris perlu menjadi satu baris bagi setiap varian, dikumpulkan dengan item_group_id.
• Penghantaran, pemulangan dan waranti sebagai data, bukan hanya sebagai perenggan pada halaman polisi.
• Setiap imej yang ditunjukkan oleh halaman. Suapan yang hanya membawa imej pertama meninggalkan ejen dengan kurang daripada apa yang dilihat pembeli.
• Tahap stok langsung dan bukannya bendera ada stok atau kehabisan stok. Google memerlukan semakan inventori langsung semasa checkout, dan ralat out_of_stock apabila item telah habis dijual.

Merchant Center mengehadkan huraian kepada 5,000 aksara dan tidak mahu butiran promosi seperti harga atau tawaran penghantaran di dalamnya, manakala huraian UCP boleh membawa penghantaran, waranti dan kekangan. Tulis versi lengkap untuk UCP dan ringkaskannya untuk suapan.

Harga dalam UCP ialah nombor bulat dalam unit terkecil mata wang, jadi $129.99 dihantar sebagai 12999. Kesilapan unit menyebabkan harga produk tersasar dengan faktor seratus, ke mana-mana arah, jadi semaknya sebelum apa-apa disiarkan secara langsung.

Langkah 3: Tentukan produk yang boleh dibeli oleh ejen

Panduan Merchant Center Google mengecualikan keseluruhan kategori daripada checkout ejen, antaranya:

• langganan dan pelan ansuran atau pembiayaan;
• barangan diperibadikan, barangan diperbaharui, terpakai dan jualan muktamad, dan prapesanan;
• perkhidmatan berpakej seperti pemasangan atau waranti lanjutan, penghantaran kargo dan penghantaran premium, dan pengaktifan di kedai;
• produk dengan sekatan umur dan produk larangan, perkhidmatan, sewaan dan item maya.

Kecualikan semua itu, dan pilih masuk yang selebihnya produk demi produk.

Produk berharga tinggi yang dibeli oleh ramai pembeli dengan pelan pembiayaan mungkin kurang laku melalui checkout dompet yang tidak menawarkan pelan itu. Ukur berapa banyak pesanan untuk produk itu menggunakan pembiayaan sebelum anda menghidupkan checkout ejen untuknya. Sesebuah kedai juga boleh menerbitkan katalognya kepada ejen dan mengekalkan checkout di lamannya sendiri, yang merupakan konfigurasi UCP yang sah dan sering kali peringkat pertama yang tepat.

Langkah 4: Sediakan Merchant Center

Panduan pelaksanaan Google bermula dengan Merchant Center: akaun mesti berada dalam kedudukan baik, dengan produk yang diluluskan untuk penyenaraian percuma.

• Polisi pemulangan. Tetapkan kos pemulangan, tempoh pemulangan dan pautan kepada polisi penuh, di peringkat akaun atau bagi setiap produk dengan atribut returns. Google menunjukkannya pada skrin checkout.
• Sokongan pelanggan. Tambah sekurang-kurangnya satu kaedah hubungan: halaman sokongan, alamat e-mel atau nombor telefon. Ia menggerakkan pautan “Contact Merchant” pada pengesahan pesanan.
• Pilih masuk produk. Tetapkan native_commerce(checkout_eligibility) kepada TRUE bagi setiap produk yang layak. Google mengesyorkan sumber data tambahan, supaya pilihan masuk itu tidak mengganggu suapan utama anda.
• Notis kawal selia. Produk yang membawa penafian undang-undang, amaran keselamatan atau amaran Proposition 65 memerlukan consumer_notice, dengan jenisnya dan mesej sehingga 1,000 aksara.
• ID yang sepadan. id suapan mesti sepadan dengan ID produk yang dijangka oleh checkout anda. Jika ia berbeza, hantar merchant_item_id.

Langkah 5: Sertai senarai menunggu Google

Google menyatakan bahawa integrasi “mesti diluluskan oleh Google sebelum anda boleh disiarkan secara langsung” dalam AI Mode dan Gemini. Jalan masuknya ialah borang minat integrasi UCP dalam Merchant Center Help, yang meletakkan kedai anda dalam senarai menunggu. Checkout terbenam, di mana checkout anda sendiri berjalan di dalam permukaan Google, terhad kepada peniaga yang diluluskan. Hantar borang itu semasa anda membina, kerana kelulusan ialah langkah yang tidak dapat anda percepatkan sendiri.

Langkah 6: Bina profil dan endpoint

Sesebuah kedai sama ada menggunakan sokongan UCP yang terbina dalam platform perdagangannya atau membinanya. Apabila kami membinanya, kami meletakkan perkhidmatan nipis di hadapan kedai yang berkomunikasi dalam UCP dengan ejen dan dalam API platform itu sendiri dengan kedai, dipasang di bawah domain kedai supaya profil dan endpoint berkongsi satu asal. UCP kerap disemak semula, dan mengekalkannya di luar platform bermakna versi baharu tidak perlu menunggu keluaran platform.

• Terbitkan hanya apa yang berfungsi. Ejen yang menemui checkout dalam profil anda akan cuba menggunakannya. Keluaran pertama boleh mengiklankan carian dan semakan katalog sahaja, dan menambah checkout apabila ia sedia.
• Gunakan kunci tandatangan sebenar. Kunci awam profil mengesahkan kemas kini pesanan anda yang ditandatangani, jadi jana pasangan kunci dan simpan separuh peribadinya di pelayan.
• Jadikan cubaan semula selamat. Terima kunci idempotensi pada panggilan checkout, supaya permintaan berulang tidak mengenakan caj dua kali.
• Sajikan melalui HTTPS. Spesifikasi REST memerlukan sekurang-kurangnya TLS 1.3.
• Sahkan alamat. Kembalikan alamat yang tidak boleh dihantar sebagai ralat yang boleh dipulihkan, supaya pembeli boleh membetulkannya dan bukannya menemui jalan buntu.
• Pautkan polisi anda. Terma anda terpakai pada setiap pembelian UCP, jadi sertakan pautan ke polisi privasi, terma, bayaran balik dan penghantaran anda dalam respons checkout.

Langkah 7: Sambungkan pembayaran

Pada laluan checkout asli Google, profil anda mengisytiharkan pengendali pembayaran Google Pay. Anda tidak memerlukan Google Pay API di laman anda sendiri, tetapi pemproses pembayaran anda mesti menerima token pembayaran Google, dan kebanyakan pemproses utama menerimanya. FAQ Google menyatakan bahawa permukaan AI-nya hanya menggunakan kaedah kebenaran PAN_ONLY dan bahawa tetapan Google Pay dalam profil menggunakan nama snake_case. Asingkan kelayakan pemproses ujian dan pengeluaran, dan jangan sekali-kali merekodkannya dalam log.

Langkah 8: Uji seperti cara Google akan menguji

Google menghantar semakan kesihatan dengan ejen pengguna Google-UCP-Prober/1.0, dan menandakan permintaan ejen dengan pengepala UCP-Agent dan ejen pengguna yang bermula dengan Google/UCP. Sebelum anda memohon, minta endpoint anda sendiri seperti yang akan dilakukan oleh Google.

• Adakah /.well-known/ucp sampai ke kedai anda? Peraturan pelayan web boleh menjawab laluan itu dengan 404nya sendiri sebelum permintaan sampai ke aplikasi, walaupun endpoint UCP anda berfungsi.
• Adakah firewall anda membenarkan Google masuk? Perlindungan bot yang menyekat trafik berskrip akan menyekat prober juga, jadi benarkan permintaan UCP Google melalui berdasarkan pengepalanya dan bukannya alamat.
• Adakah endpoint yang dilindungi berkelakuan betul? Endpoint checkout, pembayaran dan pesanan sepatutnya menolak permintaan tanpa kelayakan dan menerima kelayakan Google.

Langkah 9: Rancang untuk versi UCP seterusnya

Spesifikasi 2026-08-25 menambah polisi pemulangan dan waranti standard yang tiada dalam 2026-04-08, dan Google mendokumenkan 2026-04-08. Sehingga panduan Google menerima pakai versi yang lebih baharu, polisi pemulangan Merchant Center anda membawa maklumat itu. Apabila anda menerima pakai versi baharu, Google mengesyorkan untuk menyajikannya daripada endpoint berasingan, supaya ia boleh menghantar trafik kembali ke versi lama jika berlaku kerosakan.

WISLR menyediakan UCP untuk jenama dan untuk pelanggan agensi

Setiap langkah di atas ialah sebahagian daripada perkhidmatan Agentic Commerce Optimization WISLR. Kami mengaudit katalog berbanding keperluan Google, membetulkan dan melengkapkan data produk, menyediakan Merchant Center dan suapan pilihan masuk, serta membina dan menguji profil UCP dan endpoint sehingga integrasi sedia untuk kelulusan Google. Jenama melibatkan kami secara terus, dan agensi melibatkan kami di bawah nama mereka sendiri untuk menyediakannya bagi pelanggan mereka. Lihat cara kami menyediakan UCP dan minta penilaian katalog anda.