Package madden.ingestion.offer

ดัชนี

ActionType

[START action_type_definition] แสดงถึงโหมดการจำหน่ายของข้อเสนอ หากสามารถแชร์ข้อเสนอในโหมดการดำเนินการตามคำสั่งซื้อหลายโหมดได้ ระบบจะสร้างข้อเสนอที่ซ้ำกันสำหรับโหมดการดำเนินการตามคำสั่งซื้อแต่ละโหมด

Enum
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY ข้อเสนอนี้ใช้ได้กับบริการนำส่งอาหาร
ACTION_TYPE_FOOD_TAKEOUT ข้อเสนอนี้ใช้ได้กับการสั่งอาหารกลับบ้านหรือคำสั่งซื้อแบบไปรับเอง
ACTION_TYPE_DINING ข้อเสนอใช้สำหรับการรับประทานอาหารที่ร้านอาหาร
ACTION_TYPE_SHOPPING_IN_STORE ข้อเสนอนี้ใช้ได้กับการซื้อสินค้าที่ร้านค้าออฟไลน์

AdditionalFee

[START additional_fee_definition]

ช่อง
name

string

ชื่อของค่าธรรมเนียมเพิ่มเติม ตัวอย่าง: ค่าธรรมเนียมเพิ่มเติม ค่าธรรมเนียมการจัดการ ฯลฯ ต้องระบุ
fee

Fee

คูปอง

[START coupon_definition]

ช่อง
text

string

ข้อความคูปองที่ผู้ให้บริการข้อเสนอต้องการแสดงต่อผู้ใช้
code

string

ต้องระบุรหัสคูปองเพื่อแลกสิทธิ์ข้อเสนอ ต้องระบุ

ค่าธรรมเนียม

[START fee_definition] Next ID: 5

ช่อง
unit

FeeUnit
type

FeeType

ฟิลด์ Union cost

cost ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

Enum
FEE_TYPE_UNSPECIFIED ไม่ควรใช้ค่า enum ที่ไม่ได้ระบุหรือค่าเริ่มต้นในฟีด
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Enum
FEE_UNIT_UNSPECIFIED ไม่ควรใช้ค่า enum UNSPECIFIED หรือค่าเริ่มต้นในฟีด
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

ช่อง
amounts[]

Money

รายการมูลค่าที่แยกกันทั้งหมดที่ใช้ได้ (เช่น [100, 500, 1000])

FoodOfferRestrictions

[START food_offer_restrictions_definition]

ช่อง
meal_types[]

MealType

ประเภทอาหารที่ใช้ข้อเสนอได้ เช่น อาหารกลางวันหรืออาหารเย็น หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ข้อเสนอกับอาหารทุกประเภทได้
restricted_to_certain_courses

bool

ข้อเสนอนี้ใช้ได้กับบางหลักสูตรเท่านั้นหรือไม่

GiftCardInfo

[START gift_card_info_definition]

ช่อง

ฟิลด์ Union denomination_type

denomination_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
fixed_denominations

FixedDenominations

ใช้เมื่อบัตรของขวัญมีจำนวนเงินที่เฉพาะเจาะจงและคงที่
custom_range

MoneyRange

ใช้เมื่อแบรนด์อนุญาตให้ผู้ใช้เลือกมูลค่าที่ตราไว้แบบกำหนดเอง (ยืดหยุ่น) ภายในช่วงที่กำหนด

MealType

[START meal_type_definition]

Enum
MEAL_TYPE_UNSPECIFIED ไม่ควรใช้ค่า enum ที่ไม่ได้ระบุหรือค่าเริ่มต้นในฟีด
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

ช่อง
min_amount

Money
max_amount

Money

ข้อเสนอ

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

ช่อง
offer_id

string

รหัสที่ไม่ซ้ำกันของข้อเสนอ ต้องระบุ
entity_ids[]

string

รายชื่อผู้ขายที่เข้าร่วมข้อเสนอนี้
add_on_offer_applicable_to_all_entities

bool

หากเป็นจริง ข้อเสนอนี้จะใช้ได้กับเอนทิตีทั้งหมดภายใต้ผู้รวบรวมข้อมูล ใช้ได้กับข้อเสนอส่วนเสริมเท่านั้น
offer_source

OfferSource

ผู้รวบรวมข้อมูล ผู้ขายแต่ละราย หรือแม้แต่บุคคลที่สามสามารถเสนอข้อเสนอเป็นส่วนเสริมได้ ต้องระบุ
action_type

ActionType

บริการที่ให้ข้อเสนอ offer_id จะอยู่ใน action_type ได้เพียงประเภทเดียว หากสามารถแชร์ข้อเสนอในบริการหลายประเภทได้ ระบบจะสร้างข้อเสนอที่ซ้ำกันซึ่งมีรหัสที่ไม่ซ้ำกันสำหรับบริการแต่ละประเภท ต้องระบุ
offer_modes[]

