הודעת קידום

סקירה כללית

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

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

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

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

הנחיות

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

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

פעולות

מחיקה
שימוש בפעולה delete ברכיב <Promotion> כדי למחוק סינגל את המבצע לפי המזהה שלו.
שכבת-על
אפשר להשתמש בפעולה overlay ברכיב <HotelPromotions> כדי להחליף את כל קידומי המכירות עבור נכס מסוים.
דלתה
אם לא תצוין פעולה, כל המבצעים יצוינו בתוך <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: איך מקבצים מבצעים

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

תיאור

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

פתרון

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

דוגמה

הדוגמה הזו ממחישה איך לערום סוגי מקבצים של base, second ו-any. עבור הנחה משולבת של 15%, 25%, 10%, מחיר כולל של 100 $הוא סכום $57.38 (100 × .85 × .75 × .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.