Package madden.ingestion.offer

אינדקס

• ‫ActionType (enum)
• ‫AdditionalFee (הודעה)
• ‫Coupon (הודעה)
• ‫Fee (הודעה)
• ‫FeeType (enum)
• FeeUnit (enum)
• ‫FixedDenominations (הודעה)
• ‫FoodOfferRestrictions (הודעה)
• ‫GiftCardInfo (הודעה)
• MealType (enum)
• ‫MoneyRange (הודעה)
• ‫Offer (הודעה)
• ‫OfferCategory (enum)
• ‫OfferCondition (הודעה)
• ‫OfferDetails (הודעה)
• ‫OfferMode (enum)
• ‫OfferRestrictions (הודעה)
• OfferSource (enum)
• OfferTag (enum)
• ‫PaymentInstrument (הודעה)
• ‫PaymentInstrumentItem (הודעה)
• ‫PaymentInstrumentType (enum)
• ‫Subscription (הודעה)
• ‫Terms (הודעה)

ActionType

[START action_type_definition] מייצג את אופן מילוי ההזמנה של המוצר. אם אפשר לשתף מבצע בכמה מצבי אספקה, צפוי שייווצרו מבצעים כפולים לכל מצב אספקה.

טיפוסים בני מנייה (enum)
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]

טיפוסים בני מנייה (enum)
FEE_TYPE_UNSPECIFIED	אין להשתמש בערך ברירת המחדל או בערך UNSPECIFIED של סוג הנתונים enum בפידים.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

טיפוסים בני מנייה (enum)
FEE_UNIT_UNSPECIFIED	אין להשתמש בערך ברירת המחדל או בערך UNSPECIFIED של סוג הנתונים enum בפידים.
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]

טיפוסים בני מנייה (enum)
MEAL_TYPE_UNSPECIFIED	אין להשתמש בפידים בערך UNSPECIFIED או בערך ברירת המחדל של enum.
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 אם הערך הוא True, המבצע הזה חל על כל הישויות שמשויכות למצטבר. המאפיין הזה רלוונטי רק למבצעים על חבילות ערוצים.
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: ‏OFFER_CATEGORY_ADD_ON_COUPON_OFFER.
payment_instrument	PaymentInstrument פרטים של אמצעי תשלום. חובה לקטגוריית המבצע: 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$. אם חבילת הבסיס מוגבלת לשובר או לאמצעי תשלום, השדות הרלוונטיים יוגדרו. יש לנו גם מבצעים על חבילות ערוצים, כמו ADD_ON_PAYMENT_OFFER. אפשר להוסיף מבצעים כאלה למבצעים אחרים כדי לקבל הנחות נוספות.

טיפוסים בני מנייה (enum)
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

OfferCondition

[START offer_condition_definition]

שדות
description	string

OfferDetails

[START offer_details_definition] Next tag: 15

שדות
offer_display_text	string טקסט המבצע שספק המבצע רוצה להציג ללקוחות בדף תוצאות החיפוש. חובה.
max_discount_value	Money ההנחה המקסימלית שאפשר לקבל. לדוגמה, 10% הנחה עד 400 ש"ח.
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] במבצעים של 1+1 או 50% הנחה שחלים על כל הארוחה (למשל, 1+1 על בופה, 1+1 על כל החשבון, 1+1 על תפריט קבוע), אפשר להגדיר את הערך הזה ל-50.
discount_value	Money ערך קבוע של ההנחה.
other_offer_detail_text	string טקסט חופשי לתיאור ההנחה. אם מציעים מבצעים ספציפיים של 1+1 (למשל: 1+1 על משקאות, מנה עיקרית + 1, 1+1 על פריטים נבחרים בתפריט), צריך לציין את הפרטים האלה כאן.

OfferMode

[START offer_mode_definition] מציין את השיטה או הערוץ שדרכם המשתמש יכול לנצל את המבצע.

טיפוסים בני מנייה (enum)
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] התג הבא: 11

שדות
combinable_with_other_offers	bool אם אפשר לשלב את המבצע הזה עם מבצעים אחרים. אם הערך הוא True, השותפים יכולים לציין עם אילו מבצעים אפשר לשלב את המבצע הזה. אם הגדרתם גם את combinable_offer_categories וגם את combinable_offer_ids, כל מבצע שתואם לאחד מהתנאים שלמעלה יהיה ניתן לשילוב.
combinable_offer_categories[]	OfferCategory רשימה של סוגי מבצעים שאפשר לשלב עם המבצע הזה. לדוגמה, יכול להיות שאפשר לשלב את המבצע הזה עם שוברים אחרים. אם combinable_with_other_offers מוגדר כ-true והשדה הזה לא מוגדר, כל הסוגים יהיו ניתנים לשילוב.
combinable_offer_ids[]	string רשימה של מזהי מבצעים שאפשר לשלב עם המבצע הזה. יכול להיות שחלק מהמבצעים ישולבו רק עם מזהי מבצעים ספציפיים אחרים (אפשר להתייחס אליהם כמבצעים ראשיים). אם הערך של המאפיין combinable_with_other_offers הוא true והשדה הזה לא מוגדר, אפשר לשלב את כל מזהי המבצעים.
inclusions[]	OfferCondition רשימת התנאים שצריך לעמוד בהם כדי שהמבצע יהיה תקף (למשל, משקאות לא אלכוהוליים, אוכל).
exclusions[]	OfferCondition רשימת התנאים שבעקבותיהם המבצע לא תקף (לדוגמה, בופה, מבצעים משולבים וקוקטיילים).
min_guest	int32 מספר האנשים המינימלי שנדרש כדי לממש את המבצע.
food_offer_restrictions	FoodOfferRestrictions הגבלות שספציפיות למבצעים על אוכל.
special_conditions[]	string תנאים מיוחדים של המבצע שחובה להציג למשתמש. דוגמאות: "תקף רק לתשלום ב[אזור]", "לא כולל תשלומים אונליין"

OfferSource

[START offer_source_definition]

טיפוסים בני מנייה (enum)
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

טיפוסים בני מנייה (enum)
OFFER_TAG_UNSPECIFIED	אין להשתמש בפידים בערך UNSPECIFIED או בערך ברירת המחדל של enum.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

שדות
items[]	PaymentInstrumentItem רשימה של אמצעי תשלום שאפשר להשתמש בהם כדי לממש את המבצע. חובה.
provider_name	string השם של ספק אמצעי התשלום. יכול להיות שותף בנקאי, שם של בנק וכו'. לדוגמה: אמריקן אקספרס,‏ HDFC,‏ ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

שדות
type	PaymentInstrumentType סוג אמצעי התשלום. חובה.
name	string שם הפריט של אמצעי התשלום, כמו שם כרטיס האשראי. לדוגמה: HDFC Infinia, ‏אמריקן אקספרס Platinum. חובה.

PaymentInstrumentType

[START payment_instrument_type_definition]

טיפוסים בני מנייה (enum)
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

יש אפשרות להירשם למינוי

[START subscription_definition]

שדות
name	string שם המינוי. חובה.
subscription_auto_added	bool אם המינוי מתווסף באופן אוטומטי כשמשתמש מממש את המבצע הזה
cost	Money עלות המינוי. חובה.
subscription_duration	Duration משך הזמן שבו המינוי תקף במחיר שצוין במאפיין subscription_cost. חובה.
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 תנאים והגבלות בנוסף לתנאים ולהגבלות העיקריים של השותף.