ARI 總覽

供應情形、費率和廣告空間 (ARI) 是一種價格放送模式,可控制每晚的房價、供應情形和空房數量,並限制兩者的組合方式。ARI 也提供稅金、費用和促銷活動等彈性設定。

與以行程為基礎的定價提交模式、提取和價格變更方式不同,ARI 動態饋給不會查詢特定價格或行程。因此,請在定價模式有新的資料或變更資料時 (例如費率詳細資料、限制和可用性的變更) 推送訊息。

優點

ARI 具有下列優點:

  • 頻寬效率:減少需要傳輸的資料量,以提升頻寬效率。Google 會透過傳送夜間 ARI 資料且只傳送漸進式的變更,以便計算各種提前購買和入住天數的值,並計算相關價格與更新資訊。

  • 價格準確度:使用推送變更事件模型來提供即時更新,提高價格準確度。

  • 更高的價格涵蓋範圍:使用精細的資料結合各種行程,達到更高的價格涵蓋範圍 (包含價格的行程數量)。

  • 靈活性:對提供促銷活動和套件進行更靈活的選擇。

  • 簡單易用:以與資料儲存在系統中的方式傳輸資料,因此不必計算或快取多個行程的價格。

要求訊息類型

傳送給 Google 的 ARI 訊息統稱為 ARI「要求」訊息。之後 Google 就會傳回表示成功或失敗的「回應」訊息。

ARI 遵循 OpenTravel Alliance (OTA) 的部分主要訊息類型標準通訊協定,用於定義可用性和庫存。

<OTA_HotelRateAmountNotifRQ>

ARI 會使用下列要求訊息:

  • Transaction (資源資料): 定義房型和套裝行程 (費率方案) 資訊。

  • OTA_HotelRateAmountNotifRQ:定義特定日期範圍內各產品 (客房類型與房價方案的組合) 以日期或 LOS 為準的入住人數。

  • OTA_HotelAvailNotifRQ: 根據房型和房價方案定義供應情形和限制。 您也可以使用這則訊息更新庫存,但建議使用 OTA_HotelInvCountNotifRQ

  • OTA_HotelInvCountNotifRQ,定義實體房間庫存或可銷售的客房數量。

  • TaxFeeInfo (選用):定義每個房源的稅金與費用。如果 OTA_HotelRateAmountNotifRQ 訊息中指定 AmountAfterTax,則不需要這則訊息。

  • Promotions. (選用) 定義特定預訂、住宿和使用者的促銷費率。

  • RateModifications. (選用) 定義特定預訂、住宿和使用者的費率修改規則。

  • ExtraGuestCharges (選用) 定義如何為兒童和其他成人設定費率。

每則訊息都包含部分資訊。當使用者搜尋房源時,Google 會使用特定資訊的入住和退房日期,以及所需的可住人數,計算顯示的價格和空房資訊。

如要進一步瞭解 ARI,請參閱 XML 參考資料

推送訊息

如要更新 ARI 和屬性資訊,每當系統中的資料有變更時,就傳送相關訊息。

傳送訊息時,請遵守下列規範:

  • 請使用 Hotel Center 價格設定頁面的自助式工具,在系統中新增或更新 IP 位址。

  • 使用下列端點基本路徑:

    • https://www.google.comHost: 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 上。

無論 Google Ads 的狀態為何或房源在 Google 上是否顯示房價,在 Hotel Center 帳戶中,你可以使用 LoG 開啟或關閉房源的廣告和免費的預訂連結。這僅適用於飯店,不適用於度假民宿

你可以透過下列兩種方式設定飯店的 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 端點,查看房源狀態。

  • hotelViews.list 端點中使用 filter 參數搭配 liveOnGoogle = TRUE,擷取 Google 上顯示的所有飯店清單。

  • 使用 hotelViews.summary 取得特定帳戶的房源摘要,包括 Google 上顯示的房源數量。

如要進一步瞭解如何使用 API 設定 LoG,請參閱 hotelViews.list 文章API 參考資料