Package madden.ingestion.offer

فهرست

نوع اقدام

[START action_type_definition] نشان دهنده حالت انجام سفارش پیشنهاد است. اگر یک پیشنهاد بتواند در چندین حالت انجام سفارش به اشتراک گذاشته شود، انتظار می‌رود برای هر حالت انجام سفارش، پیشنهادهای تکراری ایجاد شود.

انوم‌ها
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY این پیشنهاد برای خدمات تحویل غذا قابل استفاده است.
ACTION_TYPE_FOOD_TAKEOUT این پیشنهاد برای سفارش‌های بیرون‌بر یا وانت قابل استفاده است.
ACTION_TYPE_DINING این پیشنهاد برای صرف غذا در رستوران در محل است.
ACTION_TYPE_SHOPPING_IN_STORE این پیشنهاد برای خریدهای حضوری و غیرحضوری قابل استفاده است.

هزینه اضافی

[شروع تعریف_هزینه_اضافی]

فیلدها
name

string

نام هزینه اضافی. مثال‌ها: هزینه رفاهی، هزینه جابجایی و غیره. الزامی است.

fee

Fee

کوپن

[شروع تعریف کوپن]

فیلدها
text

string

متن کوپنی که ارائه‌دهنده پیشنهاد می‌خواهد به کاربران نمایش دهد.

code

string

برای استفاده از پیشنهاد، کد تخفیف الزامی است. الزامی.

هزینه

[شروع تعریف هزینه] شناسه بعدی: 5

فیلدها
unit

FeeUnit

type

FeeType

cost میدانی اتحادیه.

cost می‌تواند فقط یکی از موارد زیر باشد:

amount

Money

amount_range

MoneyRange

نوع هزینه

[شروع نوع_تعریف_هزینه]

انوم‌ها
FEE_TYPE_UNSPECIFIED مقدار UNSPECIFIED یا مقدار پیش‌فرض enum نباید در فیدها استفاده شود.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

واحد هزینه

[شروع تعریف واحد هزینه]

انوم‌ها
FEE_UNIT_UNSPECIFIED مقدار UNSPECIFIED یا مقدار پیش‌فرض enum نباید در فیدها استفاده شود.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

فرقه‌های ثابت

فیلدها
amounts[]

Money

فهرستی از تمام مقادیر گسسته موجود (مثلاً [100، 500، 1000]).

محدودیت‌های پیشنهاد غذا

[شروع تعریف_محدودیت_پیشنهاد_غذا]

فیلدها
meal_types[]

MealType

انواع وعده‌های غذایی که این پیشنهاد می‌تواند برای آنها اعمال شود، مانند ناهار یا شام. در صورت عدم تنظیم، این پیشنهاد می‌تواند برای همه انواع وعده‌های غذایی اعمال شود.

restricted_to_certain_courses

bool

اینکه آیا این پیشنهاد فقط برای دوره‌های خاصی قابل استفاده است یا خیر.

اطلاعات کارت هدیه

[شروع تعریف اطلاعات کارت هدیه]

فیلدها

فیلد اتحادیه denomination_type .

denomination_type فقط می‌تواند یکی از موارد زیر باشد:

fixed_denominations

FixedDenominations

زمانی استفاده می‌شود که کارت هدیه در مبالغ مشخص و ثابتی موجود باشد.

custom_range

MoneyRange

زمانی استفاده می‌شود که برند به کاربران اجازه می‌دهد یک ارزش اسمی سفارشی (انعطاف‌پذیر) را در یک محدوده تعریف‌شده انتخاب کنند.

نوع غذا

[شروع تعریف نوع غذا]

انوم‌ها
MEAL_TYPE_UNSPECIFIED مقدار UNSPECIFIED یا مقدار پیش‌فرض enum نباید در فیدها استفاده شود.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

مانی رنج

[شروع تعریف محدوده پولی]

فیلدها
min_amount

