此页面由 Cloud Translation API 翻译。

费率规则 XML 参考

费率规则 XML 文件用于定义投放条件式费率和不公开费率的规则。您可以使用 Hotel Center 中的“费率规则”页面添加或修改费率规则 XML 文件。如需详细了解条件式费率和不公开费率，请参阅条件式费率和不公开费率。

每条费率规则都需要一个 id，可在交易消息的 <Rate> 中引用。引用费率规则 ID 的 <Rate> 仅在费率规则定义的条件下向用户投放。您还可以使用着陆页网址中的变量引用费率规则 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>`	定义匹配条件、修改以及提供条件式费率或不公开费率的资格条件。需要 `id` 属性，该属性可在交易消息的 `<Rate>` 或着陆页网址中引用。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	定义一个或多个条件，如果匹配，则会提供条件式费率或不公开费率。您可以通过以下方式定义条件：使用 `<UserRateCondition>` 子元素在内嵌方式下定义条件；使用 `reference_id` 属性引用另一个 `<UserRateCondition>` 元素来定义条件；或者同时使用内嵌方式和引用方式来定义条件。不过，任何包含 `reference_id` 的 `<UserRateCondition>` 都必须没有子元素。 `<RateRuleSettings>` 下的顶级 `<UserRateCondition>` 必须具有 `id` 属性。

<RateRule>

Required

<RateRule>

定义匹配条件、修改以及提供条件式费率或不公开费率的资格条件。需要 id 属性，该属性可在交易消息的 <Rate> 或着陆页网址中引用。

<UserRateCondition>

Optional

<UserRateCondition>

定义一个或多个条件，如果匹配，则会提供条件式费率或不公开费率。

您可以通过以下方式定义条件：使用 <UserRateCondition> 子元素在内嵌方式下定义条件；使用 reference_id 属性引用另一个 <UserRateCondition> 元素来定义条件；或者同时使用内嵌方式和引用方式来定义条件。不过，任何包含 reference_id 的 <UserRateCondition> 都必须没有子元素。

<RateRuleSettings> 下的顶级 <UserRateCondition> 必须具有 id 属性。

条件式费率示例

以下示例展示了定义条件式费率的基本方法。

建议引用预定义条件，如移动用户示例所示。

移动设备用户

以下基于条件的费率示例定义了一个费率规则，该规则会通过引用预定义的 <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`	必需	字符串	费率规则的唯一标识符。您可以使用交易消息中 `<Rate>` 的 `rate_rule_id` 属性引用此 ID，以提供基于条件式费率或不公开费率的价格。您还可以在着陆页网址中使用变量和条件引用费率规则 `id`。允许的字符数上限为 40。

id

必需

字符串

费率规则的唯一标识符。您可以使用交易消息中 <Rate> 的 rate_rule_id 属性引用此 ID，以提供基于条件式费率或不公开费率的价格。您还可以在着陆页网址中使用变量和条件引用费率规则 id。

允许的字符数上限为 40。

子元素

<RateRule> 元素具有以下子元素：

