קידום מכירות

אם יש לכם קצה עורפי שמספק פידים לכמה חשבונות, הערך הזה צריך להתאים לערך המאפיין ID שצוין ברכיב <RequestorID> של ההודעות <OTA_HotelRateAmountNotifRQ> ו-<OTA_HotelAvailNotifRQ> לאותו חשבון.

קידומי מכירות של נכס. כל מבצע חל על נכס אחד בלבד.

אם לא משתמשים ב-<Stacking>, כשיש כמה מבצעים שעומדים בדרישות, המערכת מחילה על ההזמנה את המבצע עם ההנחה הגבוהה ביותר.

אם מצוין ערך, הוא חייב להיות "overlay". כשהערך הוא "overlay", כל קידומי המכירות השמורים נמחקים לפני שמאוחסנים קידומי המכירות שצוינו בהודעה הנוכחית.

אם לא יצוין, כל מבצע שצוין בהודעה הנוכחית יהיה:

• Added (אם לאף אחד מהמבצעים השמורים אין את אותו id)
• Updated (אם למבצע ששמור יש את אותו id)
• Deleted (אם למבצע ששמור יש את אותו id והערך של המאפיין action של המבצע שצוין בהודעה הנוכחית הוא "delete")

קידום מכירות יחיד של נכס. הערה: אם לא מציינים את הערך של action="overlay" ואת הערך של <Promotion>, כל המבצעים בנכס יימחקו.

אם אתם צריכים להשתמש ביותר מ-99 מבצעים, תוכלו לפנות למנהל החשבונות הטכני (TAM).

אם מצוין ערך, הוא חייב להיות delete. אם לא צוין, והמערכת לא שמרה מבצע עם אותו id, המבצע הזה יישמר. אחרת, אם לא צוין פרמטר כזה ויש מבצע עם אותו id, המבצע הקיים יעודכן.

אם מציינים את delete, קידום המכירות ששמור עם אותו id יימחק. כשמשתמשים ב-delete, אין לכלול רכיבי צאצא ב-<Promotion>. בנוסף, אסור להשתמש ב-delete בשילוב עם <HotelPromotions action="overlay"/>.

התאריך או תאריך ושעה ההתחלה (לפי אזור הזמן של הנכס), כולל.

• התאריך או חותמת הזמן שצוינו ב-start חייבים להיות מוקדמים יותר מהתאריך או חותמת הזמן שצוינו ב-end (או זהים להם).
• אם לא מציינים את start, הטווח לא מוגבל מבחינת זמן ההתחלה.
• אם השדה start מאוכלס בתאריך 'YYYY-MM-DD', הוא מפורש בתור זמן 'YYYY-MM-DDT00:00:00'.

התאריך או תאריך ושעה הסיום (לפי אזור הזמן של הנכס), כולל.

• התאריך או מועד הזמן שצוינו ב-end חייבים להיות מאוחר יותר (או זהים) מהתאריך או מועד הזמן שצוינו ב-start.
• אם לא מציינים את end, הטווח לא מוגבל מבחינת שעת הסיום.
• אם הערך של end מסופק בתור תאריך 'YYYY-MM-DD', הוא מפורש בתור תאריך ושעה 'YYYY-MM-DDT23:59:59'.

הימים בשבוע שמותר להציג בטווח התאריכים. אם לא יצוין טווח תאריכים, כל הימים יהיו מותרים בטווח התאריכים. כל תו במחרוזת מציין יום. לדוגמה, הערך 'MTWHF' מציין שאפשר להשתמש בימים חול בטווח התאריכים.

התווים התקינים הם:

• M ליום שני
• T ליום שלישי
• W ליום רביעי
• H ליום חמישי
• F ליום שישי
• S ליום שבת
• U ליום ראשון

כל שילוב של תווים תקין.

סוגי הערכים החוקיים הם:

