評分訊息

總覽

房價訊息 (OTA_HotelRateAmountNotifRQ) 定義特定日期範圍內，各房型和費率方案組合的每晚入住費率。在房價訊息中，Google 支援以入住人數為準的定價，可根據預計可住人數的數量上限指定不同的每晚費率。

以下各節將說明一般指南、基本範例和使用情境，協助您開始新增和更新費率及傳送房價訊息。

媒合率行為

當使用者要求特定入住人數時，他們看到的費率會因費率訊息中的價格定義而異。本節將說明這些使用者要求如何與您的費率進行比對，具體取決於使用者要求的可住人數，以及您定義的費率。

重要原則

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

• 如果要求超過所定義的人數，則不可能。

• 以入住人數為依據的定價適用於下列計價模式和以 LOS 為基礎的定價模式 (如下所述)。也就是說，您可以指定各種入住人數的費率。如果沒有特定可住人數的費率，則會使用下一個可住人數的費率。您也可以使用 AdditionalGuestAmounts 或 ExtraGuestCharges 定義其他房客和子項的費用，這些費用會計入會議室定義的容量。

優點與範例

效益

如果是費率金額相同的多個可住人數，則您不必為每種可住人數設定費率。您可以只設定房型和費率方案支援的最高可住人數值，藉此簡化訊息。使用者會看到每個入住人數小於或等於設定值的費率。

範例：房型和房價方案的房價與一到四人相同。使用費率訊息，設定最多 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" 即可。此外，您還需要在 XML 中的 Rate 元素上設定 RateTimeUnit 和 UnitMultiplier 屬性。這會使指定 Rate 元素底下的所有費率都套用於 <StatusApplicationControl> 中指定的抵達日期和 UnitMultiplier 指定的 LOS 值所定義。

您可以在同一個帳戶中同時使用依日期計費和依 LOS 計算的定價模式，但每項資源應僅使用單一計費模式。導入 LOS 型定價時，請記住以下要點：

• 使用以 LOS 為依據的定價時，不同入住天數的費率不會合併。舉例來說，假設 LOS 比率為 3，則無法與 LOS 合併使用，因此 LOS 費率為 4。必須明確指定 LOS 速率 4。
• 以 LOS 為依據的 1 晚房價，不會做為每個日期的個別每晚費率。
• 視系統中的費率計算方式而定，每個屬性只能使用以 LOS 為準的定價或按日期計價。

如要在帳戶中啟用根據 LOS 的定價，請透過您的客戶技術顧問提出要求，或是與我們聯絡。

規範或動作

按日期計費

Delta：針對 <StatusApplicationControl> 中指定的房型、房價方案和入住日期，新增或更新每人入住的費率。

• 根據預設，評分更新會使用 Delta 動作。
• Delta 更新不會變更先前為其他乘客儲存的費率。例如，如果您為單人房和雙人房指定了費率，並傳送單一入住客房的 Delta 費率更新，則雙人入住的費率則維持不變。

Overlay：刪除 <StatusApplicationControl> 中指定的客房類型、費率方案和日期所有現有的每人入住費率，並替換成新的費率。舉例來說，如果您為單人房和雙人房指定了費率，並傳送單一可住人數的 Overlay 更新，Google 將移除先前的所有費率 (單人和雙人房)，且更新後只會保留單一入住費率。

Remove：針對 <StatusApplicationControl> 中指定的房型、費率方案和日期，刪除所有現有入住費率。

依 LOS 計算的定價

Delta：只針對 <StatusApplicationControl> 中指定的房型、房價方案和入住日期組合，新增或更新個別 LOS 值的費率。將所有入住的費率替換為與更新後的 LOS 值相關聯的費率。

• 根據預設，評分更新會使用 Delta 動作。
• Delta 更新不會變更先前儲存的其他入住時間長度費率。例如，如果您指定 LOS 1 和 2 的費率，並傳送 LOS 1 的 Delta 費率更新，則 LOS 2 的每個可住人數費率維持不變。
• Delta 更新會覆寫先前儲存的所有指定入住天數費率。例如，如果您為 LOS 1 指定了單人和雙人入住的費率，並傳送只有單一可住人數的 LOS 1 的 Delta 費率更新，就會移除雙人入住率。

Overlay：刪除 <StatusApplicationControl> 中指定的所有可住人數現有費率、房型、費率方案和入住日期，並替換為新的費率。例如，如果您已指定 LOS 1 和 2 的費率，並傳送 LOS 1 的 Overlay 更新，Google 將移除先前的所有費率 (LOS 1 和 2)，且更新後只會保留 LOS 1 費率。

Remove：針對 <StatusApplicationControl> 中指定的所有房型、費率方案和入住日期，刪除每個可住人數的現有所有費率。

稅務相關

如果稅金和費用很簡單，可以使用 AmountAfterTax 指定總金額。不得在 AmountAfterTax 中標示複雜的稅金，例如每間住宿 (而非每晚) 的稅金和相關費用。

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

如果可以的話，請盡量加入 AmountBeforeTax (即使您指定 AmountAfterTax)，因為某些語言代碼 (例如美國) 預設會顯示稅前價格。

凡是使用者在預訂時支付的所有稅金和費用 (加值稅、住宿稅金、清潔費、城市稅等)，即使並非在預訂時付款，或並非直接在房源中支付，仍應納入。

範例

本節提供使用必要和選用元素的頻率訊息基本範例。準備檔案後，您必須使用 POST 訊息將檔案傳送給 Google： https://www.google.com/travel/hotels/uploads/property_data

如要進一步瞭解如何推送/發布訊息，請參閱推送訊息。

注意： 只要每晚房價有所變動，你都可以傳送訊息給 Google。

如果是 HotelCode，請使用您在系統中用來識別房源的專屬飯店 ID。這個值必須符合飯店清單動態饋給中 <id> <listing> 元素 中指定的飯店 ID。如果是 <PackageID> 和 <RoomID>，請分別在費率方案和房型類型中使用與您在系統內相同的 ID。請務必與系統保持一致，以確保 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 人即可。

注意： 如未設定 NumberOfGuests，預設可住人數值為 2。