Entegrasyon Adımlarına Genel Bakış

Fırsat entegrasyonuna katılan iş ortakları, başlamadan önce satıcı veya tüzel kişiye (pilot) dayalı entegrasyon adımında hesap kurulumunu tamamlamalıdır. Fırsatlar entegrasyonunun uygulanması, test edilmesi ve kullanıma sunulması bu kılavuzda ayrıntılı olarak açıklanacaktır. Entegrasyon adımlarına geçmeden önce bu genel bakışı ve fırsat politikalarını okuyun.

Teklifler

Fırsatlar entegrasyonu, satıcı promosyonları ve belirli zamanlarda belirli hizmetlere uygulanan indirimler hakkında yapılandırılmış bilgiler aktarmanıza olanak tanır. Teklifler; gerçek teklif (yüzde indirim, belirli bir tutarda indirim vb.), geçerlilik süreleri (belirli zamanlar, haftanın belirli günleri vb.) ve geçerli kullanımların (teklif yalnızca belirli hizmetlerde kullanılabilir) yanı sıra karmaşık kısıtlama kombinasyonlarından oluşur.

Fırsat örnekleri:

• Aralık ayında çarşamba ve perşembe günleri 12:00-17:00 saatleri arasında başlangıç yemeklerinde %50 indirim
• Anneler Günü akşam yemeğinde 18:00-22:00 saatleri arasında bir tatlı alana bir tatlı bedava
• Her pazar 10:00-14:00 arasında brunch girişinde 5 ABD doları indirim
• %10 indirim, premium abonelere% 5 indirim ve kullanıcı uygulamanız üzerinden ödeme yaparsa% 5 indirim ile birleştirilebilen, mağazaya gelerek yapılan alışverişlere özel bir teklif.

Bir teklifin entegrasyona dahil edilebilmesi için teknik veri modeline uygun olması ve uygunluk koşullarımızı karşılaması gerekir. Entegrasyonunuzun uygun olduğundan emin olmak ve teknik koşullara uymayan tekliflerle ilgili ne yapmanız gerektiği hakkında talimat almak için fırsat politikalarımızı inceleyin.

Teklif uygulama

Fırsatlar entegrasyonu, günlük olarak veya yüksek doğruluk sağlayacak (yani eski verileri azaltacak) sıklıkta yüklenecek iki feed'den oluşur:

• Şunlardan biri:
  • Satıcı feed'i (Merchant yapılandırması kullanılarak)
  • Veya Varlık feed'i (Generic yapılandırması kullanılarak)
• Ve Fırsatlar feed'i (Generic yapılandırması kullanılarak)

Alan Adı	Tür	Gereksinim	Açıklama
data	nesne dizisi (Offer)

Alan Adı	Tür	Gereksinim	Açıklama
offer_id	dize	Zorunlu	Teklifin benzersiz kimliği. Zorunlu.
entity_ids	dize dizisi		Bu teklife katılan satıcıların listesi.
add_on_offer_applicable_to_all_entities	boole		Doğruysa bu teklif, toplayıcı altındaki tüm kuruluşlar için geçerlidir. Yalnızca eklenti teklifleri için geçerlidir.
offer_source	enum (OfferSource)	Zorunlu	Teklif, toplayıcı, bağımsız bir satıcı veya hatta üçüncü taraf tarafından eklenti olarak sunulabilir. Zorunlu.
action_type	enum (ActionType)	Zorunlu	Teklifi sağlayan hizmet. Bir offer_id yalnızca bir action_type değerine ait olabilir. Bir teklif birden fazla hizmet türünde paylaşılabiliyorsa her hizmet türü için benzersiz kimliklere sahip tekliflerin oluşturulması beklenir. Zorunlu.
offer_modes	enum dizisi (OfferMode)	Zorunlu	Tekliften yararlanma yöntemleri (mağazaya gitme, rezervasyon, online vb.) Zorunlu.
offer_category	enum (OfferCategory)	Zorunlu	Teklifin kategorisi. Zorunlu.
source_assigned_priority	sayı		Kaynağın teklife atadığı öncelik düzeyini gösteren, negatif olmayan tam sayı ([1-100], 1 en yüksek önceliği temsil eder). Aynı satıcı için birden fazla teklif olduğunda bu, tekliflerin sıralanması için bir sinyal olur. 0, önceliğin ayarlanmadığını gösterir.
offer_details	object (OfferDetails)	Zorunlu	İndirim, rezervasyon maliyeti gibi teklifin ayrıntıları. Zorunlu.
offer_restrictions	object (OfferRestrictions)	Zorunlu	Teklifin nasıl kısıtlandığını (ör.abonelik/ödeme aracı gerekip gerekmediği, bu teklifin diğer tekliflerle (ve hangi türlerle) birleştirilip birleştirilemeyeceği vb.) açıklar. Zorunludur.
coupon	object (Coupon)		Kupon ayrıntıları offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER için zorunludur.
payment_instrument	object (PaymentInstrument)		Ödeme aracı ayrıntıları offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER için zorunludur.
subscription	object (Subscription)		Abonelik ayrıntıları offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER için zorunludur.
terms	object (Terms)	Zorunlu	Teklifin hüküm ve koşulları Zorunlu.
validity_periods	nesne dizisi (ValidityPeriod)	Zorunlu	Teklifin geçerlilik süresi. Teklifin geçerli olduğu zaman aralığını (başlangıç ve bitiş saatleri, haftanın günleri vb.) açıklar. Zorunludur.
offer_url	dize		Satıcının teklif sayfasının URL'si. offer_category: OFFER_CATEGORY_BASE_OFFER için zorunludur.
image_url	dize		Satıcının teklif resminin URL'si.
tags	enum dizisi (OfferTag)		Teklifle ilişkili özel etiketler. Bu, "Festival", "En Çok Puan Alan", "En Çok Rezervasyon Yapılan" gibi özel teklifleri belirlemek için kullanılır.
brand_id	dize		Hediye kartı anlaşmalarında, anlaşmayı sunan markayı tanımlamak için gereklidir.
offer_provider	object (OfferProvider)		Teklifi sağlayan veya finanse eden tüzel kişi.
banner_image_url	dize		Banner resminin URL'si. Genellikle teklif başlığının yanında oluşturulan image_url'nin aksine, banner resmi mobil ekranların tam genişliğinde veya kart benzeri bir görünümde oluşturulur.
availability_level	enum (AvailabilityLevel)		Teklifin stok durumu düzeyi.