子元素	是否必需？	类型	说明
`<RateIneligibility>`	Optional	`<RateIneligibility>`	指定用于确定 `<MembershipProgram>` 费率的具体界面处理方式的值。仅在 `<UserRateCondition>` 中指定了 `<MembershipProgram>` 时有效。
`<UserRateCondition>`	Required	`<UserRateCondition>`	定义一个或多个条件，如果匹配，则会提供条件式费率或不公开费率。您可以通过以下方式定义条件：在内嵌中使用 `<UserRateCondition>` 子元素；使用 `reference_id` 属性引用另一个 `<UserRateCondition>`；或同时使用内嵌和引用方式。不过，请注意，当 `<UserRateCondition>` 是 `<RateRule>` 的子元素时，`<UserRateCondition>` 元素不能具有 `id` 属性，也不能被其他 `<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	此 `<UserRateCondition>` 的唯一标识符。可通过 `<RateRule>` `id` 属性或 `<UserRateCondition>` `reference_id` 属性引用。
`op`	Optional	enum	如果 `<UserRateCondition>` 有多个子元素，则 `op` 属性是必需属性。属性值可以是以下任一值： `all`：包含与此费率规则定义的所有条件匹配的最终用户。如果其中一个条件为 `<UserListId>`，则不能使用此值，除非仅定义一个其他条件（`<AlwaysEligibleMembershipProgram>` 或 `<MembershipProgram>`）。 `any`：包含与此费率规则定义的任何条件匹配的最终用户。 `none`：排除与此费率规则定义的任何条件匹配的最终用户。如果其中一个条件为 `<UserListId>`，则不能使用此值。
`reference_id`	Optional	string	将此元素定义为对具有匹配 `id` 的另一个预定义 `<UserRateCondition>` 的引用。当存在 `reference_id` 时：不会解析子元素 `id` 和 `op` 不应存在

id

Required (if top-level under <RateRuleSettings>)

string

此 <UserRateCondition> 的唯一标识符。可通过 <RateRule> id 属性或 <UserRateCondition> reference_id 属性引用。

op

Optional

enum

如果 <UserRateCondition> 有多个子元素，则 op 属性是必需属性。属性值可以是以下任一值：

all：包含与此费率规则定义的所有条件匹配的最终用户。如果其中一个条件为 <UserListId>，则不能使用此值，除非仅定义一个其他条件（<AlwaysEligibleMembershipProgram> 或 <MembershipProgram>）。
any：包含与此费率规则定义的任何条件匹配的最终用户。
none：排除与此费率规则定义的任何条件匹配的最终用户。如果其中一个条件为 <UserListId>，则不能使用此值。

reference_id

Optional

string

将此元素定义为对具有匹配 id 的另一个预定义 <UserRateCondition> 的引用。

当存在 reference_id 时：

不会解析子元素
id 和 op 不应存在

子元素

<UserRateCondition> 元素具有以下子元素：

子元素	是否必需？	类型	说明
`<AlwaysEligibleMembershipProgram>`	Optional	string	指定费率将使用会员费率可见界面处理方式。此元素的值可以是任何会员回馈活动名称。
`<Description>`	Optional	string	描述 `<UserRateCondition>`。这只是出于记录目的，不会影响其功能。
`<LanguageCode>`	Optional	string	指定将向语言与此两个字母的语言代码匹配的用户提供此费率。
`<MaxUsersPercent>`	Optional	float	指定将向此百分比的最终用户随机提供此费率。该值必须介于 0 到 100 之间（包括这两个数值）。例如，20 表示将定位到 20% 的最终用户。
`<MembershipProgram>`	Optional	string	指定费率将使用会员回馈活动界面处理方式，具体取决于 `<RateIneligibility>` 的 `<IneligibilityReason>`。为了使 `<MembershipProgram>` 有效，必须指定 `<RateIneligibility>`。 `<MembershipProgram>` 的值可以是任何会员回馈活动名称。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	定义一个或多个条件，如果匹配，则会提供条件式费率或不公开费率。包含 `reference_id` 的 `<UserRateCondition>` 必须没有子项。
`<UserCountry>`	Optional	string	CLDR 国家/地区代码，例如 `DE` 或 `FR`。请注意，对于某些国家/地区，CLDR 代码与两个字母的 ISO 代码不同。不支持 CLDR 地区代码。指定用户必须位于指定的国家/地区。 Google 会根据最终用户的 IP 地址确定其所在的国家/地区。
`<UserDeviceType>`	Optional	enum	定义设备类型条件。允许的值为： `mobile` `desktop` `tablet`
`<UserListId>`	Optional	string	受众群体名单的 Google Ads 用户名单 ID。此条件只能与 `<AlwaysEligibleMembershipProgram>` 或 `<MembershipProgram>` 搭配使用，或者 `op` 为 `any` 时使用。
`<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>