Money

max_amount

Money

پیشنهاد

LINT.IfChange(offer_definition) [شروع offer_definition] برچسب بعدی: ۲۶

فیلدها
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_ADD_ON_COUPON_OFFER.

payment_instrument

PaymentInstrument

جزئیات یک ابزار پرداخت. مورد نیاز برای دسته بندی پیشنهاد: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER.

subscription

Subscription

جزئیات اشتراک. برای دسته بندی پیشنهاد الزامی است: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER.

terms

Terms

شرایط و ضوابط پیشنهاد. الزامی.

validity_periods[]

ValidityPeriod

مدت اعتبار پیشنهاد. مدت زمانی که پیشنهاد معتبر است را شرح می‌دهد، از جمله زمان شروع و پایان، روزهای هفته و غیره. الزامی است.

offer_url

string

آدرس اینترنتی (URL) صفحه پیشنهاد فروشنده. برای دسته بندی پیشنهاد، OFFER_CATEGORY_BASE_OFFER الزامی است.

image_url

string

نشانی اینترنتی (URL) تصویر پیشنهاد فروشنده.

tags[]

OfferTag

برچسب‌های ویژه مرتبط با پیشنهاد. این مورد برای شناسایی پیشنهادهای ویژه مانند «جشن»، «پرامتیازترین»، «پررزروترین» و غیره استفاده می‌شود.

brand_id

string

برای معاملات کارت هدیه، شناسایی برند ارائه دهنده معامله الزامی است.

دسته بندی پیشنهاد

[شروع تعریف دسته بندی پیشنهاد] دسته بندی پیشنهاد. پیشنهاد پایه، یک پیشنهاد استاندارد است که برای همه مشتریان در دسترس است، مانند 10٪ تخفیف برای خرید بالای 100 دلار. یک پیشنهاد پایه که توسط یک کوپن یا ابزار پرداخت محدود شده است، فیلدهای مربوطه را تنظیم می‌کند. ما همچنین پیشنهادهای اضافه x مانند ADD_ON_PAYMENT_OFFER داریم. چنین پیشنهادهایی را می‌توان به سایر پیشنهادها اضافه کرد تا تخفیف‌های بیشتری دریافت کرد.

انوم‌ها
OFFER_CATEGORY_UNSPECIFIED مقدار UNSPECIFIED یا مقدار پیش‌فرض enum نباید در فیدها استفاده شود.
OFFER_CATEGORY_BASE_OFFER
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
OFFER_CATEGORY_ADD_ON_COUPON_OFFER
OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER

پیشنهادشرایط

[شروع تعریف_شرایط_پیشنهاد]

فیلدها
description

string

جزئیات پیشنهاد

[شروع جزئیات_تعریف_پیشنهاد] برچسب بعدی: ۱۵

فیلدها
offer_display_text

string

متن پیشنهادی که ارائه‌دهنده پیشنهاد می‌خواهد در صفحه نتایج جستجو به مشتریان نمایش دهد. الزامی.

max_discount_value

Money

حداکثر تخفیفی که می‌توان از آن استفاده کرد. به عنوان مثال، 10٪ تخفیف تا سقف 100 دلار.

min_spend_value

Money

حداقل مبلغ قابل پرداخت برای استفاده از تخفیف. به عنوان مثال، 10٪ تخفیف وقتی قیمت کل 100 دلار یا بیشتر باشد.

booking_cost

Money

هزینه رزرو این پیشنهاد. به عنوان مثال، ۱۰۰ دلار تخفیف از صورتحساب نهایی در صورت رزرو میز با هزینه ۱۵ دلار.

booking_cost_unit

FeeUnit

واحد هزینه رزرو. به عنوان مثال، به ازای هر نفر، به ازای هر تراکنش.

convenience_fee

Fee

booking_cost_adjustable

bool