Alan Adı	Tür	Gereksinim	Açıklama
offer_display_text	dize	Zorunlu	Teklif sağlayıcının arama sonuçları sayfasında müşterilere göstermek istediği teklif metni. Bu açıklamanın, kullanıcılara gösterilen açıklamayla bire bir aynı olmayabileceğini ve yeniden yazmak/ifade etmek için başka meta veriler kullanabileceğimizi unutmayın. Zorunlu.
	oneOf (offer_specification)	Zorunlu	Bu oneOf'taki alanlardan yalnızca biri ayarlanabilir.
max_discount_value	object (Money)		Faydalanılabilecek maksimum indirim. Örneğin, 100 TL'ye kadar% 10 indirim.
min_spend_value	object (Money)		İndirimden yararlanmak için yapılması gereken minimum harcama tutarı. Örneğin, toplam fiyat 100 TL veya daha fazla olduğunda% 10 indirim.
booking_cost	object (Money)		Bu teklifi kullanmanın maliyeti. Örneğin, 15 ABD doları karşılığında masa rezerve edildiğinde son faturada 100 ABD doları indirim.
booking_cost_unit	enum (FeeUnit)		Rezervasyon maliyetinin birimi. Örneğin, kişi başına, işlem başına.
convenience_fee	object (Fee)
booking_cost_adjustable	boole		Rezervasyon maliyetinin ayarlanabilir olup olmadığı (ör. rezervasyon maliyeti, nihai faturadan çıkarılır). Örneğin: Rezervasyonla akşam yemeğinde% 30 indirim. Rezervasyon maliyeti 15 ABD dolarıdır ve bu tutar son faturaya yansıtılır. Dolayısıyla nihai fatura: Toplam Harcama - %30 - 15 ABD doları
additional_fees	nesne dizisi (AdditionalFee)		Kullanıcıdan alınan ek ücretler. Örnekler: kolaylık, sevkiyata hazırlık, teslimat, paketleme, hizmet ücreti vb.
offer_discount_type	enum (OfferDiscountType)		İndirim türü.
gift_card_info	object (GiftCardInfo)		Özellikle hediye kartı fırsatlarıyla ilgili ayrıntılar.

Alan Adı	Tür	Gereksinim	Açıklama
currency_code	dize		ISO 4217'de tanımlanan üç harfli para birimi kodu.
units	dize		Tutarın tam birimleri. Örneğin, currencyCode "USD" ise 1 birim 1 ABD dolarıdır.
nanos	sayı		Tutarın nano (10^-9) birim sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) olmalıdır. units pozitifse nanos pozitif veya sıfır olmalıdır. units sıfırsa nanos pozitif, sıfır veya negatif olabilir. units negatifse nanos negatif veya sıfır olmalıdır. Örneğin, -1,75 ABD doları units=-1 ve nanos=-750.000.000 olarak gösterilir.

