費率規範 XML 檔案定義了提供條件式費率及 不公開費率。如要新增或編輯費率規範 XML 檔案，請使用 Hotel Center 的「費率規範」頁面。 如要進一步瞭解條件式費率和不公開費率，請參閱 條件式費率和不公開費率：
每個費率規範都需要 id，可參考
<Rate> 的訊息。內含的 <Rate>
費率規範 ID 只會在以下條件下向使用者放送
套用費率規範您也可以使用費率規範 ID 來參照費率規範 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。這個 ID 參照的是
交易中 長度上限為 40 個半形字元。 |
子元素
<RateRule> 元素包含下列子元素：
| 子項元素 | 必填與否 | 類型 | 說明 |
|---|---|---|---|
<RateIneligibility> |
Optional | <RateIneligibility> |
指定值，以決定使用者的特定 UI 處理方式
<MembershipProgram> 比率。
只有在指定 |
<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 | 指定費率將使用會員方案 UI 處理方式
判斷依據為：
|
<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
表示使用者必須與飯店位於同一個國家/地區。A 罩杯
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>
以下是 op 的條件式費率範例
您可以運用屬性，以不同方式比對多個條件
使用 any、all 和 none 值。例如，
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>
不公開費率示例
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="member_visible">
<UserRateCondition>
<AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
<?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>
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
<RateRule id="audience_list">
<UserRateCondition>
<UserListId>[enter an audience list id]</UserListId>
</UserRateCondition>
</RateRule>
</RateRuleSettings>
這個不公開費率示例說明如何指定公開顯示的會員費率 多份目標對象名單的使用者介面處理方式：
<?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>，必須也為 <MembershipProgram>
必須在 <RateRule> 的 <UserRateCondition> 元素中指定。
<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 | 定義文字 (顯示在劃定率旁) 如何 並描述隱藏費率 有效值如下：
如要進一步瞭解 UI 處理方式，請前往： 不公開費率 詳細資料和範例。 |
<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>
隱藏會員費率的示例 (多個條件)
已隱藏會員的目標對象名單費率 + 隱藏會員費率 (存在折扣) 適合非會員
請參考不公開費率的示例，指定會員費率的 existence 類型
隱藏式 UI 樣式，這項資訊會向使用者顯示，而非向目標對象顯示
請參考閱讀清單，進一步瞭解
如何選擇 Kubeflow Pipelines SDK 或 TFX系統會向目標對象名單中的使用者顯示目標對象率。
<?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>
只對目標對象名單使用者隱藏會員費率
這個不公開費率示例會指定隱藏會員費率的 exact 類型
修改使用者介面，加上額外文字「加上免費 Wi-Fi」。這個使用者介面
系統會向符合目標對象名單的使用者顯示實驗組。
<?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 處理方式指定會員費率 (透明且可見的使用者介面) 對目標對象名單和隱藏費率中的使用者顯示 供其他使用者使用
<?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>