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

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

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

יתרונות

ל-ARI יש את היתרונות הבאים:

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

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

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

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

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

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

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

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

פרוטוקול ARI משתמש בהודעות הבקשה הבאות:

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

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

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

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

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

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

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

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

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

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

הודעות בדחיפה

כדי לעדכן את פרטי ה-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' מאפשרת להציג את המלונות שלכם באתרים של 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.