評分訊息

總覽

「費率」訊息 (OTA_HotelRateAmountNotifRQ) 定義每晚房價 各房型和房價方案組合在特定日期的入座率 範圍。在「費率」訊息中，Google 支援以入住人數為依據的定價， 允許根據上限指定不同的每晚房價 體現了目標住民的可能性

以下各節將說明一般規範、基本範例和操作說明情境，協助您開始新增及更新費率，以及傳送費率訊息。

媒合率行為

當使用者要求特定人數時，他們看到的比率將取決於 如何定義「費率」訊息中的價格本節將說明 系統會根據使用者當下的可住人數，判斷使用者請求是否符合您的費率 和您定義的費率

重要原則

  • 除非另有定義，否則為特定住宿人數定義的房價會套用至所有較少住宿人數。

  • 如有超過上述人數的申請，我們會視為無法執行。

  • 根據入住人數和以 LOS 為基礎的定價，均適用以入住人數為準 計費模式，如下所述。也就是說，您可以為各個 活動情形。如果沒有特定入住人數的費率，則 會使用次高的可住人數。您也可以定義 使用「AdditionalGuestAmounts」的額外訪客和兒童 或 ExtraGuestCharges 但不超過對會議室定義的容量

優點和範例

提高效率

如果是費率金額相同的多種可住人數，您不需要 每個入住人數的費率如果想要簡化訊息內容， 房型和房價方案支援的最高可住人數值。 系統會根據你的設定，向不同入住人數顯示該費率 值。

範例：房型和房價方案的房價相同 總共 1 到 4 位請使用「費率」訊息，設定一個 可住人數為 4 人。使用者搜尋單人、雙人和三人房 就會看到相同費率搜尋 5 歲以上的使用者不會看到費率。

控管

你可以明確提供其他可住人數的不一致費率。傳送 為不同入住人數設定不同費率，即可進一步控管 Google 會將要求與入住率進行比對。

範例：如果已針對可住人數 3 和 1 定義房價，則單一可住人數 搜尋會顯示單人房價 可住人數為三倍，搜尋 4 歲以上的使用者不會看到 費率。

如需更多各種費率相關情境的範例，請參閱 操作說明。

必要和選用元素

XML 參考資料 提供必要和選用元素的說明。如要進一步瞭解屬性和子元素，請參閱「評分元素和屬性」。

語法和結構定義

請使用費率語法 建立「費率」訊息時 您使用了正確的格式。

您可以使用 xmllint 等第三方 XML 工具，使用 已公開的結構定義，再提交給 Google針對費率訊息 結構定義，請參閱「飯店廣告架構」一文。

計費模式

按日期計費

這是多數資源採用的標準定價模式。per-date 定價模式是以設定費率為依據，且系統會加總不同入住日期的費率 並以總價計費在這個模型中，系統會將 Rate 元素下的所有費率解讀為適用於 <StatusApplicationControl> 中指定的住宿日期範圍。

以 LOS 為基礎的定價

LOS 型 (入住天數) 定價模式是以 抵達日期與入住天數的組合。費率 以 LOS 為基礎的定價模式是以天為單位。舉例來說，如果您傳送的房價為 $100 美元，而住宿天數為 3，則總價的計算方式為 3 x $100 美元 = $300 美元。

如要採用以 LOS 為基礎的定價模式，請指定 StatusApplicationControl 元素的 RatePlanType="26"。您也需要 請在應用程式的 Rate 元素上設定 RateTimeUnit 和 UnitMultiplier 屬性 XML這會導致系統套用指定 Rate 元素下的所有費率 定義依據為 <StatusApplicationControl> 中指定的抵達時間，且 為 UnitMultiplier 指定的 LOS 值。

您可以在單一計費模式中使用「以日期為準」和「以 LOS 為基礎的定價」模式。 不過，每個資源只能採用一個定價模式。 實作以 LOS 為基礎的定價時，請記住以下要點：

  • 採用 LOS 時，系統不會合併不同入住天數的費率 。舉例來說，如果 LOS 費率為 3，就不會與 LOS 的 LOS 合併計算。 1 的情況下，應將 LOS 費率設為 4。必須明確指定 LOS 速率 (4) 。
  • 系統不會使用以 LOS 為依據的 1 晚費率做為個別每晚房價 以按日計價
  • 每項房源只能使用以 LOS 為基礎的價格或按日期計算 價格取決於系統表示費率的方式。

如要為帳戶啟用以 LOS 為基礎的定價，請透過您的 TAM 提出申請 或與我們聯絡。

指南或動作

按日期計費

