Bu eğitimde şu konular açıklanmaktadır:
- Stok durumunun kullanıcıya nasıl gösterildiğine ve ne tür verilerin gerekli olduğuna dair üst düzey bir açıklama
- Stok durumu verilerini feed'lerinizdeki
action_linköğelerine kodlamayla ilgili özel talimatlar - Gün içinde değişirse bu müsaitlik durumunu güncellemeyle ilgili talimatlar
- Kullanılabilirlik doğruluğuyla ilgili beklentiler
Stok durumu meta verilerinin yanı sıra minimum sipariş tutarlarının yanı sıra teslimat veya teslim almayla ilişkili ücretler hakkında meta veri sağlamanız da beklenir. Stok Durumu, ücretler ve minimum siparişlerin kullanımını gösteren eksiksiz feed örneği için Perakende Sipariş v1 Feed Örneği bölümüne bakın.
Stok durumu bilgileri
Bu deneyim için Perakende Siparişi stok durumu, gün düzeyinde ayrıntı düzeyinde toplanır. Bu müsaitlik durumu verileri, kullanıcılara sunulan en erken tarihe göre ücretler ve minimum sipariş tutarıyla birlikte "Bugün kullanılabilir", "Yarın sunulacak" veya "GG/AA" şeklinde bir mesajla gösterilir.
Bu verileri feed'lere gönderirken kullanıcının sipariş verebileceği ve teslim alma veya teslimat işlemlerini her bir tarih için planlayabileceği en son tarihler ve stok durumu olan gelecekteki tarihler gönderirsiniz. Bu iki bilgi, sırasıyla sipariş karşılama tarihi ve son sipariş saatidir.
Örneğin, bugünün tarihi 23 Mart 2021 ise ve kullanıcı bugün saat 16:00'a kadar sipariş verdiği sürece yarın gün için teslimat yapılacaksa bu müsaitlik durumunu göstermek için sağlayacağınız veriler şunlardır:
- Sipariş karşılama tarihi: 24.03.2021
- Son sipariş zamanı: 23.03.2021 16:00
Son sipariş saati dahil edildiğinden, Google ön ucu son sipariş saati geçtikten sonra otomatik olarak bir sonraki uygun tarihe güncellenir.
Her gün yeni bir satıcı feed'i yüklenirken yeni stok durumu verileri eklenmelidir. Kullanıcı arabirimi yalnızca mevcut kullanılabilirliği gösterdiğinden, herhangi bir konum için yalnızca sonraki 3-5 kullanılabilirlik tarihini sağlamanız gerekir. Bu durum, kullanıcı arabiriminin mevcut stok durumunu göstermesine ve son sipariş süresi geçtikten sonra görüntülenecek bir sonraki stok durumuna sahip olmasına olanak tanır.
Feed'ler aracılığıyla stok durumunu belirtme
İşlem bağlantılarının kullanılabilirliği, order_online_metadata alanının parçası olarak action_link Merchant Center feed mesajına dahil edilir. Her satıcı ve sipariş karşılama seçeneği için yolda AvailableDay mesajlarının listesi bulunur
Merchant.action_link.order_online_metadata.fulfillment_option.available_day
Bu mesajlar aşağıdaki biçimde olmalıdır:
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
},
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
}
Bu biçimde fulfillment_date; stok durumu olan yıl, ay ve gündür. Bu tarih, satıcı tarafından belirtilen konumla ilgili olmalıdır.
last_ordering_time, saniye cinsinden unix zaman damgasıdır. Saat dilimi bağımsızdır ve satıcının fulfillment_date tarihinde sağlanan tarih için son sipariş alabileceğini belirtir. Son sipariş zamanı, sipariş karşılama tarihinden önce veya sipariş tarihi olabilir. Son sipariş zamanı geçtikten sonra Google, belirtilen sipariş karşılama tarihi için stok durumunu otomatik olarak göstermeyi durdurur ve bir sonraki uygun sipariş karşılama tarihine göre stok durumunu göstermeye başlar.
order_online_metadata referansı için Satıcı Feed Referansı'na bakın. JSON biçiminde stok durumu içeren bir feed örneği için Feed örnekleri Perakende Siparişi + Meta Veriler bölümüne bakın.
Gerçek zamanlı güncellemelerle kullanılabilirliği güncelleme
Bir konumun teslimat veya teslim alma özelliği için kullanılabilirliği, günlük feed gönderme zamanlarınız arasında değişiyorsa gerçek zamanlı güncelleme REST API'si, kullanıcılara gösterilen stok durumunu güncellemek için kullanılabilir.
Güncellemeler aynı anda tek bir satıcıda yapılır. Güncelleme yaparken, güncellenecek satıcıyı ve API uç noktasının bir parçası olarak güncellenmesi gereken alanları belirtirsiniz. Ardından, isteğin gövdelerine bu alanlar için yeni verileri dahil edin. Güncellenen alanlar, sağlanan bilgilerle değiştirilecek.
Stok durumunu güncellemek için aşağıdaki uç noktaya yama isteği göndereceksiniz:
PATCH https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}?updateMask=action_link
Ardından isteğin gövde metni, yalnızca action_link öğesini içeren bir Satıcı nesnesi olur (updateMask öğesini yalnızca action_link öğesini ayarlayacağımız için):
{
"action_link": [
..., // all required action_link fields here
"order_online_metadata": {
"fulfillment_option": [
"fulfillment_type": "FULFILLMENT_TYPE_DELIVERY",
"available_day": [ // Include the updated availability here
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
}
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
},
... // Other updated availability_days
]
]
}
]
}
API isteği başarılı olursa yanıt, yeni güncellenen verileri içeren Merchant nesnesini içerir.
Satıcı güncelleme yönteminin tam referans spesifikasyonu için Yöntem: inventory.partners.merchants.patch adresine bakın.
Kullanılabilirlik doğruluğu
Google ile Rezervasyon, kullanılabilirlik ayrıntılarının çeşitli faktörlere bağlı olarak değiştiğinin farkındadır. Bu faktörler aşağıdakileri içerir:
- Sipariş boyutuna göre stok durumu değişiklikleri
- Siparişin ve ödeme işleminin tamamlanmasına kalan süreye göre kullanılabilirlikte yapılan değişiklikler
- Stok durumu değişikliklerinin, feed'ler veya gerçek zamanlı güncellemeler aracılığıyla güncellenmesi arasındaki gecikme
Bu faktörlerden herhangi biri, başlangıçta kullanıcıya gösterilen müsaitlik durumunun ödeme sırasında göreceği nihai stok durumu olmadığı durumlara yol açabilir. Kullanılabilirlik uygulamasının amacı, bunları tümüyle ortadan kaldırmak değil, kullanıcılara olabildiğince sık açık bilgiler sunmaktır.
İş ortaklarından, mümkün olan en doğru şekilde kullanıcılara en doğru şekilde görüntülenebilirlik sağlayacak bir uygulama sağlamaları en iyi uygulama yöntemiyle beklenir. Ayrıca, sipariş ayrıntıları nedeniyle stok durumu değişirse bu durum kullanıcılara açıkça gösterilmelidir. Sizin için özel olarak nelerin gerekli olduğundan emin değilseniz Google ile Rezervasyon temsilcinizle iletişime geçin.