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 ไม่ควรใช้ค่าแจกแจง UNSPECIFIED หรือค่าเริ่มต้นในฟีด
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Enum
FEE_UNIT_UNSPECIFIED ไม่ควรใช้ค่าแจกแจง 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 ไม่ควรใช้ค่าแจกแจง UNSPECIFIED หรือค่าเริ่มต้นในฟีด
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 ไม่ควรใช้ค่าแจกแจง UNSPECIFIED หรือค่าเริ่มต้นในฟีด
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] แท็กถัดไป: 15

ช่อง
offer_display_text

string

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

Money

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

Money

ค่าการใช้จ่ายขั้นต่ำเพื่อรับส่วนลด เช่น ลด 10% เมื่อราคารวมเท่ากับ 1, 000 บาทขึ้นไป
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] แท็กถัดไป: 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 ที่ข้อเสนอนี้ใช้ร่วมได้ ข้อเสนอบางรายการอาจใช้ร่วมกับ other_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 ไม่ควรใช้ค่าแจกแจง UNSPECIFIED หรือค่าเริ่มต้นในฟีด
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 ไม่ควรใช้ค่าแจกแจง UNSPECIFIED หรือค่าเริ่มต้นในฟีด
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

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