交易訊息總覽

交易訊息會將客房、價格和包裹相關資料傳送給 Google。 交易訊息主要分為兩種類型：

  1. 行程資料：定義 Room Bundle 和行程資料，包括：

    • 飯店價格和空房資訊：設定符合特定需求的行程最低價格。詳情請參閱更新價格的相關說明。你也可以將房間從目錄中移除。詳情請參閱「移除庫存」。

    • 房型套裝組合：設定包含實體房型和額外套裝服務的行程價格。詳情請參閱 Room Bundle。Google 會快取您的交易訊息內容，以便隨時顯示價格。在某些情況下，Google 會判定快取中的值不符合現況，因此可能會傳送額外的 <Query> 訊息 (在某些情況下，則是即時價格查詢) 來取得最新價格。這類資料經常變動。如要定義交易訊息的價格和可用性，請使用 <Result>。

  2. 房間和套件中繼資料：指定客房和套件的詳細資料，例如說明、相片和可住人數上限。這項資料不會經常變更。如要定義中繼資料交易訊息，請使用 <PropertyDataSet>。Google 會儲存這類中繼資料，方便您在定價訊息中參照，而不是在每個項目中加入客房和套件的重複資訊。詳情請參閱「定義 Room 和套件中繼資料」。

交易訊息的根元素為 <Transaction>。使用 <Transaction> 元素做為根元素的訊息需要至少一個子項元素。交易訊息可有任意數量的子元素，只要訊息總大小不得超過 100 MB。

如需回應 Google 要求的交易訊息範例，請參閱定價和 Room Inventory (交易) XML 參考資料。

提供模式

傳送交易訊息的類型和頻率取決於您傳送模式：

  • 針對提取傳送模式，您會在收到 Google 的 <Query> 時傳送交易訊息。
  • 針對「價格變更」傳送模式，您必須在收到並回應 <HintRequest> 和 <Query> 後傳送交易訊息。

詳情請參閱定價提供模式。

即時價格查詢

無論您的放送模式為何，Google 也可能會傳送「即時價格查詢」要求給您。這類查詢訊息會根據「目前」搜尋來尋找價格。如果您在指定時間範圍內 (通常是幾百毫秒) 內回應，廣告就有機會參與競價。此外，您的結果也更能符合客戶的需求，包括其國家/地區和裝置類型，以及指定的房客人數。詳情請參閱即時價格查詢。

郵件大小

您可以在單一交易訊息中納入任何資料更新組合，但每則訊息的大小限制為 100 MB。所有提取和提示要求的回應時間上限通常為 100 秒。逾時是 Google 可依要求調整的可設定欄位。如果是極大型訊息，Google 建議您將逾時設為 10 分鐘。

如要大幅縮減訊息大小，並可能避免訊息大小和逾時問題，請使用交易訊息預先定義會議室和套件中繼資料。您也可以將 Content-Encoding: gzip 加入郵件標頭，藉此將 GNU 壓縮的內容新增至郵件。