定價總覽

飯店價格是指指定行程的雙人房最低價格，行程包含入住日期和入住晚數。

總覽

你為飯店或行程組合定義的價格，是飯店搜尋結果的關鍵。請務必確保價格最新、準確且具競爭力。

Google 通常會使用價格快取中的價格顯示搜尋結果。每當您傳送含有價格更新的交易訊息給 Google 時，Google 就會快取該資料。

Google 也會即時向您索取飯店廣告帳戶的最新價格。當使用者搜尋特定飯店或行程組合時，Google 會傳送「即時」要求或即時價格查詢訊息。如果在指定時間範圍內回覆，該價格就會顯示在使用者要求行程的結果中。Google 也會快取即時價格查詢的結果，以便用於日後的要求。

價格更新大小

設定房價時，請提供預訂提前期和入住天數 (LoS) 值，以及這些值和房價 ID 或費率方案 ID 的每種組合價格。預訂和 LoS 值預設為下列值：

  • 最多可提前 330 天預訂
  • 最多可入住 30 晚

根據這些一般規範，單一房型的價格最多可能需要 9,900 個獨立項目 (330 * 30)，每個項目對應入住日期和晚數的組合。

下表顯示單一飯店的部分行程資料。矩陣中每個含有價格的儲存格，都代表入住日期和入住天數的其中一種行程組合；每個行程代表 Google 為該房源要求提供的個別值：

重新定價的飯店和行程

Google 價格的飯店是由飯店清單定義。除非停用，否則系統會使用交易訊息或即時價格查詢 (視情況而定)，重新計算飯店清單動態饋給中所有飯店的價格。

更新價格

更新價格的一般程序如下：

  1. 您可以在初始設定期間，於飯店清單中定義要定價的飯店，然後在清單變更時定期更新。

  2. 僅限價格變更：Google 會傳送提示要求訊息給伺服器。

  3. 僅限價格變更：伺服器會傳送提示回應訊息，定義應重新定價的飯店或行程組合。

  4. Google 會將查詢訊息傳送至伺服器。查詢訊息包含 Google 需要價格的飯店 ID 和行程。

  5. 如果是即時價格查詢，Google 會指定時間限制，你必須在時限內回應，飯店或行程才會顯示在目前的競價中。

  6. 伺服器會傳回定義新價格的交易訊息。

  7. Google 會使用交易訊息中的價格資料更新快取。

如要進一步瞭解「提取」和「價格異動」模式，請參閱「傳送模式」。

交易訊息的定價

如要為飯店或行程 (入住日期加上住宿天數的組合) 設定價格，請使用交易訊息，每個行程各使用一個 <Result>。

設定價格時，請遵守下列規定：

  • 房價：為每個行程提供最低的雙人入住房價。如果使用 Hotel Prices API 設定的房價與網站上顯示的房價不同，可能會造成使用者困惑，導致預訂量減少。

  • 入住晚數：為每個行程指定住宿總價，以及每晚房價。Google 會為你計算每晚房價。

  • 政策：設定費率時，請遵守 Google 的價格準確度政策。這項規定要求 Google 搜尋結果中顯示的價格，與最終預訂價格不得有顯著差異。

  • 全包式價格：如要向美國和加拿大的使用者顯示飯店資訊，飯店通常必須將稅金和相關費用與基本費率分開。詳情請參閱《稅金與相關費用政策》。

  • 四捨五入：價格、稅金和費用值不得四捨五入。

如要瞭解如何從空房庫存中移除飯店，請參閱「移除空房庫存」。

價格訊息

使用交易訊息重新定價行程時，<Result> 的下列子元素為必填：

  • <Property>
  • <Baserate>
  • <Tax>
  • <OtherFees>
  • <Checkin> (行程)
  • <Nights> (行程)

您可以optionally在交易訊息中加入 <Result> 的下列子項元素：

  • <AllowablePointsOfSale>
  • <ChargeCurrency>
  • <Custom[1-5]>
  • <RoomBundle>
  • <RoomID>

如要進一步瞭解這些元素，請參閱 <Transaction>。

計費示例

以下範例會為 6 月 7 日入住的客房 (預設為雙人房) 設定 1 至 7 晚的價格：

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">209.99</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">419.98</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">614.97</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>4</Nights>
    <Baserate currency="USD">819.96</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>5</Nights>
    <Baserate currency="USD">999.95</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>6</Nights>
    <Baserate currency="USD">1193.94</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>7</Nights>
    <Baserate currency="USD">1259.93</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
</Transaction>

每則交易訊息可包含任意數量的 <Result> 元素，只要訊息總大小不超過 100 MB 即可。

價格更新頻率

建議您盡可能在價格變動時更新。具體做法取決於你選擇的價格資訊更新方式是「提取」還是「變更價格」。詳情請參閱選擇運送方式。

Google 傳送即時價格查詢的頻率和次數也可設定。詳情請參閱「即時定價查詢」。

全包式價格

視使用者的地理位置而定，你或許可以考慮使用全包式定價，而非細項定價。

全包式價格包括房價基本價值，以及交易訊息 <Baserate> 元素中的稅金和費用。Itemized 定價會將價格分成 <Baserate>、<Taxes> 和 <OtherFees> 元素。