نمای کلی ARI

«دردسترس بودن، نرخ‌ها، و موجودی» (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 تنظیم کنید.

  • حداکثر نرخ به‌روزرسانی در سطح حساب ۴۰۰ پیام در ثانیه است. اگر از این حد مجاز فراتر بروید، کد خطای 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 حاوی هشدار یا خطا باشد، باید قبل‌از ارسال مجدد پیام برطرف شود. همچنین می‌توانید مشکلات مربوط به پیام‌های خاص را در صفحه «وضعیت فید» در مرکز هتل مشاهده کنید.

نمایان در Google (LoG)

«فعال در Google» به شما امکان می‌دهد هتل‌هایتان را در وب‌سایت‌های Google نمایش دهید. ازآنجایی‌که مقدار پیش‌فرض «سطح جزئیات» برای هتل true است، هر هتل جدیدی به‌طور خودکار در Google نمایش داده خواهد شد.

از LoG برای روشن و خاموش کردن دارایی‌هایتان برای آگهی‌ها و پیوندهای رزرو رایگان در حساب «مرکز هتل» خود استفاده کنید، صرف‌نظر از وضعیت 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.

برای جزئیات بیشتر درباره «لوگو»، به راهنمای Hotel Center مراجعه کنید.

استفاده از Travel Partner API, you can do the following:

  • وضعیت دارایی‌هایتان را ازطریق «مرکز هتل» مشاهده کنید یا از نقطه پایانی hotelViews.list استفاده کنید.

  • بااستفاده از پارامتر filter با liveOnGoogle = TRUE در نقطه پایانی hotelViews.list، فهرستی از همه هتل‌هایتان را که در Google نمایش داده می‌شود بازیابی کنید.

  • بااستفاده از hotelViews.summary، خلاصه‌ای از دارایی‌های یک حساب خاص، ازجمله تعداد دارایی‌های فعال در Google، دریافت کنید.

برای کسب اطلاعات بیشتر درباره نحوه تنظیم LoG بااستفاده از API، به hotelViews.list مقاله و مرجع API مراجعه کنید.