Alan Adı	Tür	Gereksinim	Açıklama
unit	enum (FeeUnit)
type	enum (FeeType)
	oneOf (cost)		Bu oneOf'taki alanlardan yalnızca biri ayarlanabilir.

Alan Adı	Tür	Gereksinim	Açıklama
min_amount	object (Money)
max_amount	object (Money)

Alan Adı	Tür	Gereksinim	Açıklama
name	dize	Zorunlu	Ek ücretin adı. Örnekler: özel ödeme yöntemi ücreti, sevkiyata hazırlık ücreti vb. Zorunludur.
fee	object (Fee)

Alan Adı	Tür	Gereksinim	Açıklama
	oneOf (denomination_type)		Bu oneOf'taki alanlardan yalnızca biri ayarlanabilir.

Alan Adı	Tür	Gereksinim	Açıklama
amounts	nesne dizisi (Money)		Kullanılabilir tüm ayrı birimlerin listesi (ör. [100, 500, 1000]).

Alan Adı	Tür	Gereksinim	Açıklama
combinable_with_other_offers	boole		Bu teklifin diğer tekliflerle birleştirilip birleştirilemeyeceği. Doğru olduğunda iş ortakları, bu teklifin hangi tekliflerle birleştirilebileceğini belirtebilir. Hem combinable_offer_categories hem de combinable_offer_ids ayarlanırsa yukarıdaki koşullardan birini karşılayan tüm teklifler birleştirilebilir.
combinable_offer_categories	enum dizisi (OfferCategory)		Bu teklifin birleştirilebileceği teklif türlerinin listesi. Örneğin, bu teklif diğer kuponlarla birleştirilebilir. combinable_with_other_offers doğruysa ve bu alan ayarlanmamışsa tüm türler birleştirilebilir.
combinable_offer_ids	dize dizisi		Bu teklifin birleştirilebileceği offer_id'lerin listesi. Bazı teklifler yalnızca belirli diğer offer_id'lerle (üst teklifler olarak kabul edilebilir) birleştirilebilir. combinable_with_other_offers doğruysa ve bu alan ayarlanmamışsa tüm teklif kimlikleri birleştirilebilir.
inclusions	nesne dizisi (OfferCondition)		Teklifin geçerli olması için karşılanması gereken koşulların listesi (ör. alkolsüz içecekler, yiyecekler).
exclusions	nesne dizisi (OfferCondition)		Teklifi geçersiz kılacak koşulların listesi (ör. açık büfe, paket teklifler ve kokteyller).
min_guest	sayı		Tekliften yararlanmak için gereken minimum kişi sayısı.
food_offer_restrictions	object (FoodOfferRestrictions)		Yemek tekliflerine özgü kısıtlamalar.
max_redemption_count	dize		Bu teklifin kaç kez kullanılabileceğine ilişkin kısıtlamalar. 0 değeri, sınır olmadığını belirtir. Örneğin, 3 değeri, kullanıcının bu tekliften 3 kez yararlanabileceği anlamına gelir.
max_total_discount_value	object (Money)		Bu teklifin birden fazla işleminde kullanılabilecek maksimum indirim.
special_conditions	dize dizisi		Bu teklif için kullanıcıya gösterilmesi gereken özel koşullar. Örnekler: "Yalnızca [alan] içinde ödeme için geçerlidir", "İnternet ödemeleri hariçtir", "Hediye çeki, indirim döneminde KULLANILABİLİR."

Alan Adı	Tür	Gereksinim	Açıklama
description	dize

Alan Adı	Tür	Gereksinim	Açıklama
meal_types	enum dizisi (MealType)		Teklifin geçerli olduğu yemek türleri (ör. öğle veya akşam yemeği). Ayarlanmazsa teklif tüm yemek türlerine uygulanabilir.
restricted_to_certain_courses	boole		Teklifin yalnızca belirli kurslara uygulanıp uygulanamayacağı.

Alan Adı	Tür	Gereksinim	Açıklama
text	dize		Teklif sağlayıcının kullanıcılara göstermek istediği kupon metni.
code	dize	Zorunlu	Tekliften yararlanmak için kupon kodu gerekir. Zorunlu.

Alan Adı	Tür	Gereksinim	Açıklama
items	nesne dizisi (PaymentInstrumentItem)	Zorunlu	Teklifi kullanmak için kullanılabilecek ödeme araçlarının listesi. Zorunlu.
provider_name	dize		Ödeme aracı sağlayıcısının adı. Bankacılık iş ortağı, banka adı vb. olabilir. Örneğin: American Express, HDFC, ICICI.

Alan Adı	Tür	Gereksinim	Açıklama
type	enum (PaymentInstrumentType)	Zorunlu	Ödeme aracının türü. Zorunlu.
name	dize	Zorunlu	Ödeme aracı öğesinin adı (ör. kredi kartının adı). Örneğin: HDFC Infinia, American Express Platinum. Zorunlu.