• מספר שלם: מספר הימים לפני תאריך הצ'ק אין. לדוגמה, הערך 30 מציין שהמבצע חל רק על הזמנות שמבוצעות לפחות 30 יום לפני תאריך הצ'ק-אין.
• משך זמן בפורמט ISO 8601 (ימים, שעות ודקות): מספר הימים (ולחלופין השעות או הדקות) לפני תאריך הצ'ק-אין. לדוגמה, הערך P30D מציין שהמבצע חל רק על הזמנות שמבוצעות לפחות 30 יום לפני תאריך הצ'ק-אין. כשהערך הוא P30DT6H, צריך להזמין עד השעה 18:00 ביום ה-30 לפני ההגעה.

סוגי הערכים החוקיים הם:

• מספר שלם: מספר הימים לפני תאריך הצ'ק אין. לדוגמה, הערך 30 מציין שהמבצע חל רק על הזמנות שמבוצעות עד 30 יום לפני תאריך הצ'ק-אין.
• משך זמן בפורמט ISO 8601 (ימים, שעות ודקות): מספר הימים (ולחלופין השעות או הדקות) לפני תאריך הצ'ק-אין. לדוגמה, הערך P30D מציין שהמבצע חל רק על הזמנות שמבוצעות עד 30 יום לפני תאריך הצ'ק-אין. כשהערך הוא P30DT6H, צריך לבצע את ההזמנה ב-18:00 או לאחר מכן ביום ה-30 לפני ההגעה.

הגדרת הגבלות על הערך המקסימלי שאפשר להגדיר לשיעור אחרי החלת המבצעים.

תמיד צריך לציין בקידומי מכירות את הערך <Discount> או <BestDailyDiscount>. לכן, כדי ליצור קידום מכירות שבו חל רק <Ceiling>, אפשר להגדיר <Discount> עם percentage של 0.

אם מגדירים את האפשרות של 'צבירה', אפשר להחיל כמה מבצעים עם <Ceiling> על שהייה אחת. ההנחה של כל קידום מכירות תוחל, ולאחר מכן תקרת ההנחה. בדוגמה הבאה מוסבר איך כל תקרה תורמת לחישוב של קידום המכירות הבא בסטאק.

דוגמה:

תמחור של לילה אחד, כאשר הערך של AmountBeforeTax הוא 100 ויש שתי שוברי הנחה:

1. מבצע עם סוג base של צבירה, fixed_amount של 25 ו-amount_per_night של 60
2. מבצע עם סוג second,‏ fixed_amount של 25 ותקרה של amount_per_night של 90

זהו סדר החישוב:

1. המבצע base מיושם קודם ומפחית את AmountBeforeTax ל-75, אבל לאחר מכן תקרת ההנחה מפחיתה אותו ל-60.
2. קידום המכירות second מפחית את המחיר של AmountBeforeTax מ-60 ל-35. הערך הזה נמוך מהמכסה של 90, ולכן המכסה השנייה לא חלה. התעריף הסופי הוא 35.

העובדה ש-60 היא תקרה כוללת מחמירה יותר לא רלוונטית, כי היא תקפה רק למבצע עצמו, ולא יכולה להיות תקרה אחת שכוללת את כל שכבות המבצעים.

הסכום המקסימלי שאפשר להגדיר לתעריף ללילה אחרי שההנחה חלה.

אם מצוין גם רכיב <Floor>, צריך להגדיר לו ערך שגדול מערך המאפיין amount_per_night ב-<Floor> או שווה לו.

הערך של amount_per_night חל על מיסים ועמלות כשהם כלולים בתעריף ללילה באמצעות AmountAfterTax, אבל לא על אלה שצוינו באמצעות TaxFeeInfo.

הגדרת הגבלות על הערך המינימלי שאפשר להגדיר לשיעור אחרי החלת המבצעים.

תמיד צריך לציין בקידומי מכירות את הערך <Discount> או <BestDailyDiscount>. לכן, כדי ליצור קידום מכירות שבו חל רק <Floor>, אפשר להגדיר <Discount> עם percentage של 0.

הלוגיקה של <Floor> עדיין חלה על ההנחות של <FreeNights>, גם אם הוחל על הלילה בחינם הנחה של 100%.

