Google’ın AI Mode’unda bir alışverişçi bir ürün istiyor, ajan onu kataloğunuzda buluyor ve satın alma, alışverişçi sitenizi hiç açmadan gerçekleşiyor. Universal Commerce Protocol (UCP) ajanın bunu yapmasını sağlıyor ve yalnızca ajan sorduğu anda mağazanız doğru yanıt verdiğinde çalışıyor. Mağazanızın ne yayımlaması gerekiyor? Bir ajan hangi ürünleri satın alabilir? Google yayına geçmenize izin vermeden önce neyi kontrol ediyor? Yaptığımız UCP çalışmalarında ürün sayfası her seferinde feed’den daha fazlasını biliyordu ve yalnızca feed’den oluşturulmuş bir uç nokta, ajanlara alışverişçinin sayfada gördüğünden daha azını verirdi.
UCP açık bir standarttır ve mağazanız neyi desteklediğini yayımlar
UCP, Google tarafından Shopify, Etsy, Wayfair, Target ve Walmart ile birlikte geliştirildi ve spesifikasyonu ucp.dev adresinde yer alıyor. Kayıtlı satıcı (merchant of record) mağazanızdır: müşteri, sipariş ve ödeme sorumluluğu sizde kalır, ajan ise alışverişçi adına hareket eder.
Her şey mağazanızın /.well-known/ucp adresinde yayımladığı bir profille başlar. Profil protokol sürümünü, sunduğunuz hizmetleri ve bunlara nasıl ulaşılacağını, ödeme işleyicilerinizi ve bir ajanın imzalı mesajlarınızı doğrulamak için kullandığı açık anahtarları belirtir. Bir ajan başka herhangi bir şey yapmadan önce onu okur.
| Yayımladığınız şey | Ne işe yarar | Google ödemesi için gerekli mi |
|---|---|---|
/.well-known/ucp adresindeki UCP profili |
Sürümünüzü, hizmetlerinizi, ödeme işleyicilerinizi ve imzalama anahtarlarınızı bildirir | Evet |
| Ödeme (checkout) | Bir ödeme oturumu oluşturur, günceller ve tamamlar | Evet, yerel ödeme yolunda |
| Google Pay ödeme işleyicisi | Ajanın, ödeme işlemcinizin kabul ettiği bir Google Pay token’ı ile ödeme yapmasını sağlar | Evet, yerel ödeme yolunda |
| Sipariş yaşam döngüsü | Satın almadan sonra kargoya verildi ve teslim edildi gibi imzalı sipariş güncellemeleri gönderir | Evet, yerel ödeme yolunda |
| Sepet | Google’da oluşturulan bir sepeti tamamlanması için kendi sitenize devreder | Yerel ödemeye alternatif |
| Kimlik bağlama | Misafir ödemesi yerine bir alışverişçinin hesabını OAuth 2.0 ile bağlar | İsteğe bağlı |
| İndirimler | Ödeme sırasında promosyon kodlarını uygular | İsteğe bağlı |
| Katalog arama ve sorgulama | Bir ajanın ürünleri doğrudan sorgulamasını sağlar | Spesifikasyonda isteğe bağlı |
UCP sürümleri tarihlerdir. Ekim 2026 itibarıyla en güncel spesifikasyon 2026-08-25’tir ve Google’ın uygulama rehberleri 2026-04-08’i kullanır. Bir mağaza REST, MCP, A2A ya da gömülü bir ödeme sunabilir ve temel olan REST’tir.
Adım 1: Yanlış olan ürün verilerini düzeltin
Google bir feed’i belirli bir takvimle okur, ancak bir ajan bir UCP uç noktasını gerçek zamanlı çağırır, bu yüzden verilerinizdeki her hata satın alma anında alışverişçiye ulaşır ve onu yakalayacak kimse orada olmaz. Biz bir şey eklemeden önce yanlış verileri düzeltiriz ve bu düzeltmeler UCP hiç yayına girmese de Merchant Center’da karşılığını verir.
| Sorun | Bir ajan için neden önemli |
|---|---|
| Yeni bir ürün ve onun yenilenmiş sürümü gibi iki farklı ürünün tek bir GTIN’i paylaşması | Ajan hangisini satın aldığını ayırt edemez |
| GTIN alanına kopyalanmış bir SKU ya da uzunluğu veya kontrol basamağı yanlış bir GTIN | Ürün, üreticisinin kaydıyla eşleştirilemez |
| Normal fiyata eşit bir indirimli fiyat | Gerçek liste fiyatını gizler, bu yüzden alışverişçinin gördüğü indirim yanlış olur |
| Yönlendiren ürün bağlantıları | Ajanın bağlantısı ile ödeme sayfanız ürünün adresi konusunda uyuşmaz |
| Birbiriyle çelişen stok alanları | Ajan gönderilemeyecek bir şey sunar |
GTIN’leri baştan sona metin olarak tutun. Onları sayı olarak ele alan bir sistem baştaki sıfırları siler ve GTIN artık eşleşmez. Her birini uyana kadar doldurmak yerine üreticinin GS1 kaydıyla karşılaştırarak kontrol edin.
Adım 2: Bir ajanın satın almayı tamamlamak için ihtiyaç duyduğu verileri ekleyin
Ürün sayfaları genellikle feed’den daha fazlasını taşır: tam görsel galerisi, marka, puanlar, gerçek liste fiyatı ve teslimat koşulları. Bir ajan yalnızca ona gönderdiğinizi görür.
- Uzun açıklamalar. Ürünün ana farkını başa koyun, çünkü bir ajan yalnızca girişi alıntılayabilir. Ağırlık sınırları, güç gereksinimleri ve nereye gönderilebileceği gibi kısıtları açıkça belirtin ve ölçüleri iki birim sisteminde de verin.
- Ayrı varyantlar. Bedenleri ya da renkleri tek bir satıra sıkıştırılmış bir ana ürünün,
item_group_idile gruplanmış şekilde varyant başına bir satıra dönüşmesi gerekir. - Veri olarak kargo, iade ve garanti, yalnızca bir politika sayfasındaki paragraflar olarak değil.
- Sayfanın gösterdiği her görsel. Yalnızca ilk görseli taşıyan bir feed, ajana alışverişçinin gördüğünden daha azını bırakır.
- Canlı stok seviyeleri, stokta var ya da stokta yok bayrağı yerine. Google ödeme sırasında canlı bir envanter kontrolü ve ürün tükendiğinde bir
out_of_stockhatası istiyor.
Merchant Center bir açıklamayı 5.000 karakterle sınırlar ve içinde fiyatlar ya da kargo teklifleri gibi promosyon ayrıntıları istemez, bir UCP açıklaması ise teslimatı, garantiyi ve kısıtları taşıyabilir. Tam sürümü UCP için yazın ve feed için kısaltın.
UCP’de fiyatlar para biriminin en küçük biriminde tam sayılardır, yani $129.99 12999 olarak gönderilir. Birimi yanlış almak ürünü iki yönde de yüz kat yanlış fiyatlandırır, bu yüzden herhangi bir şey yayına girmeden önce bunu kontrol edin.
Adım 3: Bir ajanın hangi ürünleri satın alabileceğine karar verin
Google’ın Merchant Center rehberi bütün kategorileri ajan ödemesinin dışında tutar, bunların arasında şunlar var:
- abonelikler ve taksit ya da finansman planları;
- kişiselleştirilmiş ürünler, yenilenmiş, kullanılmış ve iadesiz satılan ürünler ve ön siparişler;
- kurulum ya da uzatılmış garanti gibi paket hizmetler, nakliye (freight) ve premium teslimat ve mağazada aktivasyon;
- yaş sınırlamalı ve yasaklı ürünler, hizmetler, kiralamalar ve sanal öğeler.
Bunları dışarıda bırakın ve geri kalanını ürün ürün dahil edin.
Birçok alışverişçinin bir finansman planıyla satın aldığı yüksek fiyatlı bir ürün, planı sunmayan bir cüzdan ödemesi üzerinden daha kötü satabilir. O ürün için ajan ödemesini açmadan önce o ürüne ait siparişlerin kaçının finansman kullandığını ölçün. Bir mağaza kataloğunu ajanlara yayımlayıp ödemeyi kendi sitesinde de tutabilir. Bu meşru bir UCP yapılandırmasıdır ve çoğu zaman doğru ilk aşamadır.
Adım 4: Merchant Center’ı hazırlayın
Google’ın uygulama rehberi Merchant Center ile başlar: hesabın iyi durumda olması ve ürünlerin ücretsiz listelemeler için onaylanmış olması gerekir.
- İade politikası. İade maliyetini, iade süresini ve tam politikanın bağlantısını hesap düzeyinde ya da
returnsözelliğiyle ürün başına ayarlayın. Google bunu ödeme ekranında gösterir. - Müşteri desteği. En az bir iletişim yöntemi ekleyin: bir destek sayfası, bir e-posta adresi ya da bir telefon numarası. Sipariş onayındaki “Contact Merchant” bağlantısı buna dayanır.
- Ürünleri dahil edin. Her uygun ürün için
native_commerce(checkout_eligibility)değeriniTRUEolarak ayarlayın. Google, dahil etme işleminin ana feed’inizi bozmaması için bir ek veri kaynağı öneriyor. - Yasal bildirimler. Yasal bir sorumluluk reddi, bir güvenlik uyarısı ya da bir Proposition 65 uyarısı taşıyan ürünlerin, türü ve en fazla 1.000 karakterlik bir mesajı olan bir
consumer_noticealanına ihtiyacı vardır. - Eşleşen kimlikler. Feed’in
iddeğeri, ödeme sisteminizin beklediği ürün kimliğiyle eşleşmelidir. Farklı olduklarındamerchant_item_idgönderin.
Adım 5: Google’ın bekleme listesine katılın
Google, bir entegrasyonun AI Mode ve Gemini’de “yayına geçebilmeniz için önce Google tarafından onaylanması gerektiğini” söylüyor. Giriş yolu, Merchant Center Yardım’daki UCP entegrasyonu ilgi formudur ve bu form mağazanızı bekleme listesine alır. Kendi ödeme sayfanızın Google’ın arayüzü içinde çalıştığı gömülü ödeme, onaylanmış satıcılarla sınırlıdır. Formu geliştirme yaparken gönderin, çünkü onay kendi başınıza hızlandıramayacağınız adımdır.
Adım 6: Profili ve uç noktaları oluşturun
Bir mağaza ya ticaret platformuna yerleşik UCP desteğini kullanır ya da bu desteği kendisi oluşturur. Biz oluşturduğumuzda mağazanın önüne, ajanlarla UCP üzerinden, mağazayla da platformun kendi API’si üzerinden konuşan ince bir hizmet koyarız ve profil ile uç noktalar tek bir kaynağı (origin) paylaşsın diye bu hizmeti mağazanın alan adı altına yerleştiririz. UCP sık sık revize ediliyor ve onu platformun dışında tutmak, yeni bir sürümün bir platform sürümünü beklememesi anlamına geliyor.
- Yalnızca çalışanı yayımlayın. Profilinizde ödeme özelliğini bulan bir ajan onu kullanmaya çalışır. İlk sürüm yalnızca katalog arama ve sorgulamayı duyurabilir ve ödemeyi hazır olduğunda ekleyebilir.
- Gerçek imzalama anahtarları kullanın. Profildeki açık anahtarlar imzalı sipariş güncellemelerinizi doğrular, bu yüzden bir anahtar çifti oluşturun ve özel yarısını sunucuda tutun.
- Yeniden denemeleri güvenli hale getirin. Ödeme çağrılarında bir idempotency anahtarı kabul edin, böylece tekrarlanan bir istek iki kez ücret almaz.
- HTTPS üzerinden sunun. REST spesifikasyonu en az TLS 1.3 gerektirir.
- Adresleri doğrulayın. Teslim edilemeyen bir adresi kurtarılabilir bir hata olarak döndürün, böylece alışverişçi çıkmaza girmek yerine onu düzeltebilir.
- Politikalarınıza bağlantı verin. Koşullarınız her UCP satın alması için geçerlidir, bu yüzden ödeme yanıtına gizlilik, kullanım koşulları, para iadesi ve kargo politikalarınızın bağlantılarını ekleyin.
Adım 7: Ödemeleri bağlayın
Google’ın yerel ödeme yolunda profiliniz Google Pay ödeme işleyicisini bildirir. Kendi sitenizde Google Pay API’sine ihtiyacınız yoktur, ancak ödeme işlemciniz Google’ın ödeme token’larını kabul etmelidir ve büyük ödeme işlemcilerinin çoğu bunu yapar. Google’ın SSS’si, yapay zeka yüzeylerinin yalnızca PAN_ONLY yetkilendirme yöntemini kullandığını ve profildeki Google Pay ayarlarının snake_case adlar kullandığını belirtiyor. Test ve canlı ortam ödeme işlemcisi kimlik bilgilerini ayrı tutun ve bunları asla loglara yazmayın.
Adım 8: Google’ın test edeceği şekilde test edin
Google sağlık kontrollerini Google-UCP-Prober/1.0 kullanıcı aracısıyla gönderir ve ajan isteklerini bir UCP-Agent başlığı ve Google/UCP ile başlayan bir kullanıcı aracısıyla işaretler. Başvurmadan önce kendi uç noktalarınıza Google’ın yapacağı gibi istek gönderin.
/.well-known/ucpmağazanıza ulaşıyor mu? Bir web sunucusu kuralı, UCP uç noktalarınız çalışırken bile, istek uygulamaya hiç ulaşmadan o yolu kendi 404’üyle yanıtlayabilir.- Güvenlik duvarınız Google’ı içeri alıyor mu? Betikli trafiği engelleyen bot koruması prober’ı da engeller, bu yüzden Google’ın UCP isteklerini adrese göre değil başlıklarına göre geçirin.
- Korumalı uç noktalar doğru davranıyor mu? Ödeme (checkout), tahsilat ve sipariş uç noktaları kimlik bilgisi olmayan istekleri reddetmeli ve Google’ınkileri kabul etmelidir.
Adım 9: Bir sonraki UCP sürümünü planlayın
2026-08-25 spesifikasyonu, 2026-04-08’de bulunmayan standart iade ve garanti politikaları ekliyor ve Google 2026-04-08’i belgeliyor. Google’ın rehberleri daha yeni bir sürümü benimseyene kadar bu bilgiyi Merchant Center iade politikanız taşır. Yeni bir sürümü benimsediğinizde Google onu ayrı bir uç noktadan sunmanızı öneriyor, böylece bir şey bozulursa trafiği eskisine geri gönderebilir.
WISLR, markalar ve ajansların müşterileri için UCP kurar
Yukarıdaki her adım WISLR’ın Agentic Commerce Optimization hizmetinin bir parçasıdır. Kataloğu Google’ın gereksinimlerine göre denetler, ürün verilerini düzeltip tamamlar, Merchant Center’ı ve dahil etme feed’ini hazırlar, entegrasyon Google’ın onayına hazır olana kadar UCP profilini ve uç noktaları oluşturup test ederiz. Markalar bizimle doğrudan çalışır, ajanslar ise müşterileri için kurulumu yapmamız amacıyla bizimle kendi adları altında çalışır. UCP’yi nasıl kurduğumuzu görün ve kataloğunuz için bir değerlendirme talep edin.