Package madden.ingestion.offer

Dizin

ActionType

[START action_type_definition] Teklifin yerine getirme modunu gösterir. Bir teklif birden fazla karşılama modunda paylaşılıyorsa her karşılama modu için tekliflerin yinelenmesi beklenir.

Sıralamalar
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY Teklif, yemek teslimat hizmetleri için geçerlidir.
ACTION_TYPE_FOOD_TAKEOUT Teklif, paket servis veya gel-al siparişleri için geçerlidir.
ACTION_TYPE_DINING Fırsat, restoranda yemek yemek için geçerlidir.
ACTION_TYPE_SHOPPING_IN_STORE Teklif, çevrimdışı ve mağaza içi alışverişlerde geçerlidir.

AdditionalFee

[START additional_fee_definition]

Alanlar
name

string

Ek ücretin adı. Örnekler: özel ödeme yöntemi ücreti, sevkiyata hazırlık ücreti vb. Zorunludur.
fee

Fee

Kupon

[START coupon_definition]

Alanlar
text

string

Teklif sağlayıcının kullanıcılara göstermek istediği kupon metni.
code

string

Tekliften yararlanmak için kupon kodu gerekir. Zorunlu.

Ücret

[START fee_definition] Sonraki kimlik: 5

Alanlar
unit

FeeUnit
type

FeeType

cost birleşik alanı.

cost aşağıdakilerden yalnızca biri olabilir:
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

Sıralamalar
FEE_TYPE_UNSPECIFIED UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Sıralamalar
FEE_UNIT_UNSPECIFIED UNSPECIFIED veya varsayılan enum değeri feed'lerde kullanılmamalıdır.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

Alanlar
amounts[]

Money