Alan Adı	Tür	Gereksinim	Açıklama
name	dize	Zorunlu	Aboneliğin adı. Zorunlu.
subscription_auto_added	boole		Aboneliğin, kullanıcı bu tekliften yararlandığında otomatik olarak eklenip eklenmeyeceği
cost	object (Money)	Zorunlu	Aboneliğin maliyeti Zorunlu.
subscription_duration	object (Duration)	Zorunlu	Aboneliğin subscription_cost fiyatıyla geçerli olduğu süre. Zorunlu.
terms_and_conditions_url	dize		Bu abonelikle ilgili iş ortağının hükümler ve koşullarının URL'si.

Alan Adı	Tür	Gereksinim	Açıklama
seconds	dize		Zaman aralığının imzalı saniye değeri. -315.576.000.000 ile +315.576.000.000 arasında olmalıdır (bu değerler dahil). Not: Bu sınırlar şu şekilde hesaplanır: 60 sn/dk * 60 dk/saat * 24 saat/gün * 365,25 gün/yıl * 10.000 yıl
nanos	sayı		Zaman aralığının nanosaniye çözünürlüğünde, saniyenin imzalı kesirleri. Bir saniyeden kısa süreler, 0 seconds alanı ve pozitif veya negatif nanos alanı ile gösterilir. Bir saniye veya daha uzun süren durumlarda, nanos alanının sıfır olmayan değeri, seconds alanıyla aynı işarete sahip olmalıdır. -999.999.999 ile +999.999.999 arasında (bu değerler dahil) olmalıdır.

Alan Adı	Tür	Gereksinim	Açıklama
url	dize		İş ortağının hükümler ve koşulları URL'si.
restricted_to_certain_users	boole		Teklifin belirli kullanıcılarla sınırlı olup olmadığı.
terms_and_conditions	dize		İş ortağı tarafından sağlanan birincil H&K metni.
additional_terms_and_conditions	dize dizisi		İş ortağının birincil Hükümler ve Koşulları'na ek olarak geçerli olan hükümler ve koşullar.

Alan Adı	Tür	Gereksinim	Açıklama
valid_period	object (ValidityRange)		Teklifin geçerli olduğu başlangıç ve bitiş zaman damgası. Bu zamanlar farklı günleri temsil etmelidir. Örneğin, başlangıç zamanı 00:00 (günün başlangıcı) olmalı ve bitiş zamanı, geçerlilik döneminin sona erdiği gün 00:00 (hariç) olmalıdır.
time_of_day	nesne dizisi (TimeOfDayWindow)		Belirli bir günde geçerli olan zaman aralığını ve teklifin kullanılabileceği günleri belirtir. Gece yarısını geçen zaman aralıkları (ör. 22:00-02:00) için her gün ayrı pencereler kullanın: biri 23:59:59'da sona erer, diğeri ise sonraki gün 00:00'da başlar. Örneğin: Pazartesi: 10:00-17:00 Salı: 10:00-14:00 Salı: 17:00-19:00 Çarşamba, Perşembe, Cuma, Cumartesi, Pazar: 15:00-19:00 Hiçbir saat ayarlanmamışsa teklifin valid_period içinde her zaman kullanılabileceği anlamına gelir.
time_exceptions	nesne dizisi (ValidTimeException)		Yukarıdaki valid_period ve valid_time_of_week için istisnaları belirtir.
date_exceptions	nesne dizisi (Date)		Yukarıdaki valid_period ve time_of_day için gün cinsinden istisnaları belirtir.
validity_scope	enum (ValidityScope)		Geçerlilik döneminin kapsamını belirtir.
validity_duration_in_days	sayı		Satın alındıktan sonra kuponun geçerli olduğu süre (gün olarak).

Alan Adı	Tür	Gereksinim	Açıklama
valid_from_time	object (Timestamp)	Zorunlu	Aralığın başlangıç zamanı (dahil). Zorunlu.
valid_through_time	object (Timestamp)		Aralığın bitiş zamanı (hariç). Ayarlanmamışsa bu dönemin hiç bitmeyeceği anlamına gelir. İsteğe bağlı.

Alan Adı	Tür	Gereksinim	Açıklama
seconds	dize		Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir) olmalıdır.
nanos	sayı		Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, saniyelere alternatif olarak değil, sürenin nanosaniye kısmını belirtmek için kullanılır. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

