費率規範 XML 檔案定義了提供條件式費率和不公開費率的規則。如要新增或編輯費率規範 XML 檔案,請使用 Hotel Center 的「費率規則」頁面。 如要進一步瞭解條件式費率和不公開費率,請參閱「條件式和不公開費率」一文。
每個費率規範都需要 id
,可在交易訊息的 <Rate>
中參照。參照費率規範 ID 的 <Rate>
只會在費率規範定義的條件下向使用者提供。您也可以使用到達網頁網址中的變數來參照費率規範 ID。
<RateRuleSettings>
費率規範 XML 檔案的根元素。<RateRuleSettings>
(舊稱 <PrivateRates>
) 元素包含:
<UserRateCondition>
元素會定義條件式和不公開費率的比對條件。例如,您可以建立符合特定國家/地區所有使用者條件的條件式費率。<RateRule>
元素,每項元素都定義交易訊息中<Rate>
參照的費率規範。每個<RateRule>
都會指定建構條件式或不公開費率的條件和 UI 處理方式。
<RateRuleSettings>
元素會顯示在費率規範 XML 階層中的以下位置:
+<RateRuleSettings>
+<UserRateCondition>
+<RateRule>
+<UserRateCondition>
+<RateIneligibility>
+<RateModification>
語法
<RateRuleSettings>
元素使用下列語法:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<UserRateCondition id="some_id" op="[all|any|none]">
...
</UserRateCondition>
<!-- Required -->
<RateRule id="rate_rule_id">
<!-- Required -->
<UserRateCondition op="[all|any|none]">
...
</UserRateCondition>
</RateRule>
</RateRuleSettings>
屬性
<RateRuleSettings>
元素不含任何屬性。
子元素
<RateRuleSettings>
元素包含下列子元素:
子項元素 | 必填與否 | 類型 | 說明 |
---|---|---|---|
<RateRule> |
Required | <RateRule> |
定義相符條件、修改項目和提供條件式/不公開費率的放送資格。必須提供 |
<UserRateCondition> |
Optional | <UserRateCondition> |
定義一或多個符合條件式或不公開費率的條件。 您可以使用
|
條件式費率範例
以下舉例說明定義條件式費率的基本方式。
建議您參照預先定義的條件,如「行動裝置使用者」範例所示。
行動使用者
以下條件式費率範例會參照預先定義的 <UserRateCondition>
,定義符合所有行動裝置使用者的費率規範:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<UserRateCondition id="mobile">
<UserDeviceType>mobile</UserDeviceType>
</UserRateCondition>
<RateRule id="mobile">
<!-- Referencing pre-defined conditions is recommended -->
<UserRateCondition reference_id="mobile"/>
</RateRule>
</RateRuleSettings>
美國使用者
以下條件式費率範例會參照預先定義的 <UserRateCondition>
,定義費率規範,以比對在美國搜尋的所有使用者:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<UserRateCondition id="us">
<UserCountry>US</UserCountry>
</UserRateCondition>
<RateRule id="us">
<UserRateCondition reference_id="us"/>
</RateRule>
</RateRuleSettings>
<RateRule>
用來指定下列內容的容器:
- 提供費率的條件
- 修改費率的價格和使用者介面處理方式 (如果有的話)
- 針對不公開費率使用隱藏 UI 處理方式
<RateRule>
元素會顯示在費率規範 XML 階層中的以下位置:
+<RateRuleSettings>
+<UserRateCondition>
+<RateRule>
+<UserRateCondition>
+<RateIneligibility>
+<RateModification>
語法
<RateRule>
元素使用下列語法:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
<UserRateCondition ...>
...
</UserRateCondition>
<!-- At least one RateRule is required. The id attribute is required -->
<RateRule id="rate_rule_id">
<!-- One or more UserRateCondition elements (inline or referenced) are required. -->
<UserRateCondition op="[all|any|none]"> // Inline example
<Description>user_rate_condition_description</Description>
<!-- Uses the member rate visible UI treatment -->
<AlwaysEligibleMembershipProgram>program_name</AlwaysEligibleMembershipProgram>
<LanguageCode>language_code</LanguageCode>
<MaxUsersPercent>20</MaxUsersPercent> // 20% of users
<!-- Requires <RateIneligibility> -->
<MembershipProgram>program_name</MembershipProgram>
<UserRateCondition reference_id="user_rate_condition_id"/>
<UserCountry>country_code</UserCountry>
<UserDeviceType>[mobile|desktop|tablet]</UserDeviceType>
<UserListId>id</UserListId>
<UserSignedIn>[true|false]</UserSignedIn>
<IsDomestic>[true|false]</IsDomestic>
</UserRateCondition>
<RateIneligibility>
<IneligibilityType>[exact|price_band|existence]</IneligibilityType>
<IneligibilityReason>[program_member]</IneligibilityReason>
</RateIneligibility>
<RateModification>
<HotelAmenity>[free_wifi]</HotelAmenity>
</RateModification>
</RateRule>
</RateRuleSettings>
屬性
<RateRule>
元素的屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
id |
必要 | 字串 |
費率規範的專屬 ID。系統會使用交易訊息中 長度上限為 40 個半形字元。 |
子元素
<RateRule>
元素包含下列子元素:
子項元素 | 必填與否 | 類型 | 說明 |
---|---|---|---|
<RateIneligibility> |
Optional | <RateIneligibility> |
指定值,決定 <MembershipProgram> 率的特定 UI 處理方式。只有在 |
<UserRateCondition> |
Required | <UserRateCondition> |
定義一或多個符合條件式或不公開費率的條件。 您可以使用 不過請注意,如果 |
<RateModification> |
Optional | <RateModification> |
針對不公開費率修改使用者介面的處理方式。 |
<PromoCode> |
Optional | string | 如果套用這個費率規範,指定要與費率相關聯的代碼,反映在 PROMO-CODE 到達網頁變數中。 |
<UserRateCondition>
定義一或多個符合條件式或不公開費率的條件。
<UserRateCondition>
元素會顯示在費率規則 XML 階層中的以下位置:
+<RateRuleSettings>
+<UserRateCondition>
+<RateRule>
+<UserRateCondition>
+<RateIneligibility>
+<RateModification>
語法
<UserRateCondition>
元素使用下列語法:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
<!-- "op" is required for more than one child element -->
<UserRateCondition id="some_id" op="[all|any|none]">
<UserDeviceType>device_type</UserDeviceType>
</UserRateCondition>
<UserRateCondition id="some_other_id" op="[all|any|none]">
<UserDeviceType>device_type</UserDeviceType>
</UserRateCondition>
<!-- At least one RateRule is required -->
<RateRule id="rate_rule_id">
<UserRateCondition reference_id="some_id"/>
</RateRule>
<RateRule id="rate_rule_id">
<UserRateCondition reference_id="some_other_id"/>
</RateRule>
<RateRule id="rate_rule_id">
<UserRateCondition>
<UserDeviceType>device_type</UserDeviceType>
</UserRateCondition>
</RateRule>
<span class="nocode"></RateRuleSettings></span>
屬性
<UserRateCondition>
元素的屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
id |
Required (if top-level under
<RateRuleSettings> ) |
string |
此 |
op |
Optional | enum |
如果
|
reference_id |
Optional | string |
將此元素定義為對另一個具有相符 當
|
子元素
<UserRateCondition>
元素包含下列子元素:
子項元素 | 必填與否 | 類型 | 說明 |
---|---|---|---|
<AlwaysEligibleMembershipProgram> |
Optional | string | 指定費率將使用畫面上顯示的會員費率 UI 處理方式。 這個元素的值可以是任何會員方案名稱。 |
<Description> |
Optional | string | 說明 <UserRateCondition> 。這份文件僅供說明文件使用,對其功能沒有任何影響。 |
<LanguageCode> |
Optional | string | 指定系統會向語言與這個雙字母 語言代碼相符的使用者提供費率。 |
<MaxUsersPercent> |
Optional | float | 指定系統將隨機向指定比例的使用者提供費率。 這個值必須是介於 0 至 100 (含) 之間的整數。例如,20 會指定 20% 的使用者。 |
<MembershipProgram> |
Optional | string | 指定費率將使用 必須指定
|
<UserRateCondition> |
Optional | <UserRateCondition> |
定義一或多個符合條件式或不公開費率的條件。 具有 |
<UserCountry> |
Optional | string | CLDR 國家/地區代碼,例如 指定使用者必須位於指定國家/地區。 Google 會根據使用者的 IP 位址判斷他們所在的國家/地區。 |
<UserDeviceType> |
Optional | enum | 定義裝置類型條件。允許的值如下:
|
<UserListId> |
Optional | string | 目標對象名單的 Google Ads 使用者名單 ID。
這項條件只能與 |
<UserSignedIn> |
Optional | boolean | 布林值,用於指定使用者是否必須登入自己的 Google 帳戶。true 值表示使用者必須登入。false 值表示使用者不得登入。如果您不關心使用者登入的狀態,請勿加入 <UserSignedIn> 條件。 |
<IsDomestic> |
Optional | boolean | 布林值,用於指定使用者是否必須來自飯店所在的國家/地區。如果值為 true ,表示使用者必須與飯店位於相同的國家/地區。false 值表示使用者可能來自飯店所在國家/地區以外的任何國家/地區。如果您想更精細的控制,請使用 <UserCountry> 條件。 |
條件式費率範例
使用者百分比
下列條件式費率範例會指定系統隨機向所有使用者提供費率的 20%:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="20_percent_users">
<UserRateCondition>
<MaxUsersPercent>20</MaxUsersPercent>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
英國和行動裝置使用者
以下條件式費率範例使用內嵌 <UserRateCondition>
定義費率規範,以比對在英國透過行動裝置搜尋的所有使用者:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="gb_mobile">
<UserRateCondition op="all">
<UserCountry>GB</UserCountry>
<UserDeviceType>mobile</UserDeviceType>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
日本和非日本
以下條件式費率範例,顯示一個符合日本使用者的費率規範,以及另一項符合世界其他地方使用者的費率規範 (RoW):
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="jp">
<UserRateCondition>
<UserCountry>jp</UserCountry>
</UserRateCondition>
</RateRule>
<RateRule id="row_not_jp">
<UserRateCondition op="none">
<UserCountry>jp</UserCountry>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
不限、全部和無
以下條件式費率範例說明如何使用 any
、all
和 none
值,以不同方式使用 op
屬性比對多項條件。舉例來說,如 au_nz
條件所示,您可以使用任一國家/地區來比對其中一個國家/地區的使用者。如 au_nz_mobile_tablet
費率規範所示,您可以使用 all
要求使用者符合多項條件。row_mobile_tablet
費率規範會將全球其他國家/地區 (列) (不含澳洲和紐西蘭) 且符合 mobile_tablet
條件的使用者進行比對。
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<UserRateCondition id="au_nz" op="any">
<UserCountry>AU</UserCountry>
<UserCountry>NZ</UserCountry>
</UserRateCondition>
<UserRateCondition id="mobile_tablet" op="any">
<UserDeviceType>mobile</UserDeviceType>
<UserDeviceType>tablet</UserDeviceType>
</UserRateCondition>
<RateRule id="au_nz_mobile_tablet">
<UserRateCondition op="all">
<UserRateCondition reference_id="au_nz"/>
<UserRateCondition reference_id="mobile_tablet"/>
</UserRateCondition>
</RateRule>
<RateRule id="row_mobile_tablet">
<UserRateCondition op="all">
<UserRateCondition op="none">
<UserRateCondition reference_id="au_nz"/>
</UserRateCondition>
<UserRateCondition reference_id="mobile_tablet"/>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
不公開費率示例
顯示會員費率 1
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="member_visible">
<UserRateCondition>
<AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
顯示會員費率 2
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="member_visible_es_only">
<UserRateCondition op="all">
<AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
<UserCountry>es</UserCountry>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
目標對象名單率 1
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="audience_list">
<UserRateCondition>
<UserListId>[enter an audience list id]</UserListId>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
目標對象名單率 2
以下示例說明如何為多個目標對象名單指定會員費率 UI 處理方式:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program">
<UserRateCondition op="all">
<AlwaysEligibleMembershipProgram>[enter the program name here]</AlwaysEligibleMembershipProgram>
<UserRateCondition op="any">
<UserListId>[enter one audience list id here]</UserListId>
<UserListId>[enter another audience list id here]</UserListId>
</UserRateCondition>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
<RateIneligibility>
用於說明如何在隱藏 UI 樣式的情況下顯示會員費率。如果未加入,系統就不會顯示會員費率隱藏的 UI 處理方式。
如要在 <RateRule>
中使用 <RateIneligibility>
,也必須在 <RateRule>
的 <UserRateCondition>
元素中指定 <MembershipProgram>
。
<RateIneligibility>
元素會顯示在費率規則 XML 階層中的以下位置:
+<RateRuleSettings>
+<UserRateCondition>
+<RateRule>
+<UserRateCondition>
+<RateIneligibility>
+<RateModification>
語法
<RateIneligibility>
元素使用下列語法:
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
<UserRateCondition ...>
...
</UserRateCondition>
<RateRule ...>
<UserRateCondition ...>
...
<!-- Required when using RateIneligibility -->
<MembershipProgram>program_name</MembershipProgram>
...
</UserRateCondition>
<RateIneligibility>
<IneligibilityType>[exact|price_band|existence]</IneligibilityType>
<IneligibilityReason>[program_member]</IneligibilityReason>
</RateIneligibility>
</RateRule>
</RateRuleSettings>
屬性
<RateIneligibility>
元素不含任何屬性。
子元素
<RateIneligibility>
元素包含下列子元素:
子項元素 | 必填與否 | 類型 | 說明 |
---|---|---|---|
<IneligibilityType> |
Required | enum | 定義文字 (顯示在大範圍輸出率旁邊) 如何描述隱藏率。 以下為有效值:
如要進一步瞭解使用者介面的處理方式,請參閱不公開費率詳細資料和範例。 |
<IneligibilityReason> |
Required | enum | 以下為有效值:
|
不公開費率示例
本節包含隱藏會員費率的範例 (基本) 和會員費率隱藏範例 (多個條件)。你也可以向部分使用者顯示會員費率。如需範例,請參閱「不公開費率範例」。
隱藏會員費率示例 (基本)
確切折扣
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program">
<RateIneligibility>
<IneligibilityReason>program_member</IneligibilityReason>
<IneligibilityType>exact</IneligibilityType>
</RateIneligibility>
<UserRateCondition>
<MembershipProgram>[enter program name here]</MembershipProgram>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
錶帶折扣
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program">
<RateIneligibility>
<IneligibilityReason>program_member</IneligibilityReason>
<IneligibilityType>price_band</IneligibilityType>
</RateIneligibility>
<UserRateCondition>
<MembershipProgram>[enter program name here]</MembershipProgram>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
提示折扣
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program">
<RateIneligibility>
<IneligibilityReason>program_member</IneligibilityReason>
<IneligibilityType>existence</IneligibilityType>
</RateIneligibility>
<UserRateCondition>
<MembershipProgram>[enter program name here]</MembershipProgram>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
隱藏會員費率的示例 (多個條件)
op="any"
針對非會員的會員目標對象名單費率 + 隱藏會員費率 (存在折扣)
此不公開費率範例指定會員費率的 existence
類型隱藏 UI 處理方式,這會向使用者顯示,不會向目標對象名單顯示。系統會向目標對象名單中的使用者顯示目標對象率。
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program">
<RateIneligibility>
<IneligibilityReason>program_member</IneligibilityReason>
<IneligibilityType>existence</IneligibilityType>
</RateIneligibility>
<UserRateCondition op="any">
<MembershipProgram>[enter program name here]</MembershipProgram>
<UserListId>[enter you audience list id here]</UserListId>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
op="all"
只對目標對象名單使用者隱藏會員費率
此不公開費率示例指定隱藏式 UI 處理方式的 exact
類型,並加上「加上免費 Wi-Fi」這段額外文字。系統會向符合目標對象名單的使用者顯示這項 UI 樣式。
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program_for_audience_list">
<RateIneligibility>
<IneligibilityReason>program_member</IneligibilityReason>
<IneligibilityType>exact</IneligibilityType>
</RateIneligibility>
<RateModification>
<HotelAmenity>free_wifi</HotelAmenity>
</RateModification>
<UserRateCondition op="all">
<MembershipProgram>[enter program name here]</MembershipProgram>
<UserListId>[enter you audience list id here]</UserListId>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
透明/可見的使用者介面
本例說明如何透過兩個 UI 處理方式 (透明且可見的 UI),針對目標對象名單中的使用者指定會員費率,以及為其他使用者指定隱藏費率。
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program">
<RateIneligibility>
<IneligibilityReason>program_member</IneligibilityReason>
<IneligibilityType>existence</IneligibilityType>
</RateIneligibility>
<UserRateCondition op="any">
<MembershipProgram>[enter program name here]</MembershipProgram>
<UserRateCondition op="all">
<UserListId>[enter you audience list id here]</UserListId>
<AlwaysEligibleMembershipProgram>program_name</AlwaysEligibleMembershipProgram>
</UserRateCondition>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
<RateModification>
針對不公開費率修改使用者介面的處理方式。
<RateModification>
元素會顯示在費率規則 XML 階層中的以下位置:
+<RateRuleSettings>
+<UserRateCondition>
+<RateRule>
+<UserRateCondition>
+<RateIneligibility>
+<RateModification>
屬性
<RateModification>
元素不含任何屬性。
子元素
<RateModification>
元素包含下列子元素:
子項元素 | 必填與否 | 類型 | 說明 |
---|---|---|---|
<HotelAmenity> |
Optional | enum | 搭配使用 以下為有效值:
|
<PriceMultiplier> |
Optional | float | 如要修改價格,請將這個值乘以基本費率、稅金和相關費用。舉例來說,如果 這樣就能對設有特定費率規範的所有費率套用折扣。 |
不公開費率示例
飯店設施
對所有使用者隱藏會員費率 (頻帶折扣) + 免費 Wi-Fi
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="membership_program">
<RateIneligibility>
<IneligibilityReason>program_member</IneligibilityReason>
<IneligibilityType>price_band</IneligibilityType>
</RateIneligibility>
<RateModification>
<HotelAmenity>free_wifi</HotelAmenity>
</RateModification>
<UserRateCondition>
<MembershipProgram>[enter program name here]</MembershipProgram>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
價格調節係數
在價格動態饋給中為行動裝置費率套用 5% 折扣
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="mobile">
<RateModification>
<PriceMultiplier>0.95</PriceMultiplier>
</RateModification>
<UserRateCondition>
<UserDeviceType>mobile</UserDeviceType>
</UserRateCondition>
</RateRule>
</RateRuleSettings>