הודעת קידום

סקירה כללית

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

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

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

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

הנחיות

בקטע הזה מפורטות ההנחיות הנפוצות וההוראות המיוחדות להגדרת מבצעים.

הנחיות לשימוש במבצעים:

פעולות

מחיקה
משתמשים בפעולה delete ברכיב <Promotion> כדי למחוק מבצע יחיד באמצעות המזהה שלו.
שכבת-על
משתמשים בפעולה overlay ברכיב <HotelPromotions> כדי להחליף את כל המבצעים של נכס מסוים.
Delta
אם לא מציינים פעולה, כל המבצעים שצוינו ב-<HotelPromotions> מתווספים או מוחלפים. אם מבצע עם המזהה הזה לא נוסף אף פעם או נמחק, המבצע יתווסף. אם קיים מבצע עם המזהה הזה, הוא יוחלף בהגדרה החדשה.

כללי

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

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

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

  • כל מבצע קשור לנכס ספציפי. אם אתם משתמשים באותו מבצע בכמה נכסים, אתם צריכים לשלוח אותו בנפרד לכל נכס. כדי לציין את מזהה הנכס, משתמשים במאפיין hotel_id של הרכיב <HotelPromotions>.

  • אפשר לכלול עד 99 מבצעים. אם אתם צריכים לכלול יותר מזה, פנו למנהל החשבון הטכני שלכם ב-Google.

  • משתמשים באלמנט <Stacking> כדי לציין איך אפשר לשלב מבצעים. כברירת מחדל, Google משתמשת בbaseסוג הערימה, כלומר המבצע הבסיסי הכי טוב שזכאי להשתתף נבחר ומוחל ראשון, לפני מבצעים אחרים. הערה: אפשר לשלב את base רק עם second או any, ולא עם base או none אחרים.

  • גם אם יש כמה מבצעים שאפשר לשלב ביניהם, יכול להיות שהמערכת לא תשתמש בשילוב הזה אם יש מבצע יחיד או שילוב של מבצעים אחרים שמציעים הנחה גדולה יותר. המבצע (המשולב) עם ההנחה הגדולה ביותר יחול על ההזמנה אם יש כמה מבצעים (משולבים) שעומדים בדרישות.

  • שליחת עדכון של הודעת מבצע בכל פעם שמתבצעים שינויים שמשפיעים על המבצעים.

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

דוגמה

בקטע הזה מופיעה דוגמה בסיסית להודעת מבצעים שכוללת רכיבים נדרשים ואופציונליים. אחרי שמכינים את הקובץ, שולחים אותו ל-Google באמצעות הודעת POST לנקודת הקצה הזו:

https://www.google.com/travel/hotels/uploads/promotions

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

במאפיין hotel_id של <HotelPromotions>, משתמשים במזהה המלון הייחודי שבו השתמשתם במערכת שלכם כדי לזהות את הנכס. הערך הזה צריך להיות זהה למזהה המלון שצוין באמצעות <id> ברכיב <listing> בפיד רשימת המלונות. חשוב מאוד שהנתונים יהיו עקביים עם הנתונים במערכת שלכם, כדי לוודא ש-Google מציגה את הנתונים בצורה נכונה.

UserCountry משמש לציון המיקומים (מדינות) שבהם המשתמשים יכולים ליהנות מהמבצע. אם מציינים מדינות, רק משתמשים במדינות שמופיעות ברשימה יקבלו את התעריף המוזל.

בדוגמה הזו מוצג איך מגדירים הנחה של 15% על שהייה ממושכת למשתמשים בארצות הברית ובאיטליה:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

דוגמאות נוספות מופיעות במאמר דוגמאות למבצעים.

מדריכים

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

תרחיש 1: איך מוסיפים מבצע הנחה על שהייה ממושכת

תיאור

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

פתרון

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

דוגמה

בדוגמה הזו אפשר לראות איך להוסיף הנחה של 20% על שני לילות על כל 7 לילות שהייה בטווח התאריכים שצוין להזמנה. במסלול נסיעה של 15 לילות, ההנחה של 20% חלה על 4 לילות.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

תרחיש 2: איך מגדירים סוגי מכשירים

מגדירים את devices כדי לציין את מכשירי המשתמשים שעומדים בדרישות למימוש המבצע. אם מציינים מכשירים, רק משתמשים במכשירים שמופיעים ברשימה יוכלו ליהנות מהתעריף המוזל.

תיאור

אתם רוצים לציין איזה סוג של מכשיר משתמש עומד בדרישות למימוש המבצע.

פתרון

מגדירים את סוג המכשיר לאחד או יותר מהערכים הבאים: desktop, tablet או mobile.

דוגמה

בדוגמה הבאה אפשר לראות איך מציינים הנחה של 25% למשתמשים בנייד ובטאבלט:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

תרחיש 3: איך להחליף מבצעים ישנים במבצעים חדשים

תיאור

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

פתרון

משתמשים בפעולה overlay כדי להחליף את המבצעים.

דוגמה

בדוגמה הבאה מוצגים שני הנחות המקוריות של 20% ו-30% על הנכס.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

בדוגמה הזו אפשר לראות איך משתמשים ב-overlay כדי להחליף את שתי המבצעים הקיימים במבצע אחד של 15% הנחה על השהייה במלון.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

תרחיש 4: איך מסירים מבצע אחד או את כל המבצעים

תיאור

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

פתרון

משתמשים בפעולה delete אם רוצים למחוק רק מבצעים ספציפיים בנכס, ובפעולה overlay (ולא delete) אם רוצים להסיר את כל המבצעים הקיימים בלי להחליף אותם.

פרטים על החלפת מבצעים באמצעות overlay מופיעים בתרחיש 3.

דוגמאות

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

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

בדוגמה הזו אנחנו מראים איך להסיר את כל המבצעים בלי להחליף אותם בנכס:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

תרחיש 5: איך משלבים מבצעים

הערך stacking מציין איך אפשר לשלב מבצעים. אם לא מציינים ערך, המערכת מניחה שהערך הוא type base, כלומר המבצע הכי טוב שזכאי להשתתף נבחר ומוחל ראשון, לפני מבצעים אחרים. כשמאפיין type של Stacking הוא any, אפשר לשלב אותו עם כל מבצע אחר.

תיאור

אתם רוצים שהמשתמש יוכל להשתמש בכמה מבצעים בו-זמנית באותו נכס.

פתרון

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

דוגמה

בדוגמה הזו אפשר לראות איך להשתמש בסוגי הראש הגלילי base, second ו-any. אם יש הנחה משולבת של 15%, 25% ו-10%, מחיר של 100 $יהיה 57.38$ (100 × 0 .85 × 0 .75 × 0 .9).

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

שימו לב שההנחה המשולבת של מבצעים 1 עד 3 עדיפה על ההנחה של מבצע 4. אי אפשר לשלב את מבצע 4 עם מבצעים אחרים בגלל סוג השילוב שלו (none). אם מבצע 4 היה כולל הנחה של 43% ומעלה, הוא היה מוצג במקום השילוב של מבצעים 1 עד 3.