Package madden.ingestion.offer

Indeks

ActionType

[START action_type_definition] Merepresentasikan mode pemenuhan penawaran. Jika penawaran dapat dibagikan di beberapa mode pemenuhan, penawaran duplikat diharapkan dibuat untuk setiap mode pemenuhan.

Enum
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY Penawaran ini berlaku untuk layanan pengiriman makanan.
ACTION_TYPE_FOOD_TAKEOUT Penawaran ini berlaku untuk pesanan makanan yang dibawa pulang atau diambil.
ACTION_TYPE_DINING Penawaran ini berlaku untuk bersantap di restoran.
ACTION_TYPE_SHOPPING_IN_STORE Penawaran ini berlaku untuk pembelian offline di toko.

AdditionalFee

[START additional_fee_definition]

Kolom
name

string

Nama biaya tambahan. Contoh: biaya administrasi, biaya penanganan, dll. Wajib diisi.
fee

Fee

Kupon

[START coupon_definition]

Kolom
text

string

Teks kupon yang ingin ditampilkan penyedia penawaran kepada pengguna.
code

string

Kode kupon diperlukan untuk menukarkan penawaran. Wajib.

Biaya

[START fee_definition] ID Berikutnya: 5

Kolom
unit

FeeUnit
type

FeeType

Kolom union cost.

cost hanya dapat berupa salah satu dari hal berikut:
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

Enum
FEE_TYPE_UNSPECIFIED Nilai enum UNSPECIFIED atau default tidak boleh digunakan dalam feed.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Enum
FEE_UNIT_UNSPECIFIED Nilai enum UNSPECIFIED atau default tidak boleh digunakan dalam feed.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

Kolom
amounts[]

Money

