Package madden.ingestion.offer

Dizin

ActionType

[START action_type_definition] Teklifin yerine getirilme 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 teslim alma yemek siparişleri için 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.

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

Kullanılabilir tüm ayrı birimlerin listesi (ör. [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

Alanlar
meal_types[]

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

bool

Teklifin yalnızca belirli kurslarda geçerli olup olmadığı

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 ve sabit tutarlarda sunulduğunda kullanılır.
custom_range

MoneyRange

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.

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] Sonraki etiket: 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

Doğruysa bu teklif, toplayıcı altındaki tüm öğeler 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 tekliflerin oluşturulması beklenir. Zorunlu.
offer_modes[]

OfferMode

Tekliften yararlanma yöntemleri (ör. mağazaya gitme, rezervasyon, online). Zorunludur.
offer_category

OfferCategory

Teklifin kategorisi. Zorunlu.
source_assigned_priority

int32

Kaynağın atadığı teklifin öncelik düzeyini gösteren, negatif olmayan bir 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

OfferDetails

İndirim, rezervasyon maliyeti gibi teklifin ayrıntıları. Zorunludur.
offer_restrictions

OfferRestrictions

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

Coupon

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

PaymentInstrument

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

Subscription

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

Terms

Teklifin şartları ve koşulları. Zorunlu.
validity_periods[]

ValidityPeriod

Teklifin geçerlilik süresi. Başlangıç ve bitiş zamanları, haftanın günleri vb. dahil olmak üzere teklifin geçerli olduğu zaman aralığını açıklar. Zorunludur.
offer_url

string

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

string

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

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

string

Hediye kartı anlaşmalarında, anlaşmayı sunan markayı tanımlamak için gereklidir.

OfferCategory

[START offer_category_definition] Teklifin kategorisi. Temel teklif, tüm müşterilerin yararlanabileceği standart bir tekliftir (ör. 100 TRY üzeri harcamalarda% 10 indirim). Kupon veya ödeme aracıyla kısıtlanan bir temel teklifte ilgili alanlar ayarlanır. ADD_ON_PAYMENT_OFFER gibi ek ürün tekliflerimiz de vardır. Bu tür teklifler, ek indirimlerden yararlanmak 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 TL 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 son 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 çıkarılıp çıkarılmadığı). Ö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[]

AdditionalFee

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

GiftCardInfo

Özellikle hediye kartı fırsatlarıyla ilgili 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şlerde 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 indirimli yüzdesi. [0, 100] Tüm yemek için geçerli olan 1+1 veya% 50 indirim tekliflerinde (ö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

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 yapılmadan yerinde ziyaretler için geçerlidir.
OFFER_MODE_FREE_RESERVATION Teklif, kullanıcının ön ödeme gerektirmeyen bir rezervasyon yaptığında 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.

OfferRestrictions

[START offer_restrictions_definition] Sonraki etiket: 11

Alanlar
combinable_with_other_offers

bool

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[]

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[]

string

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[]

OfferCondition

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

OfferCondition

Teklifi geçersiz kılacak koşulların listesi (ör. açık büfe, paket 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 teklif için 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

Teklifi kullanmak 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

Aboneliğin, kullanıcı bu tekliften yararlandığında otomatik olarak eklenip eklenmediği
cost

Money

Aboneliğin maliyeti Zorunlu.
subscription_duration

Duration

Aboneliğin subscription_cost fiyatıyla 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üm 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 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.