אם מגדירים את האפשרות של 'צבירה', אפשר להחיל כמה מבצעים עם <Floor> על שהייה אחת. ההנחה של כל קידום מכירות תוחל, ולאחר מכן מיד יילקח בחשבון הסף התחתון. הדוגמה הבאה ממחישה איך כל שלב תורם לחישוב של המבצע הבא בסטאק.

דוגמה:

תמחור של לילה אחד, כאשר הערך של AmountBeforeTax הוא 100 ויש שתי שוברי הנחה:

1. מבצע עם סוג base של צבירה, fixed_amount של 25 ו-amount_per_night של 90
2. קידום מכירות עם סוג second,‏ fixed_amount של 25 ו-amount_per_night של 60

זהו סדר החישוב:

1. המבצע base מיושם קודם ומפחית את AmountBeforeTax ל-75, אבל לאחר מכן הסכום עולה ל-90 בגלל סכום הסף.
2. קידום המכירות second מעניק הנחה על AmountBeforeTax מ-90 ל-65. הערך הזה גבוה מהקווים הבסיסיים של 60, ולכן לא חל הקו השני. התעריף הסופי הוא 65.

העובדה ש-90 היא סכום סף כולל מחמיר יותר לא רלוונטית, כי היא תקפה רק לקידום המכירות עצמו, ולא יכול להיות סכום סף אחד שחל על כל סט קידומי המכירות.

הסכום המינימלי שאפשר להגדיר לתעריף ללילה אחרי שההנחה חלה.

אם מצוין גם אלמנט <Ceiling>, צריך להגדיר לו ערך שקטן מערך המאפיין amount_per_night ב-<Ceiling> או שווה לו.

הערך של amount_per_night חל על מיסים ועמלות כשהם כלולים בתעריף ללילה באמצעות AmountAfterTax, אבל לא על אלה שצוינו באמצעות TaxFeeInfo.

טווח תאריכים שמציין מתי צריך לבצע צ'ק-אין כדי שהמבצע יחול. אין צורך ברכיב הזה אם אתם מוחקים קידום מכירות אחד או יותר.

יש גם תמיכה בפורמט YearlessDate.

• אם אחד מהשדות start או end הוא תאריך ללא שנה, צריך לאכלס את שניהם כתאריכים ללא שנה.
• טווחי תאריכים ללא ציון שנה לא יכולים לעבור את השנה החדשה. במקום זאת, צריך לייצג את הטווח בשני טווחי תאריכים סמוכים. לדוגמה, אפשר לייצג את הערך {"12-29", "01-05"} כ-{"12-29", "12-31"} וכ-{"01-01", "01-05"}.

הימים בשבוע שמותר להציג בטווח התאריכים. אם לא יצוין טווח תאריכים, כל הימים יהיו מותרים בטווח התאריכים. כל תו במחרוזת מציין יום. לדוגמה, הערך 'MTWHF' מציין שאפשר להשתמש בימים חול בטווח התאריכים.

התווים התקינים הם:

• M ליום שני
• T ליום שלישי
• W ליום רביעי
• H ליום חמישי
• F ליום שישי
• S ליום שבת
• U ליום ראשון

כל שילוב של תווים תקין.

טווח תאריכים שמציין מתי צריך לבצע את התשלום כדי שהמבצע יחול. אין צורך להשתמש ברכיב הזה אם רוצים למחוק קידום מכירות אחד או יותר.

יש גם תמיכה בפורמט YearlessDate.

• אם אחד מהשדות start או end הוא תאריך ללא שנה, צריך לאכלס את שניהם כתאריכים ללא שנה.
• טווחי תאריכים ללא ציון שנה לא יכולים לעבור את השנה החדשה. במקום זאת, צריך לייצג את הטווח בשני טווחי תאריכים סמוכים. לדוגמה, אפשר לייצג את הערך {"12-29", "01-05"} כ-{"12-29", "12-31"} וכ-{"01-01", "01-05"}.

הימים בשבוע שמותר להציג בטווח התאריכים. אם לא יצוין טווח תאריכים, כל הימים יהיו מותרים בטווח התאריכים. כל תו במחרוזת מציין יום. לדוגמה, הערך 'MTWHF' מציין שאפשר להשתמש בימים חול בטווח התאריכים.

