Package madden.ingestion.offer

Chỉ mục

ActionType

[START action_type_definition] Biểu thị phương thức thực hiện của ưu đãi. Nếu một mặt hàng có thể được chia sẻ trên nhiều phương thức thực hiện đơn hàng, thì bạn cần tạo các mặt hàng trùng lặp cho từng phương thức thực hiện đơn hàng.

Enum
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY Ưu đãi này áp dụng cho dịch vụ giao đồ ăn.
ACTION_TYPE_FOOD_TAKEOUT Ưu đãi này áp dụng cho đơn đặt hàng mang về hoặc đơn đặt hàng tự đến lấy.
ACTION_TYPE_DINING Ưu đãi này dành cho khách dùng bữa tại nhà hàng.
ACTION_TYPE_SHOPPING_IN_STORE Ưu đãi này áp dụng cho các giao dịch mua sắm tại cửa hàng thực tế.

AdditionalFee

[START additional_fee_definition]

Trường
name

string

Tên của khoản phí bổ sung. Ví dụ: phí phụ thu, phí xử lý, v.v. Bắt buộc.
fee

Fee

Phiếu giảm giá

[BẮT ĐẦU coupon_definition]

Trường
text

string

Văn bản phiếu giảm giá mà nhà cung cấp ưu đãi muốn hiển thị cho người dùng.
code

string

Bạn phải có mã giảm giá để sử dụng ưu đãi. Bắt buộc.

Phí

[START fee_definition] Next ID: 5

Trường
unit

FeeUnit
type

FeeType

Trường nhóm cost.

cost chỉ có thể là một trong những trạng thái sau:
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

Enum
FEE_TYPE_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Enum
FEE_UNIT_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

Trường
amounts[]

Money