OfferMode

วิธีการที่ใช้รับข้อเสนอได้ เช่น วอล์กอิน การจอง ออนไลน์ ฯลฯ (ต้องระบุ)
offer_category

OfferCategory

หมวดหมู่ของข้อเสนอ ต้องระบุ
source_assigned_priority

int32

จำนวนเต็มที่ไม่เป็นลบ ([1-100] โดยที่ 1 หมายถึงลำดับความสำคัญสูงสุด) ซึ่งระบุระดับความสำคัญของข้อเสนอที่แหล่งที่มามอบหมาย เมื่อมีข้อเสนอหลายรายการสำหรับผู้ขายรายเดียวกัน ข้อมูลนี้จะเป็นสัญญาณสำหรับการจัดอันดับข้อเสนอ 0 หมายความว่าไม่ได้ตั้งค่าลำดับความสำคัญ
offer_details

OfferDetails

รายละเอียดของข้อเสนอ เช่น ส่วนลด ค่าใช้จ่ายในการจอง ฯลฯ ต้องระบุ
offer_restrictions

OfferRestrictions

อธิบายวิธีจำกัดข้อเสนอ เช่น ต้องมีการสมัครใช้บริการ/เครื่องมือการชำระเงินหรือไม่ ข้อเสนอนี้ใช้ร่วมกับข้อเสนออื่นๆ ได้หรือไม่ (และประเภทใด) ฯลฯ ต้องระบุ
coupon

Coupon

รายละเอียดของคูปอง ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER
payment_instrument

PaymentInstrument

รายละเอียดของเครื่องมือการชำระเงิน ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
subscription

Subscription

รายละเอียดการสมัครใช้บริการ ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER
terms

Terms

ข้อกำหนดและเงื่อนไขของข้อเสนอ ต้องระบุ
validity_periods[]

ValidityPeriod

ระยะเวลาที่ข้อเสนอใช้ได้ อธิบายระยะเวลาที่ข้อเสนอใช้ได้ รวมถึงเวลาเริ่มต้นและสิ้นสุด วันในสัปดาห์ ฯลฯ ต้องระบุ
offer_url

string

URL ไปยังหน้าข้อเสนอของผู้ขาย ต้องระบุสำหรับ offer_category: OFFER_CATEGORY_BASE_OFFER
image_url

string

URL ของรูปภาพข้อเสนอของผู้ขาย
tags[]

OfferTag

แท็กพิเศษที่เชื่อมโยงกับข้อเสนอ ซึ่งใช้เพื่อระบุข้อเสนอพิเศษ เช่น "เทศกาล" "คะแนนสูงสุด" "จองมากที่สุด" เป็นต้น
brand_id

string

ระบุแบรนด์ที่เชื่อมโยงกับข้อเสนอ หากไม่ได้ตั้งค่า ระบบจะใช้แบรนด์เริ่มต้น

OfferCategory

[START offer_category_definition] หมวดหมู่ของข้อเสนอ ข้อเสนอพื้นฐานคือข้อเสนอมาตรฐานที่พร้อมให้บริการแก่ลูกค้าทุกราย เช่น ส่วนลด 10% เมื่อใช้จ่ายมากกว่า 3,000 บาท ข้อเสนอพื้นฐานที่ถูกจำกัดโดยคูปองหรือเครื่องมือการชำระเงินจะมีการตั้งค่าช่องที่เกี่ยวข้อง นอกจากนี้ เรายังมีข้อเสนอแบบซื้อเพิ่ม เช่น ADD_ON_PAYMENT_OFFER คุณสามารถเพิ่มข้อเสนอดังกล่าวลงในข้อเสนออื่นๆ เพื่อรับส่วนลดเพิ่มเติมได้

Enum
OFFER_CATEGORY_UNSPECIFIED ไม่ควรใช้ค่า enum ที่ไม่ระบุหรือค่าเริ่มต้นในฟีด
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]

ช่อง
description

string

OfferDetails

[START offer_details_definition] Next tag: 15

ช่อง
offer_display_text

string

ข้อความข้อเสนอที่ผู้ให้บริการข้อเสนอต้องการแสดงต่อลูกค้าในหน้าผลการค้นหา ต้องระบุ
max_discount_value

Money

ส่วนลดสูงสุดที่ใช้ได้ เช่น ลด 10% สูงสุด 1, 000 บาท
min_spend_value

Money

มูลค่าการใช้จ่ายขั้นต่ำเพื่อรับส่วนลด เช่น รับส่วนลด 10% เมื่อราคารวมเป็น $100 ขึ้นไป
booking_cost

Money

ค่าใช้จ่ายในการจองข้อเสนอนี้ เช่น ส่วนลด 3, 000 บาทจากบิลสุดท้ายเมื่อจองโต๊ะในราคา 450 บาท
booking_cost_unit