התווים התקינים הם:

• M ליום שני
• T ליום שלישי
• W ליום רביעי
• H ליום חמישי
• F ליום שישי
• S ליום שבת
• U ליום ראשון

כל שילוב של תווים תקין.

צריך לציין בדיוק אחד מהערכים Discount או BestDailyDiscount.

מציין את ההנחה שתחול במסגרת המבצע הזה.

צריך לציין בדיוק אחד מהערכים הבאים: percentage,‏ percentage_of_base,‏ fixed_amount,‏ fixed_amount_per_night,‏ fixed_price או fixed_price_per_night.

ערך עשרוני מ-0 עד 100 שקובע את אחוז ההנחה. הוא חל על AmountAfterTax (או על AmountBeforeTax אם לא צוין AmountAfterTax).

דוגמאות:

• אם הערך של AmountAfterTax הוא 100 והערך של percentage הוא 20, אז

  שיעור קידום המכירות = AmountAfterTax * (1 - אחוז ההנחה)

  80.00 = 100 * (1 - 0.2)

• אם הערך של AmountBeforeTax הוא 100, הערך של percentage הוא 20 והערך של TaxFeeInfo הוא 10, אז

  שיעור המבצע = AmountBeforeTax * (1 - אחוז ההנחה) + מס

  90.00 = 100 * (1 - 0.2) + 10

צריך לציין בדיוק אחד מהערכים הבאים: percentage,‏ percentage_of_base,‏ fixed_amount,‏ fixed_amount_per_night,‏ fixed_price או fixed_price_per_night.

ערך עשרוני מ-0 עד 100 שמציין את אחוז ההנחה הבסיסית. בדומה ל-percentage, הוא חל על AmountAfterTax (או על AmountBeforeTax אם לא צוין AmountAfterTax).

בניגוד ל-percentage, ההנחה הזו תמיד מחושבת כאחוז מהתעריפים הבסיסיים, ללא קשר למבצעים קודמים שהוחלו ברצף.

דוגמה:

• נניח שיש לנו שני מבצעים שחלים ברצף על אירוח של לילה אחד במחיר 100 ש"ח. ההנחה הראשונה היא הנחה רגילה של 10%, והשנייה היא הנחה של 10% מהנחה בסיסית. במקרה כזה, המחיר המוזל יהיה 80 כי בשני המבצעים מקבלים הנחה של 10%. הערה: אם המבצע השני היה גם הוא הנחה רגילה באחוזים, המחיר המוזל יהיה 81 כי המבצע השני מאפשר הנחה של 10% מ-90.

צריך לציין בדיוק אחד מהערכים הבאים: percentage,‏ percentage_of_base,‏ fixed_amount,‏ fixed_amount_per_night,‏ fixed_price או fixed_price_per_night.

סכום קבוע שיש לחסר מסכום התעריפים ללילה של AmountAfterTax (או מסכום התעריפים ללילה של AmountBeforeTax, אם לא צוין AmountAfterTax). ההנחה היא שהיא תהיה באותו המטבע של המחירים ללילה. אם הערך הזה גדול מסכום התעריפים היומיים, הערך שיתקבל יהיה אפס.

דוגמאות:

• אם אנחנו מחשבים את המחיר של שהייה של לילה אחד, כאשר AmountBeforeTax הוא 90, ‏ AmountAfterTax הוא 100 ו-fixed_amount הוא 20, אז

  התעריף במסגרת קידום המכירות = AmountAfterTax - הנחה קבועה

  80.00 = 100 - 20

• אם אנחנו מחשבים את המחיר של שהייה של לילה אחד, כאשר הערך של AmountBeforeTax הוא 100, הערך של fixed_amount הוא 20 והערך של TaxFeeInfo הוא 8%, אז

  שיעור המבצע = (AmountBeforeTax - הנחה קבועה) * (1 + שיעור המס באחוזים)

  86.40 = (100 - 20) * 1.08

• אם אנחנו מחשבים את המחיר של שהייה ללילה אחד, כאשר הערך של AmountBeforeTax הוא 50, הערך של fixed_amount הוא 60 והערך של TaxFeeInfo הוא 10, אז

  שיעור קידום מכירות = (AmountBeforeTax - הנחה קבועה) * מס

  10.00 = 0 + 10