Alan Adı	Tür	Gereksinim	Açıklama
time_windows	object (TimeOfDayRange)	Zorunlu	Siparişin verilebileceği/karşılanabileceği zaman aralığı. Zorunlu.
day_of_week	enum dizisi (DayOfWeek)		Pencerelerin uygulandığı haftanın günlerinin listesi. Hiçbiri ayarlanmamışsa haftanın tüm günleri için geçerli olduğu anlamına gelir. İsteğe bağlı.
day_of_month	nesne dizisi (DayOfMonthRange)		Pencerelerin uygulandığı ayın günleri. Hiçbiri ayarlanmamışsa ayın tüm günleri için geçerli olduğu anlamına gelir. İsteğe bağlı.

Alan Adı	Tür	Gereksinim	Açıklama
open_time	object (TimeOfDay)		Aralığın gününün başlangıç zamanını gösteren bir saat (girilen tarihler dahil). Ayarlanmazsa 00:00:00 olduğu anlamına gelir. İsteğe bağlı.
close_time	object (TimeOfDay)		Aralığın gününün bitiş zamanını gösteren saat (hariç). Ayarlanmazsa 23:59:59 anlamına gelir. İsteğe bağlı.

Alan Adı	Tür	Gereksinim	Açıklama
hours	sayı		24 saatlik biçimde günün saatleri. 0'dan büyük veya 0'a eşit olmalı ve genellikle 23'ten küçük veya 23'e eşit olmalıdır. Bir API, işletmenin kapanış saati gibi senaryolarda "24:00:00" değerine izin vermeyi seçebilir.
minutes	sayı		Saatin dakikası. 0'dan büyük veya 0'a eşit ve 59'dan küçük veya 59'a eşit olmalıdır.
seconds	sayı		Bir dakikanın saniyeleri. 0'dan büyük veya 0'a eşit olmalı ve genellikle 59'dan küçük veya 59'a eşit olmalıdır. Bir API, artık saniyelere izin veriyorsa 60 değerine izin verebilir.
nanos	sayı		Saniyenin nanosaniye cinsinden kesirleri. 0'dan büyük veya 0'a eşit ve 999.999.999'dan küçük veya 999.999.999'a eşit olmalıdır.

Alan Adı	Tür	Gereksinim	Açıklama
valid_from_day	sayı	Zorunlu	Aralığın başlangıç günü (dahil). Zorunlu.
valid_through_day	sayı		Aralığın bitiş günü (dahil). Ayarlanmazsa bu aralığın tek bir günü (valid_from_day) temsil ettiği anlamına gelir. İsteğe bağlı.

Alan Adı	Tür	Gereksinim	Açıklama
exceptional_period	object (ValidityRange)		Teklifin geçerli olmadığı başlangıç ve bitiş zaman damgası. Bu zamanlar farklı günleri temsil etmelidir. Yani başlangıç zamanı 00:00 (günün başlangıcı) olmalı ve bitiş zamanı, istisna döneminin sona erdiği günde 00:00 (hariç) olmalıdır.

Alan Adı	Tür	Gereksinim	Açıklama
year	sayı		Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır.
month	sayı		Yılın ayı. 1 ile 12 arasında olmalı veya ay ve gün içermeyen bir yılı belirtmek için 0 olmalıdır.
day	sayı		Ayın günü. Yıl ve ay için 1-31 arasında geçerli bir değer olmalı veya günü belirtmek için 0 olmalıdır.

Ad	Açıklama
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

Ad	Açıklama
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY	Teklif, yemek teslimatı hizmetleri için geçerlidir.
ACTION_TYPE_FOOD_TAKEOUT	Teklif, paket servis veya teslim alma yemek siparişlerinde geçerlidir.
ACTION_TYPE_DINING	Teklif, restoranda yemek yemek için geçerlidir.
ACTION_TYPE_SHOPPING_IN_STORE	Teklif, mağazadan yapılan çevrimdışı alışverişlerde geçerlidir.

Ad	Açıklama
OFFER_MODE_OTHER	Diğer belirli modların kapsamadığı karşılama yöntemleri için kullanılır.
OFFER_MODE_WALK_IN	Teklif, önceden rezervasyon yapılmadan yerinde ziyaretler için geçerlidir.
OFFER_MODE_FREE_RESERVATION	Teklif, kullanıcının ön ödeme gerektirmeyen bir rezervasyon yapması durumunda geçerlidir.
OFFER_MODE_PAID_RESERVATION	Teklif, kullanıcının ön ödeme gerektiren bir rezervasyon yapması durumunda geçerlidir.
OFFER_MODE_ONLINE_ORDER	Teklif, web sitesi veya dijital platform üzerinden verilen siparişlerde geçerlidir.
OFFER_MODE_GIFT_CARD_PURCHASE	Fırsattan yararlanmak için hediye kartı satın almanın birincil adım olduğunu gösterir.

