סקירה כללית
בהודעת המחיר (OTA_HotelRateAmountNotifRQ
) מוגדר מחיר ללילה
מחירי תפוסה לכל סוג חדר ותוכנית תמחור ותשלומים בתאריך ספציפי
טווחים. כחלק מהודעת התעריף, Google תומכת בתמחור מבוסס-תפוסה.
אפשרות לציין תעריפים שונים ללילה על סמך המספר המקסימלי
של הנוסעים המיועדים.
הקטעים הבאים כוללים הנחיות כלליות, דוגמאות בסיסיות והדרכות כדי להתחיל בהוספה ובעדכון של תעריפים דירוג ההודעה.
התנהגות של שיעור התאמה
כשמשתמשים מבקשים נוסעים ספציפיים, המחיר שמוצג להם תלוי האופן שבו אתם מגדירים מחירים בהודעת התעריף. בקטע הזה מוסבר איך בקשות המשתמשים מותאמות לתעריפים שלכם בהתאם למספר האורחים הבקשה, והתעריפים שאתם מגדירים.
עקרונות מרכזיים
תעריף שמוגדר למספר אורחים ספציפי חל על כל התפוסה בדרגה נמוכה יותר. אלא אם הוגדר אחרת.
בקשות לחדרים במקום שצוינו למעלה נחשבות כבקשות לא אפשריות.
התמחור מבוסס-התפוסה חל גם על תמחור לפי תאריך וגם על מודלים של תמחור מבוסס-זמן צפייה שמפורטים בהמשך. זה אומר שאפשר לציין שיעורי מס לכל אחד מהם נוכחות. אם לא קיים תעריף לחדרים ספציפיים, התעריף לחדר מספר האורחים הבא הוא מספר האורחים. אפשר גם להגדיר חיובים עבור אורחים נוספים וילדים שמשתמשים ב-
AdditionalGuestAmounts
אוExtraGuestCharges
שמכסה את הקיבולת שהוגדרה לחדר.
יתרונות ודוגמאות
- יעילות
למספר אורחים עם אותו סכום תעריף, לא צריך להגדיר מחיר לכל שהייה. כדי לפשט את ההודעות, אפשר להגדיר רק ערך התפוסה הגבוה ביותר שנתמך על ידי סוג החדר ותוכנית המחירים. המשתמשים יראו את התעריף הזה לכל מספר אורחים שקטן מהערך או שווה לו עם ערך מסוים.
דוגמה: המחירים של סוג חדר מסוים ותוכנית תמחור ותשלומים זהים תפוסה בין 1 ל-4. אפשר להשתמש בהודעה 'תעריף' כדי להגדיר תעריף אחד 4 אנשים. משתמשים שמחפשים תפוסה של חדר אחד, זוגי או משולש יראו את אותו שיעור. משתמשים שמחפשים 5 חדרים ומעלה לא יראו את התעריפים.
- בקרה
אתם יכולים לספק תעריפים שונים לחדרים חלופיים באופן מפורש. שלח תעריף שונה לכל ערך של תפוסה, אם רוצים יותר שליטה באופן שבו Google מתאימה את הבקשות לתעריפים לחדרים.
לדוגמה:אם הוגדרו תעריפים לחדרים 3 ו-1, לחדרים ליחידים בחיפושים יוצגו התעריף ליחידים, יוצג חיפוש של תפוסה כפולה. שיעור התפוסה המשולש, ומשתמשים שמחפשים 4 ומעלה לא יראו מחירים.
דוגמאות נוספות לתרחישים שונים שקשורים לתעריפים זמינים במאמר הדרכות.
רכיבים נדרשים ואופציונליים
חומר העזר בנושא XML מספקת תיאורים של הרכיבים הנדרשים והאופציונליים. לפרטים על למאפיינים ורכיבי צאצא, ראו רכיבי תעריפים מאפיינים.
תחביר וסכימות
משתמשים בתחביר של התעריפים לדוגמה, כשיוצרים את ההודעה 'דירוג', הפורמט הנכון הוא.
אפשר להשתמש בכלי XML של צד שלישי, כמו xmllint, כדי לאמת את הפידים את הסכימות שפורסמו לפני ששולחים אותן ל-Google. לגבי ההודעה 'תעריף' ראו סכימות של מודעות להזמנת חדרים.
מודלים של תמחור
תמחור לפי תאריך
זהו מודל התמחור הסטנדרטי שמשמש את רוב הנכסים. per-date
מודל התמחור מבוסס על הגדרת תעריפים שמסוכמים לפי תאריכי שהייה,
להגיע במחיר כולל. במודל הזה, כל המחירים שמופיעים ברכיב Rate
מפורשים כמחירים שחלים על טווח תאריכי השהייה שצוין ב-<StatusApplicationControl>
.
תמחור מבוסס-LOS
מודל התמחור שמבוסס על LOS (משך השהייה) מבוסס על תעריפים שהוגדרו שילוב של תאריך ההגעה ומשך השהייה. התעריפים שצוינו בקטע מודל התמחור שמבוסס על LOS הוא ליום. לדוגמה, אם שולחים סכום עמלה של 400 ש"ח עבור משך שהייה של 3, המחיר הכולל מחושב באופן הבא: 3x100$=300$.
אפשר להשתמש במודל התמחור מבוסס LOS על ידי ציון
RatePlanType="26"
ברכיבי StatusApplicationControl
. צריך גם
להגדיר מאפיינים RateTimeUnit
ו-UnitMultiplier
ברכיבי Rate
XML. כתוצאה מכך, כל המחירים ברכיב Rate
הרלוונטי יחולו על השהיות שמוגדרות לפי תאריכי ההגעה שצוינו ב-<StatusApplicationControl>
וערך זמן השהייה שצוין ב-UnitMultiplier
.
אפשר להשתמש גם במודלים של תמחור לפי תאריך וגם במודלים של תמחור שמבוססים על LOS, עם זאת, כל נכס צריך להשתמש במודל תמחור אחד בלבד. כשמטמיעים תמחור מבוסס LOS, חשוב לזכור את הנקודות הבאות:
- מחירים של משכי שהייה שונים לא משולבים כשמשתמשים לפי LOS תמחור. לדוגמה, שיעור LOS של 3 לא משולב עם LOS של 1 כדי לתמחר שיעור 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>
ולהחליף אותם בתעריפים חדשים. לדוגמה, אם ציינתם תעריפים מקומות 1 ו-2, אחרי שליחת עדכון שלOverlay
לגבי LOS 1, Google תסיר כל השיעורים הקודמים (גם LOS 1 וגם 2) ורק שיעור LOS 1 יישאר לאחר העדכון.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: איך משנים את המחיר לחדרים
תיאור
תעריפים ללילה הוגדרו בעבר רק לחדרים זוגיים (וגם רלוונטי לחדרים ליחידים), אבל עכשיו יש תעריף זול יותר ליחיד נוכחות.
פתרון
שולחים את תעריף התפוסה החדש באמצעות עדכון ברירת המחדל בהיקף Delta
. הערך החדש לא משפיע על שיעור התפוסה 2.
תרחיש 2: איך מחליפים את התעריפים לפי תפוסה בנכס מסוים
תיאור
בעבר הגדרת תעריפים לחדרים 1 עד 4, אבל עכשיו רק תפוסה 1 ו-2 תקינים.
פתרון
אפשר להחליף את כל תעריפי התפוסה בנכס נתון באמצעות NotifType="Overlay"
.
סוג החדר, תוכנית המחירים והתאריכים. בתרחיש הזה, הפעולה Overlay
מחירים מפורטים לתפוסה 1 ו-2.
תרחיש 3: איך מגדירים את אותו מחיר למספר תפוסה
תיאור
אפשר למכור תעריף לחדר מסוים לקבוצה עם פחות אנשים. כאן ניתן לפשט את ההודעות על ידי שליחת עדכון תעריף בלבד עבור מספר האורחים המקסימלי הרלוונטי.
פתרון
אם המחיר זהה למספר אנשים, צריך להגדיר את מספר התפוסה הגבוה ביותר. הערך שנתמך על ידי סוג החדר ותוכנית המחירים, ומופיע באופן אוטומטי משתמש בערך הזה למספר אורחים נמוך יותר. כלומר, אין צורך לחזור על הפעולה תעריף ללילה לנוסעים 1 עד 6 אם כולם זהים. פשוט הגדירו עכשיו 6.