• אם אנחנו מחשבים את המחיר של שהייה של 3 לילות, כאשר הערכים של AmountAfterTax הם 100,‏ 110 ו-120, ו-fixed_amount הוא 150, אז

  promotion rate = sum(AmountAfterTax) - (fixed discount)

  180.00 = (100 + 110 + 120) - 150

צריך לציין בדיוק אחד מהערכים הבאים: percentage,‏ percentage_of_base,‏ fixed_amount,‏ fixed_amount_per_night,‏ fixed_price או fixed_price_per_night.

הנחה קבועה שחלה על כל אחד מ-AmountAfterTax המחירים ללילה (או על N המחירים הזולים ביותר, אם צוין applied_nights). אם לא מציינים את AmountAfterTax, הוא יחול על AmountBeforeTax. ההנחה היא שהיא תהיה באותו המטבע של המחירים ללילה. אם הערך של fixed_amount_per_night גדול מהמחיר ללילה, הערך של המחיר ללילה מופחת לאפס – ההנחה לא יכולה לגרום למחיר ללילה להיות שלילי.

דוגמאות:

• אם אנחנו מחשבים את המחיר של שהייה של 3 לילות, כאשר הערכים של AmountAfterTax הם 100,‏ 110 ו-120, והערך של fixed_amount_per_night הוא 10, אז

  שיעור קידום המכירות = sum(AmountBeforeTax - fixed amount discount)

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• אם אנחנו מחשבים את המחיר של שהייה של 3 לילות, כאשר הערכים של AmountAfterTax הם 10,‏ 50 ו-100, והערך של fixed_amount_per_night הוא 20, אז

  שיעור קידום המכירות = sum(AmountAfterTax - fixed amount discount)

  110.00 = (0 + (50 - 20) + (100 - 20))

צריך לציין בדיוק אחד מהערכים הבאים: percentage,‏ percentage_of_base,‏ fixed_amount,‏ fixed_amount_per_night,‏ fixed_price או fixed_price_per_night.

אם מציינים AmountAfterTax תעריפים ללילה, המחיר של השהייה, כולל מיסים ועמלות, מוגדר לערך שצוין. אם מציינים את AmountBeforeTax, גם אם מציינים את AmountAfterTax וגם אם לא, המחיר לפני מס של השהייה מוגדר לערך שצוין. ההנחה היא שהיא תהיה באותו המטבע של המחירים ללילה.

אם AmountAfterTax מיועד לשקף מס בשיעור מסוים, הגדרת מחיר קבוע ל-AmountBeforeTax עלולה לגרום למיסים ולעמלות לא מדויקים. באופן כללי, מומלץ מאוד להשתמש ב-TaxFeeInfo כדי לציין את המיסים והעמלות של הנכס.

דוגמאות:

• אם אנחנו מחשבים את המחיר של שהייה של לילה אחד, כאשר הערך של AmountBeforeTax הוא 90, הערך של AmountAfterTax הוא 100 והערך של fixed_price הוא 80, אז מחיר המבצע הוא 80.
• אם אנחנו מחשבים את המחיר של שהייה של לילה אחד, כאשר הערך של AmountBeforeTax הוא 100, הערך של fixed_amount הוא 80 והערך של TaxFeeInfo הוא 8%, אז

  שיעור המבצע = מחיר קבוע * (1 + שיעור המס באחוזים)

  86.40 = 80 * 1.08

• אם אנחנו מחשבים את המחיר של שהייה של 3 לילות, כאשר הערכים של AmountAfterTax הם 100,‏ 110 ו-120, ו-fixed_amount הוא 300, אז

  שיעור המבצע = 300

צריך לציין בדיוק אחד מהערכים הבאים: percentage,‏ percentage_of_base,‏ fixed_amount,‏ fixed_amount_per_night,‏ fixed_price או fixed_price_per_night.

