דירוג ההודעה

סקירה כללית

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

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

התנהגות של שיעור ההתאמה

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

עקרונות מרכזיים

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

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

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

יתרונות ודוגמאות

יעילות

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

לדוגמה: התעריפים לסוג חדר ולמחירון זהים לחדרים 1 עד 4. משתמשים בהודעה 'תעריף' כדי להגדיר תעריף אחד ל-4 נוסעים. משתמשים שיחפשו חדרים ליחידים, זוגיים או משולשים יראו את אותו שיעור. משתמשים שמחפשים 5 ומעלה לא יראו תעריפים.

בקרה

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

דוגמה: אם מוגדרים תעריפים למספר אורחים 3 ולמספר 1, בחיפושים של אדם אחד יוצג התעריף ליחידים, בחיפוש של תפוסה משולשת יוצג שיעור התפוסה המשולש, ומשתמשים שמחפשים 4 ומעלה לא יראו תעריפים.

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

רכיבים נדרשים ואופציונליים

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

תחביר וסכימות

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

אפשר להשתמש בכלי XML של צד שלישי, כמו xmllint, כדי לאמת את הפידים עם הסכימות שפורסמו, לפני ששולחים אותם ל-Google. למידע על סכימת ההודעות של התעריפים, ראו סכימות של מודעות להזמנת חדרים.

מודלים של תמחור

תמחור לפי תאריך

זהו מודל התמחור הסטנדרטי המשמש ברוב הנכסים. מודל התמחור per-date מבוסס על תעריפי הגדרה, שמסכמים לפי תאריכי השהייה ומתקבלים במחיר כולל. במודל הזה, כל התעריפים ברכיב Rate מפורשים כחלים על טווח של תאריכי שהייה שצוין ב-<StatusApplicationControl>.

תמחור מבוסס LOS

מודל התמחור לפי LOS (משך השהייה) מבוסס על תעריפים שהוגדרו לשילוב של תאריך הגעה ומשך השהייה. התעריפים המפורטים במודל התמחור המבוסס על LOS הם ליום. לדוגמה, במקרה ששולחים תעריף של 100$ עבור משך שהייה של 3, המחיר הכולל יחושב כ-3x400 ש"ח=1,200 ש"ח.

כדי להשתמש במודל התמחור שמבוסס על LOS, צריך לציין את הערך RatePlanType="26" ברכיבי StatusApplicationControl. צריך להגדיר גם את המאפיינים RateTimeUnit ו-UnitMultiplier ברכיבי Rate ב-XML. כתוצאה מכך, כל התעריפים ברכיב Rate הנתון יחולו על השהיות שמוגדרות על ידי תאריכי ההגעה שצוינו ב-<StatusApplicationControl> וערך ה-LOS שצוין ב-UnitMultiplier.

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

  • כאשר משתמשים בתמחור על בסיס LOS, אין שילוב של התעריפים למשכי שהייה שונים. לדוגמה, אי אפשר לשלב שיעור LOS של 3 עם ה-LOS כדי לתמחר את הערך 4. יש לציין במפורש את שיעור ה-LOS שעומד על 4.
  • תעריף ללילה אחד בתמחור לפי LOS לא משמש כתעריף ללילה אחד בתמחור לפי תאריך.
  • לכל נכס צריך להיות תמחור שמבוסס על LOS או תמחור לפי תאריך, בהתאם לאופן שבו התעריפים מיוצגים במערכת.

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

הנחיות או פעולות

תמחור לפי תאריך

Delta: אפשר להוסיף או לעדכן את התעריפים לחדרים רק עבור השילובים שצוינו של סוג חדר, תוכנית מחירים ותאריכי שהייה שצוינו ב-<StatusApplicationControl>.

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