آیا هزینه رزرو قابل تنظیم است، یعنی هزینه رزرو از صورتحساب نهایی کسر می‌شود؟ برای مثال: 30٪ تخفیف شام با رزرو. هزینه رزرو 15 دلار است و در صورتحساب نهایی اعمال می‌شود. بنابراین صورتحساب نهایی: کل هزینه - 30٪ - 15 دلار

additional_fees[]

AdditionalFee

هزینه‌های اضافی که از کاربر دریافت می‌شود. مثال‌ها: راحتی، جابجایی، تحویل، بسته‌بندی، هزینه خدمات و غیره

gift_card_info

GiftCardInfo

جزئیات مخصوص معاملات کارت هدیه.

فیلد اتحادیه offer_specification . تخفیف می‌تواند درصد یا مقدار ثابتی باشد که از کل مبلغ کسر می‌شود. برای مثال: ۱. ۱۰٪ تخفیف روی صورتحساب نهایی. ۲. ۱۵ دلار تخفیف روی یک سفارش. فروشندگان همچنین می‌توانند تخفیف‌های سفارشی مانند «یکی بخر، یکی رایگان» را از طریق فیلدهای مشخصات مربوطه ارائه دهند. الزامی است. 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

متن آزاد برای توصیف تخفیف. برای پیشنهادات خاص ۱+۱ (مثلاً ۱+۱ نوشیدنی، ۱+۱ غذای اصلی، ۱+۱ مورد از منوی انتخابی)، این جزئیات باید در اینجا شرح داده شوند.

حالت پیشنهاد

[شروع حالت_تعریف_پیشنهاد] روش یا کانالی را مشخص می‌کند که کاربر از طریق آن می‌تواند از پیشنهاد استفاده کند.

انوم‌ها
OFFER_MODE_OTHER برای روش‌های انجام سفارش که تحت پوشش سایر حالت‌های خاص نیستند، استفاده شود.
OFFER_MODE_WALK_IN این پیشنهاد برای بازدید حضوری و بدون رزرو قبلی در دسترس است.
OFFER_MODE_FREE_RESERVATION این پیشنهاد زمانی اعمال می‌شود که کاربر رزروی انجام دهد که نیازی به پرداخت هزینه اولیه نداشته باشد.
OFFER_MODE_PAID_RESERVATION این پیشنهاد زمانی اعمال می‌شود که کاربر رزروی انجام دهد که نیاز به پرداخت پیش‌پرداخت دارد.
OFFER_MODE_ONLINE_ORDER این پیشنهاد برای سفارش‌هایی که از طریق وب‌سایت یا پلتفرم دیجیتال ثبت می‌شوند، معتبر است.
OFFER_MODE_GIFT_CARD_PURCHASE نشان می‌دهد که خرید کارت هدیه اولین قدم لازم برای دستیابی به این معامله است.

محدودیت‌های پیشنهاد

[شروع پیشنهاد_محدودیت‌ها_تعریف] برچسب بعدی: ۱۱

فیلدها
combinable_with_other_offers

bool

آیا این پیشنهاد می‌تواند با سایر پیشنهادها ترکیب شود؟ وقتی مقدار آن درست باشد، شرکا می‌توانند مشخص کنند که این پیشنهاد با چه پیشنهادهایی قابل ترکیب است. اگر هر دو combinable_offer_categories و combinable_offer_ids تنظیم شوند، هر پیشنهادی که با یکی از شرایط بالا مطابقت داشته باشد، قابل ترکیب خواهد بود.

combinable_offer_categories[]

OfferCategory

فهرست انواع پیشنهادهایی که این پیشنهاد می‌تواند با آنها ترکیب شود. برای مثال، این پیشنهاد ممکن است با کوپن‌های دیگر قابل ترکیب باشد. اگر combinable_with_other_offers مقدار true داشته باشد و این فیلد تنظیم نشده باشد، همه انواع قابل ترکیب خواهند بود.

combinable_offer_ids[]

string