אם מציינים AmountAfterTax תעריפים ללילה, הערך שצוין מוגדר בתור המחיר לכל לילה של השהייה, כולל מיסים ועמלות. אם מציינים את AmountBeforeTax, גם אם מציינים את AmountAfterTax וגם אם לא, המחיר לפני מס לכל לילה של שהייה מוגדר לערך שצוין. ההנחה היא שהמחיר הוא באותו מטבע שבו מוצגים המחירים ללילה.

אם AmountAfterTax מיועד לשקף מס בשיעור מסוים, הגדרת מחיר קבוע ל-AmountBeforeTax עלולה לגרום למיסים ולעמלות לא מדויקים. באופן כללי, מומלץ מאוד להשתמש ב-TaxFeeInfo כדי לציין את המיסים והעמלות של הנכס.

אם applied_nights מצוין, המחיר החדש יחול על N הלילות הזולים ביותר.

דוגמאות:

• אם אנחנו מחשבים את המחיר של שהייה של 2 לילות, כאשר הערכים של AmountBeforeTax הם 90,‏ 90, הערכים של AmountAfterTax הם 100,‏ 100 והערך של fixed_price הוא 80, אז שיעור המבצע הוא 80 + 80 = 160.
• אם אנחנו מחשבים את המחיר של שהייה של 2 לילות, כאשר הערך של AmountBeforeTax הוא 100, 100, הערך של fixed_amount הוא 80, ו-TaxFeeInfo מציין מס של 8%, שיעור המבצע הוא (80 + 80) * 1.08 = 172.8.
• אם אנחנו מגדירים מחיר לשהייה של 3 לילות, כאשר הערכים של AmountAfterTax הם 100,‏ 110 ו-120, ו-fixed_amount הוא 110, אז המחיר המוזל במסגרת המבצע הוא 110 * 3 = 330.

יש להשתמש באפשרות הזו רק עם percentage או fixed_amount_per_night.

מספר הלילות שעליהם חלה ההנחה, החל מהלילה הזול ביותר. הערך צריך להיות מספר שלם בין 1 ל-99. אם לא יצוין מספר, ההנחה תחול על כל הלילות.

מספר הלילות הנדרשים כדי שההנחה תחול. כל הנחה חלה על פלח נפרד של לילות שהאורחים שוהים בהם.

לדוגמה, עבור שהייה של 10 לילות שבה הערך של stay_nights הוא 4 (ו-repeats הוא true), יש שני קטעים של לילות שהייה: הלילות מ-1 עד 4 והלילות מ-5 עד 8. הלילות 9 ו-10 לא נכללים בקטע של לילות שהייה.

אם ניתן להחיל את ההנחה על כמה פלחים של לילות שהייה. אם false, אז רק החלק של לילות השהייה בתחילת מסלול הנסיעה יהיה בהנחה. אם true, כל מקטע של לילות שהייה מקבל הנחה.

לדוגמה, אם הערך של stay_nights הוא 4 והמסלול כולל 10 לילות, אם הערך של repeats הוא true, אז 2 קטעים מקבלים הנחה (לילות 1-4 ולילות 5-8). לעומת זאת, אם הערך של repeats הוא false, אז רק קטע אחד מקבל הנחה (לילות 1-4).

צריך לציין בדיוק אחד מהערכים Discount או BestDailyDiscount.

מציין הנחה יומית שאפשר להחיל על לילה של שהייה. זאת בניגוד ל-Discount, שבו ההנחות חלות על כל השהיות.

לכל נכס יכולה להיות קבוצה אחת של מבצעים שנחשבים ל'המבצעים הטובים ביותר היומיים'. כלומר, לכל לילה של השהות, המערכת תבחור את המבצע היומי הטוב ביותר שעומד בדרישות ומעניק את ההנחה הגבוהה ביותר ללילה הזה, ותוכל להחיל אותו.