Daftar semua denominasi diskrit yang tersedia (misalnya, [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

Kolom
meal_types[]

MealType

Jenis makanan yang dapat menerapkan penawaran, seperti makan siang atau makan malam. Jika tidak disetel, penawaran dapat diterapkan ke semua jenis makanan.
restricted_to_certain_courses

bool

Apakah penawaran hanya dapat diterapkan ke kursus tertentu.

GiftCardInfo

[START gift_card_info_definition]

Kolom

Kolom union denomination_type.

denomination_type hanya dapat berupa salah satu dari hal berikut:
fixed_denominations

FixedDenominations

Digunakan saat kartu voucher tersedia dalam jumlah tetap tertentu.
custom_range

MoneyRange

Digunakan saat merek mengizinkan pengguna memilih nilai nominal kustom (fleksibel) dalam rentang yang ditentukan.

MealType

[START meal_type_definition]

Enum
MEAL_TYPE_UNSPECIFIED Nilai enum UNSPECIFIED atau default tidak boleh digunakan dalam feed.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

Kolom
min_amount

Money
max_amount

Money

Penawaran

LINT.IfChange(offer_definition) [START offer_definition] Tag berikutnya: 26

Kolom
offer_id

string

ID unik penawaran. Wajib.
entity_ids[]

string

Daftar penjual yang berpartisipasi dalam penawaran ini.
add_on_offer_applicable_to_all_entities

bool

Jika benar, penawaran ini berlaku untuk semua entitas di bawah agregator. Hanya berlaku untuk penawaran add-on.
offer_source

OfferSource

Penawaran dapat diberikan oleh agregator, penjual perorangan, atau bahkan pihak ketiga sebagai add-on. Wajib.
action_type

ActionType

Layanan yang menyediakan penawaran. offer_id hanya dapat dimiliki oleh satu action_type. Jika penawaran dapat dibagikan di beberapa jenis layanan, penawaran duplikat dengan ID unik diharapkan dibuat untuk setiap jenis layanan. Wajib.
offer_modes[]

OfferMode

Metode yang dapat digunakan untuk mendapatkan penawaran - datang langsung, reservasi, online, dll. Wajib diisi.
offer_category

OfferCategory

Kategori penawaran. Wajib.
source_assigned_priority

int32

Bilangan bulat non-negatif ([1-100], dengan 1 mewakili prioritas tertinggi) yang menunjukkan tingkat prioritas penawaran yang ditetapkan oleh sumber. Jika beberapa penawaran tersedia untuk penjual yang sama, hal ini akan menjadi sinyal untuk memberi peringkat penawaran. 0 menunjukkan bahwa prioritas tidak ditetapkan.
offer_details

OfferDetails

Detail penawaran seperti diskon, biaya pemesanan, dll. Wajib diisi.
offer_restrictions

OfferRestrictions

Mendeskripsikan cara penawaran dibatasi, yaitu apakah langganan/instrumen pembayaran diperlukan, apakah penawaran ini dapat digabungkan dengan penawaran lain (dan jenisnya), dll. Wajib.
coupon

Coupon

Detail kupon. Wajib untuk offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.
payment_instrument

PaymentInstrument

Detail instrumen pembayaran. Wajib untuk offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER.
subscription

Subscription

Detail langganan. Wajib untuk offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER.
terms

Terms

Persyaratan dan ketentuan penawaran. Wajib.
validity_periods[]

ValidityPeriod

Periode validitas penawaran. Mendeskripsikan jangka waktu berlakunya penawaran, termasuk waktu mulai dan berakhir, hari dalam seminggu, dll. Wajib diisi.
offer_url

string

URL ke halaman penawaran penjual. Wajib untuk offer_category: OFFER_CATEGORY_BASE_OFFER.
image_url

string

URL ke gambar penawaran penjual.
tags[]

OfferTag

Tag khusus yang terkait dengan penawaran. Ini digunakan untuk mengidentifikasi penawaran khusus seperti "Festive", "Top Rated", "Most booked", dll.
brand_id

string

Wajib diisi untuk promo Kartu Voucher guna mengidentifikasi merek yang menawarkan promo.

OfferCategory

[START offer_category_definition] Kategori penawaran. Penawaran dasar adalah penawaran standar yang tersedia untuk semua pelanggan, seperti diskon 10% untuk pembelanjaan di atas Rp1.000.000. Penawaran dasar yang dibatasi oleh kupon atau instrumen pembayaran akan memiliki kolom masing-masing yang ditetapkan. Kami juga memiliki penawaran add-on x seperti ADD_ON_PAYMENT_OFFER. Penawaran tersebut dapat ditambahkan ke penawaran lain untuk mendapatkan diskon tambahan.

Enum
OFFER_CATEGORY_UNSPECIFIED Nilai enum UNSPECIFIED atau default tidak boleh digunakan dalam feed.
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]

Kolom
description

string

OfferDetails

[START offer_details_definition] Tag berikutnya: 15

Kolom
offer_display_text

string

Teks penawaran yang ingin ditampilkan penyedia penawaran kepada pelanggan di halaman hasil penelusuran. Wajib.
max_discount_value

Money

Diskon maksimum yang dapat diperoleh. Misalnya, diskon 10% hingga Rp1.000.000.
min_spend_value

Money

Nilai pembelanjaan minimum untuk mendapatkan diskon. Misalnya, diskon 10% jika total harga Rp1.000.000 atau lebih.
booking_cost

Money

Biaya untuk memesan penawaran ini. Misalnya, diskon Rp1.000.000 untuk tagihan akhir saat meja dipesan dengan biaya Rp150.000.
booking_cost_unit

FeeUnit

Satuan biaya pemesanan. Misalnya, per orang, per transaksi.
convenience_fee

Fee
booking_cost_adjustable

bool

Apakah biaya pemesanan dapat disesuaikan, yaitu biaya pemesanan dikurangi dari tagihan akhir. Misalnya: Diskon 30% untuk makan malam dengan reservasi. Biaya untuk melakukan reservasi adalah $15 dan akan diterapkan ke tagihan akhir. Jadi, tagihan akhir: Total yang Dibelanjakan - 30% - $15
additional_fees[]

AdditionalFee

Biaya tambahan yang ditagihkan kepada pengguna. Contoh: biaya kenyamanan, penanganan, pengiriman, pengemasan, biaya layanan, dll.
gift_card_info

GiftCardInfo

Detail khusus untuk promo kartu voucher.
Kolom union offer_specification. Diskon dapat berupa persentase atau nilai tetap yang dikurangi dari nilai total. Contoh: 1. Diskon 10% untuk tagihan akhir. 2. Diskon Rp150.000 untuk pesanan. Penjual juga dapat menawarkan diskon kustom seperti 'beli satu gratis satu' melalui kolom spesifikasi yang relevan. Wajib. offer_specification hanya dapat berupa salah satu dari berikut:
discount_percent

float

Persentase tagihan yang didiskon. [0, 100] Untuk penawaran 1+1 atau diskon 50% yang berlaku untuk seluruh makanan (misalnya, prasmanan 1+1, 1+1 untuk seluruh tagihan, 1+1 untuk menu tetap), nilai ini dapat ditetapkan ke 50.
discount_value

Money

Nilai tetap diskon.
other_offer_detail_text

string

Teks bentuk bebas untuk mendeskripsikan diskon. Untuk penawaran 1+1 tertentu (misalnya, 1+1 minuman, +1 hidangan utama, 1+1 item menu tertentu), detail ini harus dijelaskan di sini.

OfferMode

[START offer_mode_definition] Menentukan metode atau saluran yang dapat digunakan pengguna untuk memanfaatkan penawaran.

Enum
OFFER_MODE_OTHER Gunakan untuk metode pemenuhan yang tidak tercakup oleh mode spesifik lainnya.
OFFER_MODE_WALK_IN Penawaran ini tersedia untuk kunjungan di lokasi tanpa reservasi sebelumnya.
OFFER_MODE_FREE_RESERVATION Penawaran ini berlaku saat pengguna melakukan reservasi yang tidak memerlukan biaya di muka.
OFFER_MODE_PAID_RESERVATION Penawaran ini berlaku saat pengguna melakukan reservasi yang memerlukan pembayaran di muka.
OFFER_MODE_ONLINE_ORDER Penawaran ini berlaku untuk pesanan yang dilakukan melalui situs atau platform digital.
OFFER_MODE_GIFT_CARD_PURCHASE Menunjukkan bahwa pembelian kartu voucher adalah langkah utama yang diperlukan untuk mendapatkan promo.

OfferRestrictions

[START offer_restrictions_definition] Tag berikutnya: 11

Kolom
combinable_with_other_offers

bool

Apakah penawaran ini dapat digabungkan dengan penawaran lainnya. Jika benar (true), partner dapat menentukan penawaran yang dapat digabungkan dengan penawaran ini. Jika combinable_offer_categories & combinable_offer_ids ditetapkan, penawaran yang cocok dengan salah satu kondisi di atas akan dapat digabungkan.
combinable_offer_categories[]

OfferCategory

Daftar jenis penawaran yang dapat digabungkan dengan penawaran ini. Misalnya, penawaran ini dapat digabungkan dengan Kupon lainnya. Jika combinable_with_other_offers benar dan kolom ini tidak disetel, semua jenis akan dapat digabungkan.
combinable_offer_ids[]

string

Daftar offer_id yang dapat digabungkan dengan penawaran ini. Beberapa penawaran hanya dapat digabungkan dengan offer_id tertentu lainnya (dapat dianggap sebagai penawaran induk). Jika combinable_with_other_offers benar dan kolom ini tidak disetel, semua id penawaran dapat digabungkan.
inclusions[]

OfferCondition

Daftar kondisi yang harus dipenuhi agar penawaran valid (misalnya, minuman non-alkohol, makanan).
exclusions[]

OfferCondition

Daftar kondisi yang akan membatalkan penawaran (misalnya, prasmanan, penawaran kombo, dan koktail).
min_guest

int32

Jumlah minimum orang yang diperlukan untuk memanfaatkan penawaran.
food_offer_restrictions

FoodOfferRestrictions

Batasan khusus untuk penawaran makanan.
special_conditions[]

string

Kondisi khusus untuk penawaran ini yang harus ditampilkan kepada pengguna. Contoh: "Hanya berlaku untuk pembayaran di [area]", "Tidak termasuk pembayaran online"

OfferSource

[START offer_source_definition]

Enum
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

Enum
OFFER_TAG_UNSPECIFIED Nilai enum UNSPECIFIED atau default tidak boleh digunakan dalam feed.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

Kolom
items[]

PaymentInstrumentItem

Daftar alat pembayaran yang dapat digunakan untuk memanfaatkan penawaran. Wajib.
provider_name

string

Nama penyedia instrumen pembayaran. Dapat berupa partner perbankan, nama bank, dll. Misalnya: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

Kolom
type

PaymentInstrumentType

Jenis instrumen pembayaran. Wajib.
name

string

Nama item alat pembayaran seperti nama kartu kredit. Misalnya: HDFC Infinia, American Express Platinum. Wajib.

PaymentInstrumentType

[START payment_instrument_type_definition]

Enum
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED Nilai enum UNSPECIFIED atau default tidak boleh digunakan dalam feed.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

Langganan

[START subscription_definition]

Kolom
name

string

Nama langganan. Wajib.
subscription_auto_added

bool

Apakah langganan ditambahkan secara otomatis saat pengguna memanfaatkan penawaran ini
cost

Money

Biaya langganan. Wajib.
subscription_duration

Duration

Durasi masa berlaku langganan dengan subscription_cost. Wajib.
terms_and_conditions_url

string

URL persyaratan dan ketentuan partner yang relevan dengan langganan ini.

Persyaratan

[START terms_definition]

Kolom
url

string

URL persyaratan dan ketentuan partner.
restricted_to_certain_users

bool

Apakah penawaran dibatasi untuk pengguna tertentu.
terms_and_conditions

string

Teks Syarat dan Ketentuan utama yang disediakan oleh partner.
additional_terms_and_conditions[]

string

Persyaratan dan ketentuan selain T&K utama dari partner.