Ad	Açıklama
OFFER_CATEGORY_UNSPECIFIED	UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
OFFER_CATEGORY_BASE_OFFER
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
OFFER_CATEGORY_ADD_ON_COUPON_OFFER
OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER
OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER

Ad	Açıklama
FEE_UNIT_UNSPECIFIED	UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

Ad	Açıklama
FEE_TYPE_UNSPECIFIED	UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

Ad	Açıklama
OFFER_DISCOUNT_TYPE_UNSPECIFIED
OFFER_DISCOUNT_TYPE_INSTANT_DISCOUNT
OFFER_DISCOUNT_TYPE_CASHBACK
OFFER_DISCOUNT_TYPE_REWARD_POINT

Ad	Açıklama
MEAL_TYPE_UNSPECIFIED	UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

Ad	Açıklama
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED	UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

Ad	Açıklama
DAY_OF_WEEK_UNSPECIFIED	Haftanın günü belirtilmemiş.
MONDAY	Pazartesi
TUESDAY	Salı
WEDNESDAY	Çarşamba
THURSDAY	Perşembe
FRIDAY	Cuma
SATURDAY	Cumartesi
SUNDAY	Pazar

Ad	Açıklama
VALIDITY_SCOPE_UNSPECIFIED
VALIDITY_SCOPE_CLAIM
VALIDITY_SCOPE_REDEEM

Ad	Açıklama
OFFER_TAG_UNSPECIFIED	UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

Ad	Açıklama
AVAILABILITY_LEVEL_UNSPECIFIED
AVAILABILITY_LEVEL_LOW	Teklifin kullanılabilirliğinin azaldığını gösterir. Kullanıcıların, stok tükenmeden önce bu kodu kullanmaları önerilir. MEDIUM ve HIGH seçeneklerini daha sonra ekleyebiliriz.

Alan Adı	Tür	Gereksinim	Açıklama
discount_percent	sayı	discount_value, other_offer_detail_text ile karşılıklı olarak hariç tutulur.	Faturanın indirimli yüzdesi. [0, 100] Yemeğin tamamında geçerli olan 1+1 veya% 50 indirim teklifleri için (ör. açık büfe 1+1, tüm hesapta 1+1, set menüde 1+1) bu değer 50 olarak ayarlanabilir.
discount_value	object (Money)	discount_percent, other_offer_detail_text ile karşılıklı olarak hariç tutulur.	İndirimin sabit değeri.
other_offer_detail_text	dize	discount_percent, discount_value ile karşılıklı olarak hariç tutulur.	İndirimi açıklayan serbest biçimli metin. Belirli 1+1 teklifleri (ör. 1+1 içecek, +1 ana yemek, 1+1 seçili menü öğeleri) için bu ayrıntılar burada açıklanmalıdır.

Alan Adı	Tür	Gereksinim	Açıklama
amount	object (Money)	amount_range ile karşılıklı olarak birbirini dışlar.
amount_range	object (MoneyRange)	amount ile karşılıklı olarak birbirini dışlar.

Alan Adı	Tür	Gereksinim	Açıklama
fixed_denominations	object (FixedDenominations)	custom_range ile karşılıklı olarak birbirini dışlar.	Hediye kartı belirli sabit tutarlarda sunulduğunda kullanılır.
custom_range	object (MoneyRange)	fixed_denominations ile karşılıklı olarak birbirini dışlar.	Markanın, kullanıcıların tanımlı bir aralıkta özel (esnek) bir nominal değer seçmesine izin verdiği durumlarda kullanılır.

Feed yükleme

Fırsatlar feed'i, Generic feed'i SFTP sunucusuna yüklenmelidir. Talimatlar için Genel feed SFTP sunucusunu kullanma eğitimini inceleyin ve açıklama dosyanızda name değerini google.offer olarak ayarlayın.

Yükleme sıklığı

Genel olarak Google, günde 1 feed yüklemesi yapılmasını bekler. Sürekli olarak yüksek bir hassasiyet sağlamak için, teklif güncellemelerinin sıklığına bağlı olarak sıklık artırılabilir veya azaltılabilir. Google İOOY'nize danışın.

Verilerin Google'da görünmesi birkaç saat sürer.

Teklifleri kategorilere ayırma

• OFFER_CATEGORY_BASE_OFFER: Diğer tekliflerle birleştirilmeden bağımsız olarak kullanılabilen teklifler. Bu kanallar aşağıdakileri kapsar:
  • Tüm faturada sabit indirimler (ör. %20 indirim)
  • Abonelik teklifleri (ör. üyelikle ücretsiz tatlı)
  • Restoran için başka temel tekliflerin olmadığı durumlarda ödeme teklifleri
  • Not: Platform genelinde ücret muafiyeti veya ücret indirimi teklifleri temel teklif olarak ayarlanmamalıdır.