אפשר לציין את Stacking באמצעות BestDailyDiscount. הערך חייב להיות base או none. ההנחות 'הטובות ביותר ליום' שמניבות את ההנחה הגבוהה ביותר לכל לילה משולבות ומטופלות כהנחה אחת על השהייה (כלומר Discount), תוך שמירה על סוג הערימה שהוגדר. ההנחה המשולבת הזו תוצג לצד מבצעים אחרים של <Discount> שעומדים בדרישות, וניתן לשלב ביניהם כדי למצוא את המבצע או השילוב שמעניקים את ההנחה הגבוהה ביותר. המערכת בוחרת את השילוב של BestDailyDiscount או את הערך היחיד של Discount, שמניב את המחיר הנמוך ביותר, ומחילה אותו על סוג הערימה base.

אפשר לציין את StayDates עם סוג ההנחה הזה, אבל צריך להגדיר את application לערך overlap

צריך לציין בדיוק אחד מהערכים percentage,‏ fixed_amount או fixed_price.

ערך עשרוני מ-0 עד 100 שקובע את אחוז ההנחה. הוא חל על AmountAfterTax (או על AmountBeforeTax אם לא צוין AmountAfterTax).

דוגמאות:

• אם AmountAfterTax ללילה של שהייה הוא 100 ו-percentage הוא 20, אז

  שיעור קידום המכירות = AmountAfterTax * (1 - אחוז ההנחה)

  80.00 = 100 * (1 - 0.2)

• אם הערך של AmountBeforeTax ללילה של שהייה הוא 100,‏ percentage הוא 20 ו-TaxFeeInfo מציין מס של 10, אז

  שיעור המבצע = AmountBeforeTax * (1 - אחוז ההנחה) + מס

  90.00 = 100 * (1 - 0.2) + 10

צריך לציין בדיוק אחד מהערכים percentage,‏ fixed_amount או fixed_price.

סכום קבוע שיש לחסר ממחיר ללילה אחד של AmountAfterTax (או ממחיר ללילה אחד של AmountBeforeTax אם לא צוין AmountAfterTax). ההנחה היא שהיא תהיה באותו המטבע של המחירים ללילה. אם הערך הזה גדול מסכום התעריפים היומיים, הערך שיתקבל יהיה אפס.

דוגמאות:

• אם הערך של AmountBeforeTax ללילה אחד הוא 90, הערך של AmountAfterTax הוא 100 והערך של fixed_amount הוא 20, אז

  התעריף במסגרת קידום המכירות = AmountAfterTax - הנחה קבועה

  80.00 = 100 - 20

• אם הערך של AmountBeforeTax ללילה אחד הוא 100,‏ fixed_amount הוא 20 ו-TaxFeeInfo מציין מס של 8%, אז

  שיעור המבצע = (AmountBeforeTax - הנחה קבועה) * (1 + שיעור המס באחוזים)

  86.40 = (100 - 20) * 1.08

צריך לציין בדיוק אחד מהערכים percentage,‏ fixed_amount או fixed_price.

אם מציינים AmountAfterTax תעריפים ללילה, הפונקציה מגדירה את המחיר ללילה השהייה, כולל מיסים ועמלות, לערך שצוין. אם מציינים את AmountBeforeTax, גם אם מציינים את AmountAfterTax וגם אם לא, המחיר לפני מס של השהייה מוגדר לערך שצוין. ההנחה היא שהיא תהיה באותו המטבע של המחירים ללילה.

דוגמאות:

• אם AmountBeforeTax ללילה אחד הוא 90,‏ AmountAfterTax הוא 100 ו-fixed_price הוא 80, שיעור ההנחה הוא 80.
• אם הערך של AmountBeforeTax ללילה אחד הוא 100, הערך של fixed_amount הוא 80 והערך של TaxFeeInfo הוא 8%, אז

  שיעור המבצע = מחיר קבוע * (1 + שיעור המס באחוזים)

  86.40 = 80 * 1.08

קונטיינר לכלל של תמחור למנויים שמפעיל טיפול ספציפי בממשק המשתמש של ההנחה המשויכת.

אין לציין את האלמנט הזה אלא אם <Discount> צוין גם כן.

המזהה של כלל התמחור שמשויך לתוכנית החברים.

אפשר להחיל כמה מבצעים על שיעור אחד, בהתאם להגדרה הזו:

• any: אפשר לשלב אותו עם כל מבצע אחר (למעט none), אבל אין ערובה לסדר שבו המבצעים יחולו.
• base: המבצע הטוב ביותר של base שעומד בדרישות נבחר ומוחל קודם, לפני מבצעים אחרים. השם הקודם של השדה הזה היה base_only.
• second: מבצע second המתאים ביותר שנמצא מתאים נבחר ומוחיל אחרי מבצע base (אם רלוונטי) ולפני מבצעי any.
• none: לא ניתן לשלב אותו עם מבצעים אחרים.

מבין השילובים המותרים, מערכת Google Ads מחילה על התעריף את קבוצת המבצעים שמניבה את ההנחה הגדולה ביותר.

תיאור האופן שבו צריך להחיל את המבצע.

הערכים החוקיים כוללים:

• all: המבצע יחול על כל לילה בתוכנית הנסיעה אם כל התאריכים בתוכנית הנסיעה חופפים לתאריכי השהייה.
• any: המבצע יחול על כל הלילות במסלול אם יש תאריך במסלול שחופף לתאריך בטווח התאריכים של השהייה.
• overlap: המבצע יחול רק על הלילות במסלול הנסיעה שחופפים לתאריך בטווח התאריכים של השהייה.

תמיד צריך לציין את המאפיין הזה.

• אם <Discount> מציין את הערך percentage ו-application מוגדר לערך all או any, ההנחה מחושבת כאחוז מהשהייה המלאה.
• אם <Discount> מציין את הערך percentage ו-application מוגדר לערך overlap, ההנחה חלה כאחוז מהתעריפים ללילה עבור לילות חופפים.
• השילוב <Discount> עם הערך fixed_amount והערך application שמוגדר כ-overlap הוא שילוב לא חוקי.
• <FreeNights> תומך בכל הערכים של application. הערה: בשדה overlap, רק לילות חופפים נלקחים בחשבון לצורך הדרישות להנחה.

טווח תאריכים שבו מצוינים התאריכים שבהם המבצע יוחל.

יש גם תמיכה בפורמט YearlessDate.

• אם אחד מהשדות start או end הוא תאריך ללא שנה, צריך לאכלס את שניהם כתאריכים ללא שנה.
• טווחי תאריכים ללא ציון שנה לא יכולים לעבור את השנה החדשה. במקום זאת, צריך לייצג את הטווח בשני טווחי תאריכים סמוכים. לדוגמה, אפשר לייצג את הערך {"12-29", "01-05"} כ-{"12-29", "12-31"} וכ-{"01-01", "01-05"}.

אם רוצים להגדיר את טווח הערכים של StayDates כדי לאפשר את קידום המכירות בימים ספציפיים בשבוע, צריך להגדיר את התאריך start כתאריך הנוכחי ללא end כדי שתוקף קידום המכירות לא יפוג.

צריך לציין את הערך של start אם לא צוין הערך של end.

צריך לציין את הערך של end אם לא צוין הערך של start.

הימים בשבוע שמותר להציג בטווח התאריכים. אם לא יצוין טווח תאריכים, כל הימים יהיו מותרים בטווח התאריכים. כל תו במחרוזת מציין יום. לדוגמה, הערך 'MTWHF' מציין שאפשר להשתמש בימים חול בטווח התאריכים.

התווים התקינים הם:

• M ליום שני
• T ליום שלישי
• W ליום רביעי
• H ליום חמישי
• F ליום שישי
• S ליום שבת
• U ליום ראשון

כל שילוב של תווים תקין.

הערכים החוקיים הם include ו-exclude.

אם השדה UserCountries type מוגדר בתור include, המבצע חל על משתמשים מהמדינות שצוינו.

אם הערך של UserCountries type הוא exclude, הקידום חל על משתמשים מחוץ למדינות שמפורטות.

אם לא מגדירים את השדה UserCountries‏ type, המערכת מתייחסת אליו בתור include והקידום המכירות יחול על משתמשים מהמדינות שצוינו.

השדה <Success> או השדה <Issues> נמצאים בכל הודעה.

השדה <Success> או השדה <Issues> נמצאים בכל הודעה.

סוג הבעיה.

הערכים החוקיים הם warning,‏ error ו-failure.