Mevcut tüm ayrı değerlerin listesi (ör. [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

Alanlar
meal_types[]

MealType

Teklifin uygulanabileceği öğün türleri (ör. öğle veya akşam yemeği). Ayarlanmazsa teklif tüm öğün türlerine uygulanabilir.
restricted_to_certain_courses

bool

Teklifin yalnızca belirli kurslara uygulanıp uygulanamayacağı.

GiftCardInfo

[START gift_card_info_definition]

Alanlar

denomination_type birleşik alanı.

denomination_type aşağıdakilerden yalnızca biri olabilir:
fixed_denominations

FixedDenominations

Hediye kartı belirli, sabit tutarlarda kullanılabildiğinde kullanılır.
custom_range

MoneyRange

Marka, kullanıcıların tanımlı bir aralıkta özel (esnek) bir nominal değer seçmesine izin verdiğinde kullanılır.

MealType

[START meal_type_definition]

Sıralamalar
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

MoneyRange

[START money_range_definition]

Alanlar
min_amount

Money
max_amount

Money

Teklif

LINT.IfChange(offer_definition) [START offer_definition] Next tag: 26

Alanlar
offer_id

string

Teklifin benzersiz kimliği. Zorunlu.
entity_ids[]

string

Bu teklife katılan satıcıların listesi.
add_on_offer_applicable_to_all_entities

bool

Bu değer doğruysa teklif, toplayıcı kapsamındaki tüm tüzel kişiler için geçerlidir. Yalnızca eklenti teklifleri için geçerlidir.
offer_source

OfferSource

Teklifler; toplayıcı, bağımsız bir satıcı veya hatta üçüncü taraf tarafından eklenti olarak sunulabilir. Zorunlu.
action_type

ActionType

Teklifi sunan 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 yinelenen teklifler oluşturulması beklenir. Zorunlu.
offer_modes[]

OfferMode

Tekliften yararlanma yöntemleri (ör. randevusuz hizmet, rezervasyon, online). Zorunludur.
offer_category

OfferCategory

Teklifin kategorisi. Zorunlu.
source_assigned_priority

int32

Kaynak tarafından atanan teklifin ö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 varsa bu, teklifleri sıralamak için bir sinyal olur. 0, önceliğin ayarlanmadığını gösterir.
offer_details

OfferDetails

İndirim, rezervasyon maliyeti gibi teklif ayrıntıları. Zorunlu.
offer_restrictions

OfferRestrictions

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

Coupon

Kupon ayrıntıları. offer_category için zorunlu: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.
payment_instrument

PaymentInstrument

Ödeme aracının ayrıntıları. offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER için gereklidir.
subscription

Subscription

Abonelik ayrıntıları offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER için gereklidir.
terms

Terms

Teklifin hüküm ve koşulları. Zorunlu.
validity_periods[]

ValidityPeriod

Teklifin geçerlilik dönemi. Teklifin geçerli olduğu dönemi (başlangıç ve bitiş zamanları, haftanın günleri vb.) açıklar. Zorunludur.
offer_url

string

Satıcının teklif sayfasının URL'si. offer_category: OFFER_CATEGORY_BASE_OFFER için gereklidir.
image_url

string

Satıcının teklif resminin URL'si.
tags[]

OfferTag

Teklifle ilişkili özel etiketler. Bu, "Festival", "En Yüksek Puanlı", "En Çok Rezervasyon Yapılan" gibi özel teklifleri tanımlamak için kullanılır.
brand_id

string

Teklifle ilişkili markayı tanımlar. Ayarlanmazsa varsayılan marka kullanılır.

OfferCategory

[START offer_category_definition] Teklifin kategorisi. Temel teklif, tüm müşterilere sunulan standart bir tekliftir (ör. 100 TL üzeri harcamalarda% 10 indirim). Kupon veya ödeme aracıyla sınırlanan temel tekliflerde ilgili alanlar ayarlanır. ADD_ON_PAYMENT_OFFER gibi ek ürün tekliflerimiz de vardır. Bu tür teklifler, ek indirimler kazanmak için diğer tekliflere eklenebilir.

Sıralamalar
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

OfferCondition

[START offer_condition_definition]

Alanlar
description

string

OfferDetails

[START offer_details_definition] Sonraki etiket: 15

Alanlar
offer_display_text

string

Teklif sağlayıcının arama sonuçları sayfasında müşterilere göstermek istediği teklif metni. Zorunlu.
max_discount_value

Money

Faydalanılabilecek maksimum indirim. Örneğin, 100 TL'ye kadar% 10 indirim.
min_spend_value

Money

İndirimden yararlanmak için yapılması gereken minimum harcama tutarı. Örneğin, toplam fiyat 100 ABD doları veya daha fazla olduğunda% 10 indirim.
booking_cost

Money

Bu teklifi kullanmanın maliyeti. Örneğin, 15 ABD doları karşılığında masa rezerve edildiğinde nihai faturada 100 ABD doları indirim.
booking_cost_unit

FeeUnit

Rezervasyon maliyetinin birimi. Örneğin, kişi başına, işlem başına.
convenience_fee

Fee
booking_cost_adjustable

bool

Rezervasyon maliyetinin ayarlanabilir olup olmadığı (ör. rezervasyon maliyetinin nihai faturadan düşülmesi). Örneğin: Rezervasyonla akşam yemeğinde% 30 indirim. Rezervasyon ücreti 15 ABD dolarıdır ve nihai faturaya uygulanır. Dolayısıyla nihai fatura: Toplam Harcama - %30 - 15 ABD doları
additional_fees[]

AdditionalFee

Kullanıcıdan alınan ek ücretler. Örnekler: kolaylık, sevkiyata hazırlık, teslimat, paketleme, hizmet ücreti vb.
gift_card_info

GiftCardInfo

Hediye kartı fırsatlarına özel ayrıntılar.
offer_specification birleşik alanı. İndirim, toplam değerden çıkarılan bir yüzde veya sabit bir değer olabilir. Örneğin: 1. Nihai faturada% 10 indirim. 2. Siparişte 15 ABD doları indirim. Satıcılar, ilgili spesifikasyon alanları aracılığıyla "bir alana bir bedava" gibi özel indirimler de sunabilir. Zorunlu. offer_specification aşağıdakilerden yalnızca biri olabilir:
discount_percent

float

Faturanın indirim uygulanan yüzdesi. [0, 100] Tüm yemek için geçerli olan 1+1 veya% 50 indirim teklifleri (ör. 1+1 açık büfe, tüm faturada 1+1, set menüde 1+1) için bu değer 50 olarak ayarlanabilir.
discount_value

Money

İndirimin sabit değeri.
other_offer_detail_text

string

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

OfferMode

[START offer_mode_definition] Kullanıcının tekliften yararlanabileceği yöntemi veya kanalı belirtir.

Sıralamalar
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 yapmadan yerinde ziyaretler için geçerlidir.
OFFER_MODE_FREE_RESERVATION Teklif, kullanıcı ön ödeme gerektirmeyen bir rezervasyon yaptığında geçerli olur.
OFFER_MODE_PAID_RESERVATION Teklif, kullanıcı ön ödeme gerektiren bir rezervasyon yaptığında geçerli olur.
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 temel adım olduğunu gösterir.

OfferRestrictions

[START offer_restrictions_definition] Next tag: 11

Alanlar
combinable_with_other_offers

bool

Bu teklifin diğer tekliflerle birleştirilip birleştirilemeyeceği. Bu değer 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 birine uyan tüm teklifler birleştirilebilir.
combinable_offer_categories[]

OfferCategory

Bu teklifin birleştirilebileceği teklif türlerinin listesi. Örneğin, bu teklif diğer kuponlarla birleştirilebilir. combinable_with_other_offers doğru değerine ayarlanırsa ve bu alan ayarlanmazsa tüm türler birleştirilebilir.
combinable_offer_ids[]

string

Bu teklifin birleştirilebileceği teklif numaralarının listesi. Bazı teklifler yalnızca belirli diğer offer_id'lerle (üst teklifler olarak kabul edilebilir) birleştirilebilir. combinable_with_other_offers özelliği doğru değerine ayarlanmışsa ve bu alan ayarlanmamışsa tüm teklif numaraları birleştirilebilir.
inclusions[]

OfferCondition

Teklifin geçerli olması için karşılanması gereken koşulların listesi (ör. alkolsüz içecekler, yiyecekler).
exclusions[]

OfferCondition

Teklifi geçersiz kılacak koşulların listesi (ör. açık büfe, karma teklifler ve kokteyller).
min_guest

int32

Tekliften yararlanmak için gereken minimum kişi sayısı.
food_offer_restrictions

FoodOfferRestrictions

Yemek tekliflerine özgü kısıtlamalar.
special_conditions[]

string

Bu teklifle ilgili olarak kullanıcıya gösterilmesi gereken özel koşullar. Örnekler: "Yalnızca [bölge] içinde ödeme için geçerlidir", "Online ödemeler hariçtir"

OfferSource

[START offer_source_definition]

Sıralamalar
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

Sıralamalar
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

PaymentInstrument

[START payment_instrument_definition]

Alanlar
items[]

PaymentInstrumentItem

Tekliften yararlanmak için kullanılabilecek ödeme araçlarının listesi. Zorunlu.
provider_name

string

Ödeme aracı sağlayıcısının adı. Bankacılık iş ortağı, banka adı vb. olabilir. Örneğin: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

Alanlar
type

PaymentInstrumentType

Ödeme aracının türü. Zorunlu.
name

string

Ödeme aracı öğesinin adı (ör. kredi kartının adı). Örneğin: HDFC Infinia, American Express Platinum. Zorunlu.

PaymentInstrumentType

[START payment_instrument_type_definition]

Sıralamalar
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

Abonelik

[START subscription_definition]

Alanlar
name

string

Aboneliğin adı. Zorunlu.
subscription_auto_added

bool

Kullanıcı bu tekliften yararlandığında aboneliğin otomatik olarak eklenip eklenmediği
cost

Money

Aboneliğin maliyeti Zorunlu.
subscription_duration

Duration

Aboneliğin subscription_cost karşılığında geçerli olduğu süre. Zorunlu.
terms_and_conditions_url

string

İş ortağının bu abonelikle ilgili hükümler ve koşullarının URL'si.

Şartlar

[START terms_definition]

Alanlar
url

string

İş ortağının hükümler ve koşullarının URL'si.
restricted_to_certain_users

bool

Teklifin belirli kullanıcılarla sınırlı olup olmadığı.
terms_and_conditions

string

İş ortağı tarafından sağlanan birincil Hükümler ve Koşullar metni.
additional_terms_and_conditions[]

string

İş ortağının birincil Hükümler ve Koşulları'na ek olarak geçerli olan hükümler ve koşullar.