Overlay: מוחקים את כל התעריפים הקיימים לחדרים עבור סוג החדר, תוכנית התעריפים והתאריכים שצוינו ב-<StatusApplicationControl> ומחליפים אותם בתעריפים חדשים. לדוגמה, אם הגדרתם תעריפים לחדרים ליחידים ולחדרים זוגיים ואתם שולחים עדכון של Overlay לחדרים ליחידים, Google תסיר את כל התעריפים הקודמים (גם לחדרים ליחידים וגם לחדרים זוגיים) ורק התעריף לחדר אחד יישאר אחרי העדכון.

Remove: מחיקת כל התעריפים הקיימים לחדרים עבור סוג החדר, תוכנית התעריפים והתאריכים שצוינו ב-<StatusApplicationControl>.

תמחור מבוסס LOS

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

  • במסגרת העדכונים במחירים, המערכת משתמשת בפעולה Delta כברירת מחדל.
  • העדכון של Delta לא משנה תעריפים שאוחסנו בעבר במשכי שהייה אחרים. לדוגמה, אם ציינתם את תעריפי LOS 1 ו-2 ואתם שולחים עדכון של תעריפי Delta ל-LOS 1, התעריפים לחדרים של LOS 2 יישארו ללא שינוי.
  • עדכון של Delta יחליף את כל התעריפים לחדרים שאוחסנו קודם לכן למשך השהייה הנתון. לדוגמה, אם ציינתם תעריפים לחדרים ליחידים או זוגיים ב-LOS 1, ושולחים עדכון של Delta ל-LOS 1 עם רק תעריף אחד לחדר אחד, שיעור התפוסה הכפול יוסר.

Overlay: מוחקים את כל התעריפים הקיימים לחדרים עבור רמת LOS, סוג החדר, תוכנית התעריפים ותאריכי הצ'ק-אין שצוינו ב-<StatusApplicationControl> ומחליפים אותם בתעריפים חדשים. לדוגמה, במקרה שציינתם תעריפים של LOS 1 ו-2, ואתם שולחים עדכון Overlay ל-LOS 1, Google תסיר את כל התעריפים הקודמים (1 ו-2 בלבד), ורק התעריף הקודם יישאר אחרי העדכון.

Remove: מחיקת כל התעריפים הקיימים לחדרים לכל ה-LOS של סוג החדר, תוכנית התעריפים ותאריכי הצ'ק-אין שצוינו ב-<StatusApplicationControl>.

קשור למס

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

באופן כללי, Google ממליצה להשתמש ב-TaxFeeInfo ולא ב-AmountAfterTax.

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

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

דוגמה

בקטע הזה מובאת דוגמה בסיסית להודעת דירוג באמצעות רכיבים נדרשים ואופציונליים. אחרי שמכינים את הקובץ, צריך לשלוח אותו ל-Google באמצעות הודעת POST לנקודת הקצה הבאה: https://www.google.com/travel/hotels/uploads/property_data

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

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

בדוגמה הזו מוסבר איך להגדיר תעריפים באמצעות פעולת Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

הדרכות

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

דוגמאות לתעריפים, כולל דוגמאות להוספה, להסרה ולעדכון של תעריפים.

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

תיאור

תעריפים ללילה הוגדרו בעבר רק לחדרים זוגיים (שחל גם על חדרים ליחידים), אבל עכשיו יש תעריף זול יותר לחדרים ליחידים.

פתרון

שולחים את התעריף החדש של תפוסה 1 באמצעות עדכון ברירת המחדל בהיקף Delta. הערך החדש הזה לא משפיע על תעריף התפוסה 2.

תרחיש 2: איך להחליף את התעריפים לפי אורחים בנכס

תיאור

בעבר הגדרתם תעריפים לחדרים 1 עד 4, אבל עכשיו אפשר להזין רק את מספר האורחים 1 ו-2.

פתרון

בעזרת NotifType="Overlay" אפשר להחליף את כל תעריפי התפוסה בנכס מסוים, בסוג החדר, בתוכנית המחירים ובתאריכים. בתרחיש הזה, בפעולה Overlay יוצגו התעריפים לחדרים 1 ו-2.

תרחיש 3: איך להגדיר את אותו תעריף למספר תפוסה

תיאור

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

פתרון

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