FeeUnit

หน่วยของค่าใช้จ่ายในการจอง เช่น ต่อคน ต่อธุรกรรม
convenience_fee

Fee
booking_cost_adjustable

bool

ระบุว่าปรับต้นทุนการจองได้หรือไม่ เช่น หักต้นทุนการจองออกจากใบเรียกเก็บเงินสุดท้าย เช่น ลด 30% สำหรับมื้อค่ำเมื่อจอง ค่าใช้จ่ายในการจองคือ $15 และระบบจะนำไปใช้กับการเรียกเก็บเงินขั้นสุดท้าย ดังนั้น ยอดเรียกเก็บเงินสุดท้ายจะเท่ากับค่าใช้จ่ายทั้งหมด - 30% - $15
additional_fees[]

AdditionalFee

ค่าธรรมเนียมเพิ่มเติมที่เรียกเก็บจากผู้ใช้ ตัวอย่าง: ค่าอำนวยความสะดวก ค่าดำเนินการ ค่าจัดส่ง ค่าบรรจุภัณฑ์ ค่าบริการ ฯลฯ
gift_card_info

GiftCardInfo

รายละเอียดสำหรับดีลบัตรของขวัญโดยเฉพาะ
ฟิลด์ Union offer_specification ส่วนลดอาจเป็นเปอร์เซ็นต์หรือค่าคงที่ที่หักออกจากมูลค่ารวม เช่น 1 ลด 10% สำหรับใบเรียกเก็บเงินสุดท้าย 2. ส่วนลด $15 สำหรับคำสั่งซื้อ นอกจากนี้ ผู้ขายยังเสนอส่วนลดที่กำหนดเอง เช่น "ซื้อ 1 แถม 1" ผ่านช่องข้อกำหนดที่เกี่ยวข้องได้ด้วย ต้องระบุ offer_specification ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
discount_percent

float

เปอร์เซ็นต์ของใบเรียกเก็บเงินที่ได้รับส่วนลด [0, 100] สำหรับข้อเสนอซื้อ 1 แถม 1 หรือลด 50% ที่ใช้ได้กับอาหารทั้งมื้อ (เช่น บุฟเฟต์ซื้อ 1 แถม 1, ซื้อ 1 แถม 1 สำหรับทั้งบิล, ซื้อ 1 แถม 1 สำหรับเมนูชุด) คุณสามารถตั้งค่านี้เป็น 50
discount_value

Money

มูลค่าคงที่ของส่วนลด
other_offer_detail_text

string

ข้อความรูปแบบอิสระเพื่ออธิบายส่วนลด สำหรับข้อเสนอ 1+1 ที่เฉพาะเจาะจง (เช่น เครื่องดื่ม 1+1, เมนูจานหลัก +1, รายการในเมนูที่เลือก 1+1) ควรระบุรายละเอียดเหล่านี้ที่นี่

OfferMode

[START offer_mode_definition] ระบุวิธีการหรือช่องทางที่ผู้ใช้จะใช้ข้อเสนอได้

Enum
OFFER_MODE_OTHER ใช้สำหรับวิธีการปฏิบัติตามคำสั่งซื้อที่โหมดอื่นๆ ที่เฉพาะเจาะจงไม่ครอบคลุม
OFFER_MODE_WALK_IN ข้อเสนอนี้ใช้ได้กับการเข้าชมสถานที่โดยไม่ต้องจองล่วงหน้า
OFFER_MODE_FREE_RESERVATION ข้อเสนอจะมีผลเมื่อผู้ใช้ทำการจองที่ไม่ต้องชำระค่าธรรมเนียมล่วงหน้า
OFFER_MODE_PAID_RESERVATION ข้อเสนอจะมีผลเมื่อผู้ใช้ทำการจองที่ต้องชำระเงินล่วงหน้า
OFFER_MODE_ONLINE_ORDER ข้อเสนอนี้ใช้ได้กับคำสั่งซื้อที่ดำเนินการผ่านเว็บไซต์หรือแพลตฟอร์มดิจิทัล
OFFER_MODE_GIFT_CARD_PURCHASE ระบุว่าการซื้อบัตรของขวัญเป็นขั้นตอนหลักที่จำเป็นในการรับดีล

OfferRestrictions

[START offer_restrictions_definition] Next tag: 11

ช่อง
combinable_with_other_offers

bool

ข้อเสนอนี้ใช้ร่วมกับข้อเสนออื่นๆ ได้หรือไม่ เมื่อเป็น "จริง" พาร์ทเนอร์จะระบุได้ว่าข้อเสนอนี้ใช้ร่วมกับข้อเสนอใดได้บ้าง หากตั้งค่าทั้ง combinable_offer_categories และ combinable_offer_ids ข้อเสนอที่ตรงกับเงื่อนไขใดเงื่อนไขหนึ่งข้างต้นจะใช้ร่วมกันได้
combinable_offer_categories[]