Japan 而非 Japan

以下基于条件的费率示例展示了一条与日本用户匹配的费率规则，以及一条与世界其他国家/地区 (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 条件所示，您可以使用“any”来匹配多个国家/地区中的任意国家/地区的用户。如 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>，还必须在 <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	定义文本（显示在带删除线的费率旁边）如何描述隐藏的费率。有效值包括： `exact`：折扣百分比。文字内容为：“免费注册即可享受 X% 的折扣”。 `price_band`：折扣范围。文字内容为“免费注册即可享受 X-Y% 的折扣”。如果折扣范围是 1-5%，文字将显示为“最高可享受 5% 的折扣”。更高的折扣则按 5 个百分点为增量显示，例如“可享受 5-10% 的折扣”或“可享受 10-15% 的折扣”。 `existence`：不含具体细节的提示。在这种情况下，文字将显示为：“免费注册即可享受更低价格。” 如需详细了解界面处理方式，请参阅非公开价格详情和示例。
`<IneligibilityReason>`	Required	enum	有效值包括： `program_member`：使用会员费率隐藏界面处理方式显示费率。

<IneligibilityType>

Required

enum

定义文本（显示在带删除线的费率旁边）如何描述隐藏的费率。

有效值包括：

exact：折扣百分比。文字内容为：“免费注册即可享受 X% 的折扣”。
price_band：折扣范围。文字内容为“免费注册即可享受 X-Y% 的折扣”。如果折扣范围是 1-5%，文字将显示为“最高可享受 5% 的折扣”。更高的折扣则按 5 个百分点为增量显示，例如“可享受 5-10% 的折扣”或“可享受 10-15% 的折扣”。
existence：不含具体细节的提示。在这种情况下，文字将显示为：“免费注册即可享受更低价格。”

如需详细了解界面处理方式，请参阅非公开价格详情和示例。

<IneligibilityReason>

Required

enum

有效值包括：

program_member：使用会员费率隐藏界面处理方式显示费率。

不公开费率示例

本部分包含会员费率隐藏示例（基本）和会员费率隐藏示例（多个条件）。您还可以向部分用户显示会员费率。如需显示会员费率，您应先发送最便宜的客房套餐的单人会员费率，然后再发送其余客房套餐的费率。不允许设置多个会员费率。

如需查看示例，请参阅非公开费率示例。

隐藏会员费率的示例（基本）

确切折扣

<?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	与 `<MembershipProgram>` 和 `<RateIneligibility>` 结合使用，以修改会员费率隐藏的界面处理方式。有效值包括： `free_wifi`：向文本添加 `plus free wifi`。
`<PriceMultiplier>`	Optional	float	通过将此值乘以基本费率、税费和其他费用来修改价格。例如，如果 `PriceMultiplier` = 0.9，基本费率 = 100 美元，税费 = 20 美元，费用 = 10 美元；那么应用乘数后：基本费率 = 90 美元，税费 = 18 美元，费用 = 9 美元。这样，您就可以对采用特定费率规则的所有费率应用折扣。

<HotelAmenity>

Optional

enum

与 <MembershipProgram> 和 <RateIneligibility> 结合使用，以修改会员费率隐藏的界面处理方式。

有效值包括：

free_wifi：向文本添加 plus free wifi。

<PriceMultiplier>

Optional

float

通过将此值乘以基本费率、税费和其他费用来修改价格。例如，如果 PriceMultiplier = 0.9，基本费率 = 100 美元，税费 = 20 美元，费用 = 10 美元；那么应用乘数后：基本费率 = 90 美元，税费 = 18 美元，费用 = 9 美元。

这样，您就可以对采用特定费率规则的所有费率应用折扣。

不公开费率示例

酒店设施

为所有用户隐藏会员费率（乐队折扣）+ 免费 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>