סקירה כללית על ARI

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

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

יתרונות

אלה היתרונות של ARI:

  • יעילות רוחב הפס: הגדלת היעילות של רוחב הפס על ידי הפחתת נפח הנתונים שצריך להעביר. שליחת נתוני ARI מדי לילה ושינויים מצטברים בלבד מאפשרת ל-Google לחשב מחירים ועדכונים למגוון רחב של ערכים של רכישה מראש ומשך השהייה.

  • דיוק מחירים: כדי לשפר את דיוק המחירים, המערכת משתמשת במודל של אירועי push-on-change כדי לספק עדכונים בזמן אמת.

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

  • גמישות: מאפשרת גמישות רבה יותר בהצעת מבצעים וחבילות.

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

סוגי הודעות הבקשה

הודעות ARI שנשלחות ל-Google נקראות 'בקשות' של ARI. לאחר מכן, Google מחזירה הודעות 'תגובה' שמציינות הצלחה או כישלון.

ARI פועל לפי הפרוטוקולים הרגילים של OpenTravel Alliance (OTA) לגבי חלק מסוגי ההודעות העיקריים להגדרת הזמינות והמלאי.

ב-ARI נעשה שימוש בהודעות הבקשה הבאות:

  • Transaction (נתוני נכס). הגדרת סוג החדר ופרטי החבילה (תוכנית התמחור).

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

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

  • OTA_HotelInvCountNotifRQ. הגדרת מלאי החדרים הפיזיים או מספר החדרים שזמינים למכירה.

  • TaxFeeInfo. (אופציונלי) הגדרת מיסים ועמלות לכל נכס. לא צריך לשלוח את ההודעה הזו אם השדה AmountAfterTax צוין בהודעה OTA_HotelRateAmountNotifRQ.

  • Promotions. (אופציונלי) הגדרת מחירים מוזלים להזמנות, לשהיות ולמשתמשים מסוימים.

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

  • ExtraGuestCharges. (אופציונלי) מגדיר את אופן ההגדרה של התעריפים לילדים ולמבוגרים נוספים.

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

מידע נוסף על ARI זמין במאמר חומר עזר בנושא XML.

שליחת הודעות Push

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

כששולחים הודעות, מומלץ לפעול לפי ההנחיות הבאות:

  • אתם יכולים להשתמש בכלי השירות העצמאי בדף 'הגדרות מחיר' ב-Hotel Center כדי להוסיף או לעדכן את כתובות ה-IP במערכת שלנו.

  • משתמשים בנתיב הבסיס הבא לנקודת הקצה:

    • https://www.google.com או Host: www.google.com Port: 443

  • שולחים הודעות באמצעות השיטה HTTP POST.

  • מגדירים את הכותרת Content-Type לערך application/xml.

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

  • יש להשתמש בנתיבים הבאים בהתאם לנתונים שמתעדכנים:

    • Transaction (נתוני נכס): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: ‏/travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: ‏/travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: ‏/travel/hotels/uploads/taxes
    • Promotions: ‏/travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • /travel/hotels/uploads/extra_guest_charges:ExtraGuestCharges

לכל הודעת בקשה שהתקבלה, Google תגיב עם HTTP 200 OK אם החיבור לשרת הצליח, ותכלול גוף עם הודעת תגובה שמציינת אם העדכונים הוחלו בהצלחה או אם נתקלו באזהרות או בשגיאות. אם Google תגיב עם קוד שגיאה של HTTP, צריך לשלוח שוב את ההודעה. אם גוף התגובה של HTTP מכיל אזהרות או שגיאות, צריך לתקן אותן לפני ששולחים מחדש את ההודעה. אפשר גם לראות את הבעיות שנתקלת בהן בהודעות ספציפיות בדף 'סטטוס הפיד' ב-Hotel Center.

'זמין ב-Google' (LoG)

התכונה 'באינטרנט ב-Google' (LoG) מאפשרת לכם להציג את המלונות שלכם באתרי Google. מאחר שערך ברירת המחדל של LoG למלון הוא true, כל מלון חדש יוצג ב-Google באופן אוטומטי.

באמצעות LoG תוכלו להפעיל או להשבית את הנכסים שלכם לצורך הצגת מודעות וקישורים ללא עלות לביצוע הזמנות בחשבון Hotel Center, ללא קשר לסטטוס ב-Google Ads או אם יש למלון תעריפים ב-Google.

יש שתי דרכים להגדיר את ערך LoG של מלון: Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

פרטים נוספים על LoG זמינים במרכז העזרה של Hotel Center.

שימוש ב-Travel Partner API, you can do the following:

  • אפשר לראות את הסטטוס של הנכסים דרך Hotel Center או באמצעות נקודת הקצה hotelViews.list.

  • כדי לאחזר רשימה של כל המלונות שמוצגים ב-Google, משתמשים בפרמטר filter עם הערך liveOnGoogle = TRUE בנקודת הקצה hotelViews.list.

  • כדי לקבל סיכום של הנכסים בחשבון ספציפי, כולל מספר הנכסים שפעילים ב-Google, משתמשים ב-hotelViews.summary.

למידע נוסף על הגדרת LoG באמצעות ה-API, אפשר לעיין במאמר hotelViews.list ובחומר העזר בנושא API.