OfferCategory

รายการประเภทข้อเสนอที่ใช้ร่วมกับข้อเสนอนี้ได้ เช่น ข้อเสนอนี้อาจใช้ร่วมกับคูปองอื่นๆ ได้ หาก combinable_with_other_offers เป็นจริงและไม่ได้ตั้งค่าฟิลด์นี้ ระบบจะรวมข้อเสนอทุกประเภทได้
combinable_offer_ids[]

string

รายการ offer_id ที่ใช้ร่วมกับข้อเสนอนี้ได้ ข้อเสนอบางรายการอาจใช้ร่วมกับ offer_id อื่นๆ ที่เฉพาะเจาะจงเท่านั้น (ถือเป็นข้อเสนอหลักได้) หาก combinable_with_other_offers เป็นจริงและไม่ได้ตั้งค่าฟิลด์นี้ ระบบจะใช้รหัสข้อเสนอทั้งหมดร่วมกันได้
inclusions[]

OfferCondition

รายการเงื่อนไขที่ต้องปฏิบัติตามเพื่อให้ข้อเสนอถูกต้อง (เช่น เครื่องดื่มที่ไม่มีแอลกอฮอล์ อาหาร)
exclusions[]

OfferCondition

รายการเงื่อนไขที่จะทำให้ข้อเสนอไม่ถูกต้อง (เช่น บุฟเฟต์ ข้อเสนอแบบแพ็กเกจ และค็อกเทล)
min_guest

int32

จำนวนคนขั้นต่ำที่จำเป็นในการใช้ข้อเสนอ
food_offer_restrictions

FoodOfferRestrictions

ข้อจำกัดเฉพาะสำหรับข้อเสนออาหาร
special_conditions[]

string

เงื่อนไขพิเศษสำหรับข้อเสนอนี้ที่ต้องแสดงต่อผู้ใช้ ตัวอย่าง: "ใช้ได้เฉพาะการชำระเงินใน [พื้นที่]", "ไม่รวมการชำระเงินออนไลน์"

OfferSource

[START offer_source_definition]

Enum
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

Enum
OFFER_TAG_UNSPECIFIED ไม่ควรใช้ค่า enum ที่ไม่ระบุหรือค่าเริ่มต้นในฟีด
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

ช่อง
items[]

PaymentInstrumentItem

รายการเครื่องมือการชำระเงินที่ใช้เพื่อรับข้อเสนอได้ ต้องระบุ
provider_name

string

ชื่อผู้ให้บริการเครื่องมือการชำระเงิน อาจเป็นพาร์ทเนอร์ด้านการธนาคาร ชื่อธนาคาร ฯลฯ เช่น American Express, HDFC, ICICI

PaymentInstrumentItem

[START payment_instrument_item_definition]

ช่อง
type

PaymentInstrumentType

ประเภทของเครื่องมือการชำระเงิน ต้องระบุ
name

string

ชื่อของรายการเครื่องมือการชำระเงิน เช่น ชื่อบัตรเครดิต เช่น HDFC Infinia, American Express Platinum ต้องระบุ

PaymentInstrumentType

[START payment_instrument_type_definition]

Enum
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED ไม่ควรใช้ค่า enum ที่ไม่ระบุหรือค่าเริ่มต้นในฟีด
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

การสมัครใช้บริการ

[START subscription_definition]

ช่อง
name

string

ชื่อของการสมัครใช้บริการ ต้องระบุ
subscription_auto_added

bool

ระบบจะเพิ่มการสมัครใช้บริการโดยอัตโนมัติเมื่อผู้ใช้ใช้ข้อเสนอนี้หรือไม่
cost

Money

ค่าสมัครใช้บริการ ต้องระบุ
subscription_duration

Duration

ระยะเวลาที่การสมัครใช้บริการมีผลสำหรับค่าสมัครใช้บริการ [subscription_cost] ต้องระบุ
terms_and_conditions_url

string

URL ของข้อกำหนดและเงื่อนไขของพาร์ทเนอร์ที่เกี่ยวข้องกับการสมัครใช้บริการนี้

ข้อกำหนด

[START terms_definition]

ช่อง
url

string

URL ของข้อกำหนดและเงื่อนไขของพาร์ทเนอร์
restricted_to_certain_users

bool

ข้อเสนอจำกัดไว้สำหรับผู้ใช้บางรายหรือไม่
terms_and_conditions

string

ข้อความข้อกำหนดและเงื่อนไขหลักที่พาร์ทเนอร์ระบุ
additional_terms_and_conditions[]

string

ข้อกำหนดและเงื่อนไขเพิ่มเติมจากข้อกำหนดและเงื่อนไขหลักของพาร์ทเนอร์