• Eklenti Teklifleri: Kullanılabilmesi için temel teklifin talep edilmesi gereken teklifler. Bunlar arasında:
  • OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER (ör. belirli bir kredi kartıyla% 10 ek indirim)
  • OFFER_CATEGORY_ADD_ON_COUPON_OFFER (ör. belirli bir kupon koduyla ücretsiz içecek)
  • OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER (ör. abonelere ek% 10 indirim)
  • OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER (ör. ücretsiz teslimat veya indirimli ücret)

Dikkat edilmesi gereken diğer noktalar:

• Platform genelinde ücret muafiyeti veya indirim teklifleri temel teklif (OFFER_CATEGORY_BASE_OFFER) olarak ayarlanmamalıdır. Yalnızca başka bir etkin temel teklifi tamamlamak için OFFER_CATEGORY_ADD_ON_FEE_REDUCTION_OFFER olarak ayarlanmalıdır.
• Bir restoranda temel teklif ayarlanmamışsa ek teklifler gösterilmez. Temel Teklif yoksa başka bir teklife eklenmesi gerekmeksizin kullanılabilen tüm Ödeme, Abonelik veya Kupon Teklifleri OFFER_CATEGORY_BASE_OFFER olarak etiketlenmelidir.
  • Türe bağlı olarak, PaymentInstrument, Subscription veya Coupon için ilgili veriler ayarlanmalıdır.
  • İş ortakları, hem Temel Fırsat hem de Ek Fırsat olarak işlev gördükleri senaryoları kapsayacak şekilde bu fırsatların her birinden 2 kopya sağlamalıdır. Eklenti teklifi kopyası, entity_ids veya add_on_offer_applicable_to_all_entities kullanılarak birden fazla restoran için ayarlanabilir.
• Bir restoranın, birleştirilebilen birden fazla Temel Teklifi varsa tüm Temel Teklifler OFFER_CATEGORY_BASE_OFFER olarak etiketlenmeli ve Ödeme, Abonelik veya Kupon teklifleri olan Temel Teklifler ek olarak ilgili Eklenti Teklifi türü olarak gönderilmelidir.
• ValidityPeriod yalnızca etkin bir Base Offer olmadığında Base Offer olarak eklenti tekliflerini etkinleştirmek için kullanılmalıdır.

Örnek senaryolar:

• Bir restoran, belirli bir kredi kartıyla ödeme yapıldığında% 5 indirim ve belirli bir kupon koduyla ücretsiz içecek sunuyor.

  • %5 indirimli kredi kartı teklifi, 2 kopya olarak gönderilmelidir. Kopyalardan biri OFFER_CATEGORY_BASE_OFFER, diğeri ise PaymentInstrument ayrıntılarıyla birlikte OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER olarak etiketlenmelidir.
  • Kupon kodu teklifiyle ücretsiz içecek promosyonu, Coupon ayrıntılarıyla birlikte OFFER_CATEGORY_ADD_ON_COUPON_OFFER olarak gönderilmelidir.

• Bir restoran, hem kapıdan gelen müşterilere% 10 indirim hem de belirli bir kredi kartıyla ödeme yapıldığında% 5 indirim sunuyor. Bu iki indirim birleştirilebilir.

  • %10 indirimli teklif, OFFER_CATEGORY_BASE_OFFER olarak etiketlenmelidir.
  • %5 indirimli kredi kartı teklifinin 2 kopyası olmalıdır. Kopyalardan biri OFFER_CATEGORY_BASE_OFFER, diğeri ise OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER olarak etiketlenmelidir.

• Bir restoran, hafta içi yalnızca öğle yemeğinde% 10, belirli bir kredi kartıyla ödeme yapıldığında ise her zaman% 5 indirim sunuyor.

  • %10 indirim teklifi, hafta içi yalnızca restoranın öğle yemeği saatlerinde geçerli olduğunu belirtecek şekilde ValidityPeriod ayarlanmalıdır.
  • %5 indirimli kredi kartı teklifi 2 kopya olarak gönderilmelidir.
    • Bir kopya, PaymentInstrument ayrıntıları eklenerek OFFER_CATEGORY_BASE_OFFER olarak etiketlenmelidir. Bu metnin ValidityPeriod kısmı, öğle yemeğinde% 10 indirim teklifi etkin olduğunda hafta içi öğle yemeği saatlerini hariç tutacak şekilde ayarlanmalıdır.
    • Bir kopya, OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER olarak etiketlenmeli ve PaymentInstrument ayrıntıları eklenmelidir.
  • Bu restoranla ilgili diğer tüm ödeme teklifleri OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER olarak etiketlenmelidir.

