הודעת קידום

סקירה כללית

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

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

התיאור

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

פתרון

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