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: 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 على عمليات الشراء التي تزيد قيمتها عن 100 ريال سعودي. سيتم ضبط الحقول ذات الصلة للعرض الأساسي المقيّد بقسيمة أو وسيلة دفع. لدينا أيضًا عروض "إضافة x"، مثل 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 هي true ولم يتم ضبط هذا الحقل، ستكون جميع الأنواع قابلة للجمع.
combinable_offer_ids[]

string

قائمة بمعرّفات العروض الترويجية (offer_id) التي يمكن الجمع بينها وبين هذا العرض قد لا يمكن الجمع بين بعض العروض إلا مع معرّفات عروض ترويجية أخرى معيّنة (يمكن اعتبارها عروضًا رئيسية). إذا كانت قيمة 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

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