فهرست شناسه‌های پیشنهادی که این پیشنهاد می‌تواند با آنها ترکیب شود. برخی از پیشنهادها فقط می‌توانند با شناسه‌های پیشنهادی خاص دیگری ترکیب شوند (می‌توانند به عنوان پیشنهادهای والد در نظر گرفته شوند). اگر مقدار combinable_with_other_offers درست باشد و این فیلد تنظیم نشده باشد، همه شناسه‌های پیشنهاد قابل ترکیب خواهند بود.

inclusions[]

OfferCondition

فهرست شرایطی که باید برای معتبر بودن پیشنهاد رعایت شوند (مثلاً نوشیدنی‌های غیرالکلی، غذا).

exclusions[]

OfferCondition

فهرست شرایطی که پیشنهاد را باطل می‌کند (مثلاً بوفه، پیشنهادهای ترکیبی و کوکتل).

min_guest

int32

حداقل تعداد نفرات مورد نیاز برای استفاده از پیشنهاد.

food_offer_restrictions

FoodOfferRestrictions

محدودیت‌های خاص مربوط به پیشنهادات غذایی.

special_conditions[]

string

شرایط ویژه این پیشنهاد که باید به کاربر نشان داده شود. مثال‌ها: «فقط برای پرداخت در [منطقه] معتبر است»، «پرداخت‌های آنلاین شامل نمی‌شود»

منبع پیشنهاد

[شروع تعریف منبع پیشنهاد]

انوم‌ها
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

برچسب پیشنهاد

[شروع تعریف_برچسب_پیشنهاد]

انوم‌ها
OFFER_TAG_UNSPECIFIED مقدار UNSPECIFIED یا مقدار پیش‌فرض enum نباید در فیدها استفاده شود.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

ابزار پرداخت

[شروع تعریف ابزار پرداخت]

فیلدها
items[]

PaymentInstrumentItem

فهرست ابزارهای پرداختی که می‌توان برای استفاده از این پیشنهاد استفاده کرد. الزامی.

provider_name

string

نام ارائه‌دهنده ابزار پرداخت. می‌تواند یک شریک بانکی، نام یک بانک و غیره باشد. برای مثال: American Express، HDFC، ICICI.

ابزار پرداخت

[شروع تعریف_ابزار_پرداخت_مورد]

فیلدها
type

PaymentInstrumentType

نوع ابزار پرداخت. الزامی.

name

string

نام ابزار پرداخت مانند نام کارت اعتباری. برای مثال: HDFC Infinia، American Express Platinum. الزامی است.

نوع ابزار پرداخت

[شروع تعریف نوع_ابزار_پرداخت]

انوم‌ها
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED مقدار UNSPECIFIED یا مقدار پیش‌فرض enum نباید در فیدها استفاده شود.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

اشتراک

[شروع تعریف اشتراک]

فیلدها
name

string

نام اشتراک. الزامی.

subscription_auto_added

bool

اینکه آیا اشتراک هنگام استفاده کاربر از این پیشنهاد به طور خودکار اضافه می‌شود یا خیر

cost

Money

هزینه اشتراک. الزامی.

subscription_duration

Duration

مدت زمان اعتبار اشتراک با نرخ اشتراک. الزامی.

terms_and_conditions_url

string

نشانی اینترنتی (URL) مربوط به شرایط و ضوابط شریک مربوط به این اشتراک.

شرایط

[شروع تعریف اصطلاحات]

فیلدها
url

string

نشانی اینترنتی (URL) شرایط و ضوابط شریک.

restricted_to_certain_users

bool

اینکه آیا این پیشنهاد محدود به کاربران خاصی است یا خیر.

terms_and_conditions

string

متن شرایط و ضوابط اولیه ارائه شده توسط شریک.

additional_terms_and_conditions[]

string

شرایط و ضوابط علاوه بر شرایط و ضوابط اولیه از طرف شریک.