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

זמינות (Availability), תעריפים (Rates) ומלאי (Inventory) (‏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
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

על כל הודעת בקשה שמתקבלת, 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.