Geliştirme ve kullanıma sunma süreci

Entegrasyonunuz boyunca İş Ortağı Portalı, geliştirme sürecinize göre bilgi ve geri bildirimlerle size yardımcı olabilir. Geliştirme süreci şu akışı izleyecektir:

• Entegrasyon ilk olarak Sandbox ortamında geliştirilir. Google Sandbox ortamında üretim verilerinin (hatta doğrudan üretim verilerinin) dışa aktarılmış bir sürümünü kullanmanız gerekir. Bu, geliştirme sürecinizin tüm uç durumları yakalamasına yardımcı olur ve Google'ın veri kalitesini değerlendirmesine ve veri modelinize göre size daha iyi yardımcı olmasına olanak tanır.
• Google Sandbox ortamına Merchant, Services ve Deals feed'ini eksiksiz ve günlük olarak yüklemeye başladığınızda Google Ekibi feed'lerinizi değerlendirir. Google ekibi onay verdikten sonra kodunuzu üretime gönderebilir ve Google üretim ortamına üretim verileri göndermeye başlayabilirsiniz.
• Üretim entegrasyonunu tamamen test ettikten sonra Google ekibi de test eder. Tüm testler tamamlandıktan sonra entegrasyonunuz başlatılır.

İzleme

Google, iyi bir kullanıcı deneyimi sağlamak için sunulan tekliflerin geçerli, doğru ve politika ölçütlerimize uygun olup olmadığını lansman öncesinde ve sonrasında kontrol eder. Google, bu işlemi gerçekleştirmek için hem uzman incelemesinden hem de otomatik incelemeden yararlanır. Bu incelemelerin sonucu, İşlem Merkezi'nin Fırsat Kontrol Paneli'nde (yalnızca üretim) erişilebilir. Bu izlemenin sonucu, tekliflerin sıralamasını etkilemek için kullanılabilir.

Sayfanın, tekliflerle birlikte tamamen yüklenmesinin 5 saniyeden kısa sürdüğünden emin olun. Aksi takdirde bu durum başarısızlık olarak kabul edilir ve Bad link olarak işaretlenir.

Otomatik kontroller (tarayıcılar)

Google Kalite Ekibi, tarayıcıları uygular. Tarayıcılar, yalnızca kalite testi amacıyla bazı tıklamaları gerçekleştirmek ve teklif bilgilerini ayıklamak için web tarayıcısını otomatikleştirme komut dosyalarıdır.

Sorgu sayısı

Örneğin, günde 5.000 kontrol göndermeye karar verirsek bu, günde 5.000 kez (gün boyunca eşit sıklıkta dağıtılır, yani yaklaşık olarak her 17 saniyede bir) tarayıcımızın normal bir kullanıcının yapacağı tüm işlemleri yapacağı anlamına gelir:

• Google Arama'dan başlayın ve iş ortağı bağlantısını tıklayın.
• Teklif bilgilerini bulun.
• Teklif için rezervasyon yapılması gerekiyorsa belirtilen zamanda teklifin kullanılabilir olduğunu onaylamak üzere rezervasyon akışına devam edilir (rezervasyon yapılmaz).

Web kazıyıcı algılama

Web kazıyıcının yasaklanmaması (bu durum, tekliflerin kullanılamadığı sonucuna yol açabilir) için sisteminizin, web kazıyıcımızın sayfanızı her zaman sorgulamasına izin verdiğinden emin olun. Web kazıyıcımızı tanımlamak için:

• Web kazıyıcı kullanıcı aracısı, "Google-Offers" dizesini içerir:
  • Örnek: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko; Google-Offers) Chrome/104.0.5112.101 Safari/537.36
• Ayrıca, "Googlebot'u ve diğer Google tarayıcılarını doğrulama" başlıklı makalede önerildiği gibi ters DNS kullanarak çağrıların Google'dan gelip gelmediğini de kontrol edebilirsiniz. Özel durumumuzda, ters DNS çözümlemesi şu kalıbı izler: google-proxy-***-***-***-***.google.com.

Teknik davranış

Önbelleğe alma

İş ortağı web sitesindeki yükü azaltmak amacıyla, tarayıcılarımız genellikle yanıtta bulunan tüm standart HTTP önbelleğe alma üstbilgilerine uyacak şekilde yapılandırılır. Bu, doğru şekilde yapılandırılmış web sitelerinde nadiren değişen içeriklerin (ör. JavaScript kitaplıkları) tekrar tekrar getirilmesini önlediğimiz anlamına gelir. Önbelleğe almanın nasıl uygulanacağı hakkında daha fazla bilgi için HTTP önbelleğe alma dokümanlarını okuyun.