价格规则 XML 文件定义了应用条件式价格的规则, 不公开费率。您可以使用 Hotel Center 中的费率规则页面。 如需详细了解条件式费率和不公开费率,请参阅 条件式费率和不公开费率。
每条价格规则都需要一个 id
,可以在
交易消息的 <Rate>
。一个 <Rate>
,
引用某个费率规则 ID,该 ID 仅应用于用户,并且
根据费率规则定义的值您还可以使用
变量的值。
<RateRuleSettings>
费率规则 XML 文件的根元素。通过
<RateRuleSettings>
(以前称为 <PrivateRates>
)元素包含:
用于定义条件的
<UserRateCondition>
元素 来匹配条件式费率和不公开费率例如,您可以创建一个 符合某一特定条件下所有用户的条件的条件 国家/地区。<RateRule>
元素,每个元素分别定义费率规则 在交易消息的<Rate>
中引用。每个<RateRule>
指定条件和界面处理方式 用于构建条件式费率或不公开费率
<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>
用于指定以下内容的容器:
- 提供费率的条件
- 对房价和房价的界面处理方式的修改(如果有)
- 对不公开费率使用隐藏的界面处理方式
<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> 的房价。
仅在指定 |
<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 | 指定房价将使用会员房价可见界面 。 此元素的值可以是任意会员计划名称。 |
<Description> |
Optional | string | 描述 <UserRateCondition> 。仅供文档参考
用途,不会影响其功能。
|
<LanguageCode> |
Optional | string | 指定费率将面向所用语言的用户提供 与这个由两个字母构成的 匹配 语言代码。 |
<MaxUsersPercent> |
Optional | float | 指定随机提供该百分比的佣金率 最终用户的体验和技术。 该值必须是 0 到 100(含 0 和 100)之间的整数。对于 例如,20 表示将定位 20% 的最终用户。 |
<MembershipProgram> |
Optional | string | 指定费率将采用会员计划界面处理方式
取决于 为使
|
<UserRateCondition> |
Optional | <UserRateCondition> |
定义一个或多个条件,如果匹配,会导致 提供的条件式费率或不公开费率。 具有 |
<UserCountry> |
Optional | string | CLDR
国家/地区代码,例如 指定用户必须位于指定的国家/地区。 Google 根据最终用户的 IP 地址确定其所在的国家/地区。 |
<UserDeviceType> |
Optional | enum | 定义设备类型条件。允许的值包括:
<ph type="x-smartling-placeholder">
|
<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>
“不限”“全部”和“无”
下面的条件式费率示例显示了 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>
不公开费率示例
显示会员费率 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
此不公开费率示例展示了如何将会员房价指定为可见 多个受众群体名单的界面处理方式:
<?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>
指示如何显示会员费率隐藏界面处理方式。如果不是 不会显示会员费率隐藏界面处理方式。
如需在 <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 | 定义文本(在划掉的符号旁边显示)的显示方式 描述隐藏率。 有效值包括:
如需详细了解界面处理方式,请参阅 不公开费率 详细信息和示例。 |
<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
类型
隐藏的界面处理方式,会向用户显示,而不向受众群体显示
列表。受众群体名单中的用户将看到相应受众群体比例。
<?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"
仅向受众群体名单用户显示会员价格
以下不公开费率示例指定隐藏的“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>
透明/可见的界面
以下示例展示了如何通过两种界面处理方式指定会员费率 (透明且可见的界面)针对受众群体名单中的用户和隐藏费率 所有其他用户
<?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>
价格调节系数
在价格 Feed 中为移动设备费率应用 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>