Danh sách tất cả các mệnh giá riêng biệt hiện có (ví dụ: [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

Trường
meal_types[]

MealType

Các loại bữa ăn mà ưu đãi có thể áp dụng, chẳng hạn như bữa trưa hoặc bữa tối. Nếu bạn không đặt, thì ưu đãi có thể áp dụng cho tất cả các loại bữa ăn.
restricted_to_certain_courses

bool

Ưu đãi chỉ có thể áp dụng cho một số khoá học nhất định hay không.

GiftCardInfo

[START gift_card_info_definition]

Trường

Trường nhóm denomination_type.

denomination_type chỉ có thể là một trong những trạng thái sau:
fixed_denominations

FixedDenominations

Được dùng khi thẻ quà tặng có sẵn ở một số tiền cố định cụ thể.
custom_range

MoneyRange

Được dùng khi thương hiệu cho phép người dùng chọn một giá trị mặt tuỳ chỉnh (linh hoạt) trong một phạm vi xác định.

MealType

[START meal_type_definition]

Enum
MEAL_TYPE_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

Trường
min_amount

Money
max_amount

Money

Ưu đãi

LINT.IfChange(offer_definition) [START offer_definition] Thẻ tiếp theo: 26

Trường
offer_id

string

Mã nhận dạng duy nhất của ưu đãi. Bắt buộc.
entity_ids[]

string

Danh sách những người bán đang tham gia chương trình ưu đãi này.
add_on_offer_applicable_to_all_entities

bool

Nếu đúng, ưu đãi này áp dụng cho tất cả các thực thể thuộc đơn vị tổng hợp. Chỉ áp dụng cho ưu đãi bổ sung.
offer_source

OfferSource

Một nhà tổng hợp, một người bán riêng lẻ hoặc thậm chí là một bên thứ ba có thể cung cấp ưu đãi dưới dạng một tiện ích bổ sung. Bắt buộc.
action_type

ActionType

Dịch vụ cung cấp ưu đãi. Một offer_id chỉ có thể thuộc về một action_type. Nếu một ưu đãi có thể được chia sẻ trên nhiều loại dịch vụ, thì bạn cần tạo các ưu đãi trùng lặp có mã nhận dạng riêng biệt cho từng loại dịch vụ. Bắt buộc.
offer_modes[]

OfferMode

Các phương thức mà bạn có thể sử dụng ưu đãi – đến trực tiếp, đặt chỗ, trực tuyến, v.v. Bắt buộc.
offer_category

OfferCategory

Danh mục của ưu đãi. Bắt buộc.
source_assigned_priority

int32

Số nguyên không âm ([1-100], trong đó 1 là mức độ ưu tiên cao nhất) cho biết mức độ ưu tiên của mặt hàng do nguồn chỉ định. Khi có nhiều mặt hàng của cùng một người bán, đây sẽ là một tín hiệu để xếp hạng mặt hàng. 0 có nghĩa là bạn chưa đặt mức độ ưu tiên.
offer_details

OfferDetails

Thông tin chi tiết về ưu đãi, chẳng hạn như chiết khấu, chi phí đặt chỗ, v.v. Bắt buộc.
offer_restrictions

OfferRestrictions

Mô tả cách ưu đãi bị hạn chế, tức là có cần gói thuê bao/phương thức thanh toán hay không, ưu đãi này có thể kết hợp với các ưu đãi khác (và những loại ưu đãi nào) hay không, v.v. Bắt buộc.
coupon

Coupon

Thông tin chi tiết về phiếu giảm giá. Bắt buộc đối với offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.
payment_instrument

PaymentInstrument

Thông tin chi tiết về một phương thức thanh toán. Bắt buộc đối với offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER.
subscription

Subscription

Thông tin chi tiết về một gói thuê bao. Bắt buộc đối với offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER.
terms

Terms

Điều khoản và điều kiện của ưu đãi. Bắt buộc.
validity_periods[]

ValidityPeriod

Thời hạn hiệu lực của ưu đãi. Mô tả khoảng thời gian mà ưu đãi có hiệu lực, bao gồm cả thời gian bắt đầu và kết thúc, ngày trong tuần, v.v. Bắt buộc.
offer_url

string

URL đến trang ưu đãi của người bán. Bắt buộc đối với offer_category: OFFER_CATEGORY_BASE_OFFER.
image_url

string

URL đến hình ảnh sản phẩm của người bán.
tags[]

OfferTag

Các thẻ đặc biệt liên kết với ưu đãi. Thuộc tính này được dùng để xác định các ưu đãi đặc biệt như "Lễ hội", "Được đánh giá cao nhất", "Được đặt nhiều nhất", v.v.
brand_id

string

Bắt buộc đối với các ưu đãi Thẻ quà tặng để xác định thương hiệu cung cấp ưu đãi.

OfferCategory

[START offer_category_definition] Danh mục của ưu đãi. Ưu đãi cơ bản là ưu đãi tiêu chuẩn dành cho tất cả khách hàng, chẳng hạn như giảm giá 10% cho khách hàng chi tiêu trên 1.000.000 VND. Một sản phẩm cơ sở bị hạn chế bởi phiếu giảm giá hoặc phương thức thanh toán sẽ có các trường tương ứng được đặt. Chúng tôi cũng có các ưu đãi bổ sung như ADD_ON_PAYMENT_OFFER. Bạn có thể thêm những ưu đãi như vậy vào các ưu đãi khác để được chiết khấu thêm.

Enum
OFFER_CATEGORY_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
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]

Trường
description

string

OfferDetails

[START offer_details_definition] Thẻ tiếp theo: 15

Trường
offer_display_text

string

Văn bản ưu đãi mà nhà cung cấp ưu đãi muốn hiển thị cho khách hàng trên trang kết quả tìm kiếm. Bắt buộc.
max_discount_value

Money

Mức chiết khấu tối đa mà bạn có thể nhận được. Ví dụ: giảm giá 10% tối đa 1.000.000 VND.
min_spend_value

Money

Giá trị chi tiêu tối thiểu để được hưởng chiết khấu. Ví dụ: Giảm 10% khi tổng giá trị đơn hàng từ 1.000.000 VND trở lên.
booking_cost

Money

Chi phí để đặt ưu đãi này. Ví dụ: giảm 1.000.000 VND cho hoá đơn cuối cùng khi đặt bàn với giá 150.000 VND.
booking_cost_unit

FeeUnit

Đơn vị của chi phí đặt phòng. Ví dụ: mỗi người, mỗi giao dịch.
convenience_fee

Fee
booking_cost_adjustable

bool

Chi phí đặt phòng có thể điều chỉnh hay không, tức là chi phí đặt phòng được trừ vào hoá đơn cuối cùng. Ví dụ: Giảm giá 30% cho bữa tối khi đặt trước. Chi phí đặt trước là 15 USD và sẽ được áp dụng cho hoá đơn cuối cùng. Do đó, hoá đơn cuối cùng là: Tổng số tiền đã chi tiêu – 30% – 15 USD
additional_fees[]

AdditionalFee

Các khoản phí bổ sung mà người dùng phải trả. Ví dụ: phí tiện lợi, phí xử lý, phí giao hàng, phí đóng gói, phí dịch vụ, v.v.
gift_card_info

GiftCardInfo

Thông tin chi tiết dành riêng cho ưu đãi thẻ quà tặng.
Trường nhóm offer_specification. Chiết khấu có thể là tỷ lệ phần trăm hoặc giá trị cố định được trừ vào tổng giá trị. Ví dụ: 1. Giảm 10% cho hoá đơn cuối cùng. 2. Giảm 15 đô la cho một đơn đặt hàng. Người bán cũng có thể cung cấp chiết khấu tuỳ chỉnh như "mua một tặng một" thông qua các trường thông số kỹ thuật có liên quan. Bắt buộc. offer_specification chỉ có thể là một trong những trạng thái sau:
discount_percent

float

Tỷ lệ phần trăm hoá đơn được chiết khấu. [0, 100] Đối với ưu đãi 1 tặng 1 hoặc giảm 50% áp dụng cho toàn bộ bữa ăn (ví dụ: ưu đãi 1 tặng 1 cho bữa ăn tự chọn, ưu đãi 1 tặng 1 cho toàn bộ hoá đơn, ưu đãi 1 tặng 1 cho thực đơn cố định), bạn có thể đặt giá trị này thành 50.
discount_value

Money

Giá trị cố định của chiết khấu.
other_offer_detail_text

string

Văn bản dạng tự do để mô tả chiết khấu. Đối với các ưu đãi 1+1 cụ thể (ví dụ: 1+1 đồ uống, +1 món chính, 1+1 món ăn chọn lọc), bạn nên mô tả những thông tin chi tiết này tại đây.

OfferMode

[START offer_mode_definition] Chỉ định phương thức hoặc kênh mà người dùng có thể sử dụng ưu đãi.

Enum
OFFER_MODE_OTHER Sử dụng cho những phương thức thực hiện đơn hàng không thuộc các chế độ cụ thể khác.
OFFER_MODE_WALK_IN Ưu đãi này áp dụng cho những lượt ghé thăm tại chỗ mà không cần đặt trước.
OFFER_MODE_FREE_RESERVATION Ưu đãi này áp dụng khi người dùng đặt phòng mà không phải trả trước phí.
OFFER_MODE_PAID_RESERVATION Ưu đãi này áp dụng khi người dùng đặt phòng và phải thanh toán trước.
OFFER_MODE_ONLINE_ORDER Ưu đãi này chỉ áp dụng cho các đơn đặt hàng thông qua trang web hoặc nền tảng kỹ thuật số.
OFFER_MODE_GIFT_CARD_PURCHASE Cho biết việc mua thẻ quà tặng là bước chính cần thiết để nhận được ưu đãi.

OfferRestrictions

[START offer_restrictions_definition] Thẻ tiếp theo: 11

Trường
combinable_with_other_offers

bool

Ưu đãi này có thể kết hợp với các ưu đãi khác hay không. Khi bạn đặt thành true, đối tác có thể chỉ định những sản phẩm mà sản phẩm này có thể kết hợp. Nếu bạn đặt cả combinable_offer_categories và combinable_offer_ids thì mọi ưu đãi đáp ứng một trong các điều kiện trên đều có thể kết hợp.
combinable_offer_categories[]

OfferCategory

Danh sách các loại mặt hàng mà bạn có thể kết hợp với mặt hàng này. Ví dụ: ưu đãi này có thể kết hợp với các Phiếu giảm giá khác. Nếu combinable_with_other_offers là true và bạn chưa đặt trường này, thì tất cả các loại đều có thể kết hợp.
combinable_offer_ids[]

string

Danh sách offer_id mà ưu đãi này có thể kết hợp. Một số ưu đãi chỉ có thể kết hợp với một số offer_id cụ thể khác (có thể được coi là ưu đãi chính). Nếu combinable_with_other_offers là true và bạn chưa đặt trường này, thì tất cả mã ưu đãi đều có thể kết hợp.
inclusions[]

OfferCondition

Danh sách các điều kiện phải đáp ứng để ưu đãi có hiệu lực (ví dụ: đồ uống không cồn, thực phẩm).
exclusions[]

OfferCondition

Danh sách các điều kiện khiến ưu đãi không hợp lệ (ví dụ: buffet, ưu đãi kết hợp và cocktail).
min_guest

int32

Số người tối thiểu cần thiết để sử dụng ưu đãi.
food_offer_restrictions

FoodOfferRestrictions

Quy định hạn chế dành riêng cho mặt hàng thực phẩm.
special_conditions[]

string

Các điều kiện đặc biệt của ưu đãi này mà người dùng phải nhìn thấy. Ví dụ: "Chỉ có hiệu lực đối với việc thanh toán ở [khu vực]", "Không áp dụng cho thanh toán trực tuyến"

OfferSource

[BẮT ĐẦU offer_source_definition]

Enum
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

Enum
OFFER_TAG_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

Trường
items[]

PaymentInstrumentItem

Danh sách các phương thức thanh toán có thể dùng để tận hưởng ưu đãi. Bắt buộc.
provider_name

string

Tên của nhà cung cấp phương thức thanh toán. Có thể là đối tác ngân hàng, tên ngân hàng, v.v. Ví dụ: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

Trường
type

PaymentInstrumentType

Loại phương thức thanh toán. Bắt buộc.
name

string

Tên của mục phương thức thanh toán, chẳng hạn như tên của thẻ tín dụng. Ví dụ: HDFC Infinia, American Express Platinum. Bắt buộc.

PaymentInstrumentType

[START payment_instrument_type_definition]

Enum
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

Gói đăng ký

[START subscription_definition]

Trường
name

string

Tên của gói thuê bao. Bắt buộc.
subscription_auto_added

bool

Liệu gói thuê bao có được tự động thêm khi người dùng sử dụng ưu đãi này hay không
cost

Money

Chi phí của gói thuê bao. Bắt buộc.
subscription_duration

Duration

Thời hạn hiệu lực của gói thuê bao tại subscription_cost. Bắt buộc.
terms_and_conditions_url

string

URL dẫn đến các điều khoản và điều kiện của đối tác liên quan đến gói thuê bao này.

Điều khoản

[START terms_definition]

Trường
url

string

URL dẫn đến điều khoản và điều kiện của đối tác.
restricted_to_certain_users

bool

Ưu đãi có bị giới hạn cho một số người dùng nhất định hay không.
terms_and_conditions

string

Văn bản chính về Điều khoản và điều kiện do đối tác cung cấp.
additional_terms_and_conditions[]

string

Điều khoản và điều kiện bổ sung cho điều khoản và điều kiện chính của đối tác.