放送模式會決定您如何將飯店和行程組合的價格更新內容傳送給 Google。在初始設定期間,您和客戶技術顧問 (TAM) 會共同設定提交模式。
提交模式總覽
根據預設,飯店可查詢的房間可訂天數上限為 330 天,入住天數上限為 30 晚,但您可以決定行程的數量上限 (入住日期和入住天數的組合)。
您支援的行程越多,參與的競價就越多。不過,您支援的路線越多,必須傳送給 Google 的資料就越多,才能確保價格資料準確無誤。
更新價格的常用方法會以下列任一方式使用交易訊息:
ARI (推送):價格提交動態饋給,可利用費率方案、可預訂房數和飯店中繼資料,為房源設定預先定義的價格策略。與提取和價格變更不同,ARI 動態饋給不會查詢特定價格或行程。相反地,您可以推送訊息,其中包含代表房源定價模式的子集資訊,這些資訊是根據各種費率詳細資料、限制和供應情形而定。ARI 動態饋給會使用 OTA XML 規格 (
OTA_HotelRateAmountNotifRQ
和OTA_HotelAvailNotifRQ
) 定義供應情形和價格。請與客戶經理聯絡,進一步瞭解 ARI 放送模式,並判斷這類動態饋給是否最適合您的帳戶。詳情請參閱「使用 ARI」。提取:Google 會定期查詢你的服務,以更新價格和供應情形資料的快取。在這個模型中,Google 會向您的伺服器傳送要求,而您的伺服器會回覆更新的資料。如果您不確定價格資訊會在何時異動,或是價格資訊在一天中會不規則地變動,就最適合使用這個模式。價格會保留在快取中,直到 Google 演算法根據合作夥伴先前的價格變更記錄,判斷價格已過時為止。詳情請參閱「使用拉取提交模式」。
價格變更 (先前稱為「提取提示」):與「提取」模式類似,但 Google 只會要求部分房源的資料,而非所有房源。在更新房源的價格和供應情形時,這個模式可大幅減少網路流量。價格會無限期保留在快取中,直到更新為止。詳情請參閱「使用價格異動功能」。
除了更新價格,你還可以使用交易訊息,從廣告空間中移除房源。詳情請參閱「移除廣告空間」。
如要進一步瞭解如何提供價格更新資訊 (包括交易訊息範例),請參閱「更新價格」。
即時價格查詢
Google 也可以在競價期間使用即時價格查詢要求更新部分價格。即時價格查詢是 Google 針對目前競價的價格要求。如果您在指定時間內回覆,廣告就會顯示在競價中。
Google 會儲存對即時價格查詢的回應,就像儲存任何其他交易訊息一樣。因此,Google 日後可以從快取中提供價格,而非傳送另一個即時價格查詢。
詳情請參閱「即時定價查詢」。
背景資訊
由於 Google 會使用您的回覆填入快取,而快取可能會用於為各種不同使用者提供服務,因此「拉取」和「價格異動」查詢通常不會指定使用者相關資訊。
由於傳回與整組可能使用者情境相對應的價格可能會耗費大量金錢,因此我們正在測試一項功能,在查詢中指定熱門使用者情境。使用者背景資訊是根據您有顯示價格機會的使用者要求,並計算出涵蓋絕大多數使用者要求的資訊。您可能會看到大量使用者背景,這些背景來自非常熱門的房源或行程,但使用者背景的平均數量應少於 10 個。您可以傳回額外價格或忽略指定的使用者背景資訊,這取決於您要為特定查詢傳回哪些價格。不過,忽略建議的使用者情境可能會導致流量降低。
ARI Push 放送模式
使用 ARI Push 放送模式時,只要每晚房價、供應情形、空房數量或其他限制有變動,就會向 Google 傳送增量更新。與提取或價格變更機制不同,ARI 推送可讓你使用不同的價格模式,有效率地將價格資訊的各個元件更新至 Google。
下圖顯示 ARI Push 提交模式的要求和回應流程:
步驟 1:將 ARI Push 訊息傳送至 Google
如要透過 ARI Push 更新資料,請在資料變更時傳送 ARI 要求訊息。ARI Push 放送模式支援各種訊息類型和定價策略。如要進一步瞭解推送訊息,請參閱「使用 ARI」一文。
Google 應會在收到訊息後的 15 到 20 分鐘內放送你的價格,讓使用者看到。
步驟 2:確認 Google 已成功快取資料
對於收到的每則 ARI Push 訊息,Google 會回應 HTTP 連線狀態和 ARI 處理結果。如果連線至伺服器成功,Google 會回傳 HTTP 200 OK
。它還包含本體,其中包含回應訊息,指出更新是否已成功套用,或是否遇到提交模式警告或錯誤。
IP 位址許可清單
如要將用來將 ARI 訊息推送至 Google 的所有 IP 位址加入許可清單,請使用 Hotel Center ARI 價格設定頁面。瞭解如何在 Hotel Center 中更新價格設定。
使用 ARI Push 更新 Room 和套件中繼資料
使用交易 (資源資料) 訊息類型定義每個房源的有效房型和費率方案 (套裝方案)。每當你新增、移除或修改房型或費率方案時,都應推送更新。在這種情況下,您會傳送 XML 訊息,並在 <RoomData>
和 <PackageData>
元素中加入新資訊。這些元素是 <PropertyDataSet>
元素的子項。
連線或內容錯誤
如果您因 XML 格式不正確或不正確而收到提交模式錯誤,請參閱「動態饋給狀態錯誤訊息」一文,瞭解建議的解決方法。
如果您在傳送 ARI 訊息給 Google 時收到 HTTP 連線錯誤,請以 1、5 和 20 分鐘的間隔重試要求。如果在重試 3 次後問題仍未解決,請停止傳送訊息,並與 Google 支援團隊聯絡。
提取傳送模式
在提取提交模式下,Google 會定期傳送查詢訊息至您的伺服器,要求更新價格。伺服器會回應這些訊息,並提供包含更新後價格和供應情形資料的交易訊息。
下圖顯示 Pull 的要求/回應流程:
收到價格更新後,Google 通常會在約 5 分鐘內處理新的價格和供應情形資料。
以下各節將詳細說明這些步驟。
步驟 1:查詢訊息
根據預設,Google 會針對飯店清單中定義的所有房源傳送查詢訊息。這可能表示你應該在重新定價程序期間收到多則查詢訊息。
Google 傳送至伺服器的定價查詢訊息具有下列特性:
- 根元素為
<Query>
。 - 傳送至初始設定期間定義的端點。如需更多資訊,請與技術客戶經理 (TAM) 聯絡。
- 使用 HTTP
POST
方法。(如果您使用 HTTPS,則需要取得由官方憑證授權單位簽署的網域)。 Content-Type
標頭設為application/xml
。- 每則訊息最多包含 100 個房源,Google 會針對這些房源要求價格和供應情形資料。
User-Agent
標頭設為Google-HotelAdsPrices
。
步驟 2:交易訊息
伺服器收到查詢訊息時,必須回覆交易訊息,其中包含所要求行程的價格資訊。
交易訊息的根元素為 <Transaction>
。詳情請參閱「交易訊息」和「更新價格」。
更新 Room 和套件中繼資料
除了使用 Pull 更新價格資料,你也可以使用交易訊息更新房型和套裝行程中繼資料。詳情請參閱「定義房間和套件中繼資料」。
變更定價放送模式
變更價格有助於減少價格更新的查詢和交易訊息大小和數量。使用「價格變更」功能時,你會將已更新價格的房源清單傳送給 Google。Google 會回應查詢訊息,只要求這些房源的價格。
如要設定 Google 傳送提示要求訊息的端點,請洽詢您的技術帳戶經理 (TAM)。您應該會在初始設定期間設定這項資訊。
下圖顯示價格變更要求的請求和回應流程:
以下各節將說明這個流程中的每個步驟。
步驟 1:Hint 要求訊息
Google 傳送至伺服器的提示要求訊息具有下列特徵:
- 根元素為
<HintRequest>
。 - 傳送至初始設定期間定義的端點。如需更多資訊,請與技術客戶經理 (TAM) 聯絡。
- 請使用 HTTP
POST
方法。(如果您使用 HTTPS,就必須取得由官方憑證授權單位簽署的網域)。 Content-Type
標頭設為application/xml
。- Google 會以指定的頻率,將時間戳記傳送至您的伺服器,定義您上次回覆提示要求訊息的時間。
User-Agent
標頭設為Google-HotelAdsPrices
。
建議您將頻率設為 5 分鐘。如要設定或修改提示要求訊息的頻率,請與我們聯絡。
收到 Google 的提示要求訊息後,請回覆自該時間戳記更新至今的所有價格。詳情請參閱提示要求訊息。
步驟 2:Hint 回應訊息
您的伺服器會以 Hint 回應訊息回應提示要求訊息。此訊息包含飯店 ID 和行程,這些飯店的價格自您上次收到並回覆提示要求訊息後有所變動。
Hint 回應訊息的根元素為 <Hint>
。詳情請參閱「提示回應訊息」。
步驟 3:查詢訊息
Google 會收到提示回應訊息,並以查詢訊息回應,就像標準的提取模式一樣。差異在於,查詢訊息現在只包含您在提示回應訊息中指定的飯店物業 ID 和行程。查詢訊息的根元素為 <Query>
。
在決定要使用「變更的價格」要求哪些飯店房源價格時,Google 會忽略飯店清單動態饋給的內容。這樣一來,您從 Google 收到的查詢訊息大小和回應的交易訊息大小就會大幅縮減。
步驟 4:交易訊息
您傳送含有價格更新資訊的交易訊息,回應 Google 的查詢訊息。交易訊息的根元素為 <Transaction>
。詳情請參閱「拉取提交模式」。