Delta：僅為指定的指定人數新增或更新每人入住費率 指定房型、房價方案和住宿日期的組合 <StatusApplicationControl>。

  • 費率更新預設會使用 Delta 動作。
  • Delta 更新不會變更先前儲存任何其他費率的費率 使用人數舉例來說，如果您為單一 並傳送 Delta 則房價更新資訊。 可住人數，則雙人入住費率維持不變。

Overlay：刪除所選房型所有現有的每人入住費率。 房價方案和 <StatusApplicationControl> 中指定的日期，然後替換 並提供新的費率舉例來說，如果您已指定單人和雙人房的房價，並傳送單人房的 Overlay 更新，Google 會移除所有先前的房價 (單人和雙人房皆是如此)，更新後只會保留單人房的房價。

Remove：刪除所選房型所有現有的每人入住費率。 <StatusApplicationControl>中指定的房價方案和日期。

以 LOS 為基礎的定價

Delta：僅針對指定的每個 LOS 值新增或更新費率 <StatusApplicationControl>。取代與更新後的 LOS 值相關聯的所有每人入住率。

  • 費率更新預設會使用 Delta 動作。
  • Delta 更新不會變更先前儲存任何其他費率的費率 入住天數舉例來說，如果您指定 LOS 1 和 2 的費率 並傳送 Delta 費率更新 LOS 1，然後傳送 LOS 2 的每人入住費率 都維持不變。
  • Delta 更新會覆寫所有先前儲存的每人入住費率 指定的入住天數舉例來說，如果您指定單一廣告活動 並將 LOS 1 的雙人入住費率傳送給 LOS 1，並傳送 Delta 費率更新 如果只有單一住人數，系統會移除雙人入住費率。

Overlay：刪除 <StatusApplicationControl> 中指定的入住天數、房型、房價方案和入住日期的所有現有住客數房價，並以新房價取代。舉例來說，如果您指定 LOS 1 和 2，然後您傳送 LOS 1 的 Overlay 更新，Google 就會移除 所有先前的費率 (LOS 1 和 2)，而只有 LOS 1 費率會維持不變 。

Remove：刪除現有所有 LOS 的每人入住費率 指定房型、房價方案和入住日期 <StatusApplicationControl>。

稅金相關

如果稅金和費用很簡單，則可使用以下格式指定總金額： AmountAfterTax。複雜稅金，例如稅金與費用 入住天數 (而非每晚房價) 無法在 AmountAfterTax 中顯示。

一般來說，Google 會建議使用 TaxFeeInfo，而非 AmountAfterTax。

盡可能加入 AmountBeforeTax (即使你指定 AmountAfterTax)，因為某些語言代碼 (例如美國) 會顯示 預設為稅前價格。

使用者須支付的所有稅金和費用 (加值稅、住宿稅、清潔費、城市) 稅金等)。 也直接支付相關費用

範例

本節提供「費率」訊息的基本範例 選用元素準備檔案後，您必須使用 POST 訊息將檔案傳送至下列端點：https://www.google.com/travel/hotels/uploads/property_data

如要進一步瞭解如何推送/POST 訊息，請參閱「推送訊息」。

如果是「HotelCode」，請使用系統中的專屬飯店 ID 識別屬性這個值必須符合使用 在 <listing> 元素中加上 <id> 自動擷取廣告<PackageID> 和 <RoomID> 請使用與 在您的系統中用於費率方案和房型 (兩者分別)。規律上傳 請務必確保 Google 能正確顯示 價格和資料

以下範例說明如何使用 Delta 動作設定費率：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

使用指南

本節提供的解決方案，是您在 為訊息評分。

如需新增、移除及更新房價的範例，請參閱「評分 範例。

情境 1：如何變更每人入住的定價

說明

先前只針對雙人房設定每晚房價 (同樣 適用於單人入住，但現在單人房價更低 活動情形。

解決方案

使用預設的 Delta 範圍更新，傳送新的入住人數 1 費率。這項新功能 這個值不會影響第 2 人入住費率。

情境 2：如何取代房源的每人入住費率

說明

您先前為 1 到 4 位入住人數定義了房價，但現在只有 第 1 和 2 位都是有效資源。

解決方案

使用 NotifType="Overlay" 取代特定房源的所有入住費率。 房型、房價方案和日期。在這種情況下，Overlay 動作會 列出第 1 人和第 2 人入住的費率

情境 3：如何為多個可住人數設定相同費率

說明

特定入住人數的房價可向人數較少的團體販售。在本 ，即可只傳送 的房價更新，藉此簡化訊息。 可容納最高可住人數

解決方案

如果你為多個可住人數設定相同的價格，請設定最高的可住人數 房型和房價方案支援的值，並自動顯示 並將這個值用於降低使用人數換句話說，您無須重複相同的步驟 1 到 6 位房客的每晚房價；設為 6