הודעה על מבצעים

סקירה כללית

הודעת המבצע מגדירה כללים לגבי שיעורי הנחה באמצעות התג 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.