總覽
房價訊息 (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
如要進一步瞭解如何推送/發布訊息,請參閱推送訊息。
如果是 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 人即可。