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. Teklif 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, tutar indirimi 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 menüsünde 5 ABD doları indirim
• %10 indirim, premium abonelere% 5 indirim ve kullanıcı uygulamanız üzerinden ödeme yaparsa% 5 indirim ile birleştirilebilir.

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 şartlara uymayan tekliflerle ilgili ne yapmanız gerektiği hakkında talimat almak için teklif politikalarımızı inceleyin.

Uygulama teklifleri

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:

• Satıcı feed'i
• Teklif feed'i

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	boolean		Doğruysa bu teklif, toplayıcı altındaki tüm kuruluşlar için geçerlidir. Yalnızca ek teklifler 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 sağlanabilir. Zorunlu.
action_type	enum (ActionType)	Zorunlu	Teklifi sağlayan hizmet. Bir offer_id yalnızca bir action_type'a 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], burada 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 teklif 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 birleştirilip birleştirilemeyeceği ve hangi tür tekliflerle birleştirilebileceği) açıklar. Zorunludur.
coupon	object (Coupon)		Kuponun ayrıntıları. offer_category [teklif_kategorisi]: OFFER_CATEGORY_ADD_ON_COUPON_OFFER için zorunludur.
payment_instrument	object (PaymentInstrument)		Ödeme aracının 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. Başlangıç ve bitiş saatleri, haftanın günleri vb. dahil olmak üzere teklifin geçerli olduğu zaman aralığını 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.

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. 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	boolean		Rezervasyon maliyetinin ayarlanabilir olup olmadığı (ör. rezervasyon maliyeti, son faturadan çıkarılır). Örneğin: Rezervasyonla akşam yemeğinde% 30 indirim. Rezervasyon maliyeti 15 ABD dolarıdır ve nihai 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, kullanım vb.

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 bir 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: hizmet ücreti, işlem ücreti vb. Zorunludur.
fee	object (Fee)

Alan adı	Tür	Gereksinim	Açıklama
combinable_with_other_offers	boolean		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.

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	boolean		Teklifin yalnızca belirli kurslarda geçerli olup olmadığı

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	Zorunlu	Ödeme aracı sağlayıcısının adı. Banka iş ortağı, banka adı vb. olabilir. Örneğin: American Express, HDFC, ICICI. Zorunlu.

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	boolean		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şaretli 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üm ve koşullarının URL'si.
restricted_to_certain_users	boolean		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. Yani başlangıç zamanı 00:00 (günün başlangıcı) olmalı ve bitiş zamanı, geçerlilik süresinin 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. Ö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 ayar yapılmamış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 değerlerine ilişkin istisnaları belirtir.

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		1970-01-01T00:00:00Z Unix sıfır zamanından itibaren UTC zamanının saniyelerini gösterir. 0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z (ikisi de dahil) arasında olmalıdır.
nanos	sayı		Nanosaniye çözünürlüğünde, saniyenin negatif olmayan kesirleri. 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 (her iki değer de dahil) olmalıdır.

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ı.

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ş saatini gösteren bir zaman (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ı		Saat cinsinden dakika. 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
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ün 00:00 (hariç) olmalıdır.

Ad	Açıklama
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

Ad	Açıklama
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_DINING

Ad	Açıklama
OFFER_MODE_OTHER
OFFER_MODE_WALK_IN
OFFER_MODE_FREE_RESERVATION
OFFER_MODE_PAID_RESERVATION
OFFER_MODE_ONLINE_ORDER

Ad	Açıklama
OFFER_CATEGORY_UNSPECIFIED
OFFER_CATEGORY_BASE_OFFER
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
OFFER_CATEGORY_ADD_ON_COUPON_OFFER
OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER

Ad	Açıklama
FEE_UNIT_UNSPECIFIED
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

Ad	Açıklama
FEE_TYPE_UNSPECIFIED
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

Ad	Açıklama
MEAL_TYPE_UNSPECIFIED
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

Ad	Açıklama
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET

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

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 hariç tutulur.
amount_range	object (MoneyRange)	amount ile karşılıklı olarak hariç tutulur.

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 dosyalarınızda name değerini google.offer olarak ayarlayın.

Yükleme sıklığı

Genel olarak Google, günde 1 feed yüklemesi 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.

Fırsatları kategorilere ayırma

• OFFER_CATEGORY_BASE_OFFER: Diğer tekliflerle birleştirilmeden bağımsız olarak kullanılabilen teklifler. Bu kapsamda:
  • Faturanın tamamına uygulanan sabit indirimler (ör. %20 indirim)
  • Abonelik teklifleri (ör. Üyelikle ücretsiz tatlı)
  • Restoran için başka temel tekliflerin olmadığı durumlarda ödeme teklifleri
• 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 ek% 10 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)

Diğer hususlar:

• 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 teklif hem de ek teklif olarak işlev gördükleri senaryoları kapsamak için bu tekliflerin 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 olduğunda tüm Temel Teklifler OFFER_CATEGORY_BASE_OFFER olarak etiketlenmeli ve ödeme, abonelik veya kupon teklifleri olan Temel Teklifler, ilgili eklenti teklifi türü olarak ayrıca gönderilmelidir.
• ValidityPeriod, yalnızca etkin bir temel teklif olmadığında eklenti tekliflerini temel teklif olarak 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 mağaza teklifi 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 teklifinde, yalnızca hafta içi restoranın öğle yemeği saatlerinde geçerli olduğunu belirtmek için ValidityPeriod ayarlanmalıdır.
  • Kredi kartı teklifinde% 5 indirim, 2 kopya olarak gönderilmelidir.
    • Bir kopya, PaymentInstrument ayrıntıları eklenerek OFFER_CATEGORY_BASE_OFFER olarak etiketlenmelidir. Öğle yemeği teklifi% 10 indirim etkin olduğunda, hafta içi öğle yemeği saatlerini hariç tutmak için ValidityPeriod değeri hariç tut olarak ayarlanmalıdır.
    • Bir kopya, PaymentInstrument ayrıntılarıyla birlikte OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER olarak etiketlenmelidir.
  • 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 iş 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 (veya doğrudan üretim verilerinin) dışa aktarılmış bir sürümünü kullanmanız gerekir. Bu, geliştirme sürecinizde tüm uç durumların ele alınmasını sağlar ve Google'ın veri kalitesini değerlendirip 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üklemeyi tamamladığı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 kullanıma sunulur.

İzleme

Google, iyi bir kullanıcı deneyimi sağlamak için sunulan tekliflerin geçerli, doğru ve politika ölçütlerimizi karşıladığı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 olacaktır. Bu izlemenin sonucu, tekliflerin sıralamasını etkilemek için kullanılabilir.

Otomatik kontroller (tarayıcılar)

Google Kalite Ekibi, tarayıcıları uygular. Tarayıcılar, yalnızca kalite testi amacıyla bazı tıklamalar yapmak ve teklif bilgilerini ayıklamak için web tarayıcısını otomatikleştirilen 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 olarak 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 varılmasına neden olabilir) 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

Tarayıcılarımız, iş ortağı web sitesindeki yükü azaltmak amacıyla 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çerikleri (ör. JavaScript kitaplıkları) tekrar tekrar getirmediğ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.