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

Availability, Rates, and Inventory (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.

Live on Google (LoG)

התכונה Live on 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.