Package madden.ingestion.offer

المؤشر

ActionType

[START action_type_definition] تمثّل هذه السمة طريقة الاستفادة من العرض. إذا كان يمكن مشاركة عرض على عدة طرق تنفيذ، من المتوقّع إنشاء عروض مكرّرة لكل طريقة تنفيذ.

عمليات التعداد
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

حقل الربط cost

يمكن أن يكون التعليق cost إحدى القيم التالية فقط:
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

عمليات التعداد
FEE_TYPE_UNSPECIFIED يجب عدم استخدام قيمة التعداد UNSPECIFIED أو القيمة التلقائية في الخلاصات.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

عمليات التعداد
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]

الحقول

حقل الربط denomination_type

يمكن أن يكون التعليق denomination_type إحدى القيم التالية فقط:
fixed_denominations

FixedDenominations

يتم استخدامها عندما تكون بطاقة الهدايا متاحة بمبالغ ثابتة ومحدّدة.
custom_range

MoneyRange

يُستخدَم عندما تسمح العلامة التجارية للمستخدمين باختيار قيمة اسمية مخصّصة (مرنة) ضمن نطاق محدّد.

MealType

[START meal_type_definition]

عمليات التعداد
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_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

مطلوبة لعروض بطاقات الهدايا لتحديد العلامة التجارية التي تقدّم العرض.

OfferCategory

[START offer_category_definition] فئة العرض العرض الأساسي هو عرض عادي متاح لجميع العملاء، مثل خصم بنسبة% 10 على الإنفاق الذي يزيد عن 100 ريال سعودي. سيتم ضبط الحقول ذات الصلة في العرض الأساسي المحظور بقسيمة أو وسيلة دفع. لدينا أيضًا عروض إضافية، مثل ADD_ON_PAYMENT_OFFER. ويمكن إضافة هذه العروض إلى عروض أخرى للحصول على خصومات إضافية.

عمليات التعداد
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 يصل إلى 100 ريال سعودي.
min_spend_value

Money

تمثّل هذه السمة الحدّ الأدنى لقيمة الإنفاق للاستفادة من الخصم. على سبيل المثال، خصم ‎10% عندما يكون السعر الإجمالي 100 دولار أمريكي أو أكثر.
booking_cost

Money

تمثّل هذه السمة تكلفة حجز هذا العرض. على سبيل المثال، خصم 100 دولار أمريكي من الفاتورة النهائية عند حجز طاولة بتكلفة 15 دولارًا أمريكيًا.
booking_cost_unit

FeeUnit

تمثّل هذه السمة وحدة تكلفة الحجز. على سبيل المثال، لكل شخص ولكل معاملة.
convenience_fee

Fee
booking_cost_adjustable

bool

تُستخدَم لتحديد ما إذا كان يمكن تعديل تكلفة الحجز، أي ما إذا كانت تكلفة الحجز تُطرح من الفاتورة النهائية. على سبيل المثال: خصم% 30 على العشاء عند الحجز. تبلغ تكلفة الحجز 15 دولارًا أمريكيًا، وسيتم تطبيقها على الفاتورة النهائية. وبالتالي، فإنّ الفاتورة النهائية هي: إجمالي المبلغ الذي تم إنفاقه - %30 - 15 دولارًا أمريكيًا
additional_fees[]

AdditionalFee

الرسوم الإضافية التي يتم تحصيلها من المستخدم أمثلة: الراحة والمناولة والتسليم والتغليف ورسوم الخدمة وما إلى ذلك
gift_card_info

GiftCardInfo

تفاصيل خاصة بصفقات بطاقات الهدايا
حقل الربط offer_specification يمكن أن يكون الخصم نسبة مئوية أو قيمة ثابتة يتم طرحها من القيمة الإجمالية. على سبيل المثال: 1. خصم% 10 على الفاتورة النهائية 2. خصم بقيمة 15 دولار أمريكي على أحد الطلبات يمكن للتجّار أيضًا تقديم خصومات مخصّصة، مثل "اشترِ قطعة واحصل على الأخرى مجانًا"، من خلال حقول المواصفات ذات الصلة. الحقل مطلوب. يمكن أن يكون التعليق offer_specification إحدى القيم التالية فقط:
discount_percent

float

نسبة الفاتورة التي يتم خصمها ‫[0, 100] بالنسبة إلى عروض "وجبتان بسعر وجبة واحدة" أو عروض الخصم بنسبة% 50 التي تنطبق على الوجبة بأكملها (مثل بوفيه "وجبتان بسعر وجبة واحدة" أو خصم "وجبتان بسعر وجبة واحدة" على الفاتورة بأكملها أو على قائمة الطعام المحدّدة)، يمكن ضبط هذه القيمة على 50.
discount_value

Money

القيمة الثابتة للخصم
other_offer_detail_text

string

نص حُرّ يصف الخصم. بالنسبة إلى عروض "اشترِ منتجًا واحصل على آخر مجانًا" المحدّدة (مثل مشروبان بسعر مشروب واحد، أو طبق رئيسي إضافي، أو منتجان محدّدان بسعر منتج واحد)، يجب توضيح هذه التفاصيل هنا.

OfferMode

[START offer_mode_definition] تحدّد هذه السمة الطريقة أو القناة التي يمكن للمستخدم الاستفادة من العرض الترويجي من خلالها.

عمليات التعداد
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

قائمة بمعرّفات العروض التي يمكن الجمع بينها وبين هذا العرض لا يمكن الجمع بين بعض العروض إلا مع أرقام تعريف عروض أخرى معيّنة (يمكن اعتبارها عروضًا رئيسية). إذا كانت قيمة combinable_with_other_offers هي "صحيح" ولم يتم ضبط هذا الحقل، يمكن الجمع بين جميع معرّفات العروض.
inclusions[]

OfferCondition

قائمة بالشروط التي يجب استيفاؤها ليكون العرض صالحًا (مثل المشروبات غير الكحولية والطعام)
exclusions[]

OfferCondition

قائمة بالشروط التي تؤدي إلى إبطال العرض (مثل البوفيه وعروض الوجبات والكوكتيلات)
min_guest

int32

الحدّ الأدنى لعدد الأشخاص المطلوب للاستفادة من العرض
food_offer_restrictions

FoodOfferRestrictions

قيود خاصة بعروض الطعام
special_conditions[]

string

تمثّل هذه السمة الشروط الخاصة لهذا العرض التي يجب عرضها للمستخدم. أمثلة: "صالحة للدفع في [المنطقة] فقط"، "لا تشمل الدفعات على الإنترنت"

OfferSource

[START offer_source_definition]

عمليات التعداد
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

عمليات التعداد
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]

عمليات التعداد
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

تحدّد هذه السمة مدة صلاحية الاشتراك مقابل تكلفة الاشتراك. الحقل مطلوب.
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

الأحكام والشروط بالإضافة إلى الأحكام والشروط الأساسية من الشريك