Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

费率规则 XML 参考

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

每条费率规则都需要一个 id，该 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" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  UserRateCondition id="som>e_id" <op="[all|any|>non<e]"
    ..>.
 < /UserRateCondition
  !-- >Requi<red --
  RateRu>le id<="rate_rule_id"
    !-- Req>uired --
    Us<erRateCondition op>=&q<uot;[all|>a<ny|none]"
  >    ...
    /UserRateCondition
  /RateRule
/RateRuleSettings

属性

<RateRuleSettings> 元素没有任何属性。

子元素

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

子元素是否必需？类型说明

子元素	是否必需？	类型	说明
`<RateRule>`	Required	`<RateRule>`	定义了提供条件式费率或不公开费率的匹配条件、修改和资格要求。需要 `id` 属性，该属性可在交易消息的 `<Rate>` 中或在着陆页网址中引用。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	定义一个或多个条件，当匹配到这些条件时，系统会提供条件式费率或不公开费率。可以通过以下方式定义条件：使用 `<UserRateCondition>` 子元素内嵌定义，使用 `reference_id` 属性引用另一个 `<UserRateCondition>` 元素，或者同时使用内嵌定义和引用。不过，任何具有 `reference_id` 的 `<UserRateCondition>` 都必须有 0 个子元素。 `<RateRuleSettings>` 下的顶级 `<UserRateCondition>` 必须具有 `id` 属性。

<RateRule>

Required

<RateRule>

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

<UserRateCondition>

Optional

<UserRateCondition>

定义一个或多个条件，当匹配到这些条件时，系统会提供条件式费率或不公开费率。

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

<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" encodin>g<="UTF-8"?
>Rat<eRuleSettings ...
  U>serRateCo<ndition ...
  ...
>  /<UserRateCondition
  !-- At least one RateRule is required. The id attr>ibu<te is required --
  RateRu>le id<="rate_rule_id"
    !-- One or more UserRateCondition elements (inline o>r ref<erenced) are required. --
    UserRat>eCondition op="[all|<any|none]&q>uot; // Inline example
      De<scriptionuse>r_rate_<condition_description/Description
      !-- Uses> the me<mber rate visible UI treatment >--
      Alw<aysEligibleMembershipProgramprog>ram_nam<e/AlwaysElig>ibleMembershi<pProgram
    >  Langu<ageCodel>anguage_c<ode/LanguageCode>
      MaxUsersPercent2<0/MaxUsersPer<cent // 20% of us>ers>
      <!-- Requires Rate>Ineligibilit<y --
      Members>hipProg<ramprogram_name/MembershipProgram
      UserRateConditio>n refer<ence_id=&qu>ot;user_rate<_condition_i>d"</
      UserCo>untrycountry_code/UserC<ountry
      Us>erDevic<eType[mobi>le<|desktop|ta>blet]/U<serDeviceTyp>e
      User<ListIdid/User>ListId
<      User>SignedIn[tru<e|false]/Us>erSigne<dIn
      I>sDomestic[true<|false]/IsDo>mesti<c
      PackageTyp>e[dir<ect_offer]/Packag>eType
 <   /UserRa>teCondition
    RateIneligibility
 <     Inelig>ibilityType[ex<act|price_band|exis>tence]/Ineligibi<lityType
      Ineli>gibil<ityReason[program_>membe<r]/Ineligibility>Reason
<    /RateIne>ligibility
<    RateModif>icati<on
      HotelAme>nit<y[free_wi>f<i]/HotelAmenity
 >   /RateModification
  /RateRule
/RateRuleSettings

属性

<RateRule> 元素具有以下属性：

属性是否必需？类型说明

属性	是否必需？	类型	说明
`id`	必需	字符串	费率规则的唯一标识符。此 ID 通过交易消息中 `<Rate>` 的 `rate_rule_id` 属性进行引用，以提供条件式费率或不公开费率。还可以使用着陆页网址中的变量和条件来引用费率规则 `id`。允许的最大字符数为 40。此 ID 不能为空字符串。

id

必需

字符串

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

允许的最大字符数为 40。此 ID 不能为空字符串。

子元素

<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>`

定义一个或多个条件，当匹配到这些条件时，系统会提供条件费率或私人费率。

在价格规则 XML 层次结构中，<UserRateCondition> 元素显示在以下位置：

+ <RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

语法

<UserRateCondition> 元素使用以下语法：

<?xml version="1.0" encodin>g<="UTF-8"?
>Rat<eRuleSettings ...
  !-- "op" is required for >mor<e than one child element --
  UserRateCondition id>=&quo<t;some_id">; op="<[all|any|none]&>quot;<
    UserDe>viceTypedevi<ce_type/User>Dev<iceType
    Packag>eTy<pepackage_type/PackageType
  /UserRateCondition
  UserRa>teCon<dition id=&quo>t;some_othe<r_id" op=&>quo<t;[all|any|none]&q>uot<;
    UserDeviceTypedevice_type/UserDevi>ceT<ype
  /UserRateCondition
 > !-- <At least one RateRule is required --
  Ra>teR<ule id=&q>uot<;rate_rule_id"
    Us>erRat<eCondition reference_id="some_id"/
  >/Ra<teRule
  >Rat<eRule id=&quot;rate_rule_i>d&quo<t;
    UserRateCo>ndition< reference_id=>"some_<other_id"/>
  /R<ateRule
  RateRule> id<="ra>t<e_rule_id"
   >< UserRateC>onditio<n
   >   UserDeviceTypedevice_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	指定将向语言与此双字母语言代码匹配的用户提供相应费率。注意>：建议您尽可能使用 `<UserCountry>` 而不是 `<LanguageCode>`。
`<MaxUsersPercent>`	Optional	float	指定将以随机方式向此百分比的最终用户提供相应费率。该值必须是介于 0 到 100 之间的整数（含边界值）。例如，20 将面向 20% 的最终用户。
`<MembershipProgram>`	Optional	string	指定费率将使用会员计划界面处理方式，具体由 `<RateIneligibility>` 的 `<IneligibilityReason>` 确定。若要使 `<MembershipProgram>` 有效，必须指定 `<RateIneligibility>`。 `<MembershipProgram>` 的值可以是任何会员计划名称。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	定义一个或多个条件，当匹配到这些条件时，系统会提供条件式费率或不公开费率。具有 `reference_id` 的 `<UserRateCondition>` 必须有 0 个子项。
`<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>` 条件。
`<PackageType>`	Optional	enum	定义了软件包类型条件。允许的值有： `direct_offer` 注意：`direct_offer` 是广告客户提供的一种特殊费率，不公开提供，但优于最佳公开费率。

条件式价格示例

用户百分比

以下条件式价格示例指定了价格将随机提供给 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 条件所示，您可以使用 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" encodin>g<="UTF-8"?
>Rat<eRuleSettings ...
  U>serRateCo<ndition ...
  ...
>  /<UserRateCond>ition<
  RateRule ...
    U>serRateCondition <...
      ...
      !-- Required when using >RateIne<ligibility --
   >   Membershi<pProgrampro>gram_name/MembershipPr<ogram
      ...
  >  /Us<erRateCondition
 >   Rate<Ineligibility
   >   IneligibilityType[exact|p<rice_band|e>xistence]/Inel<igibilityType
     > IneligibilityRe<ason[program_>member]/Inel<igibilityReason
  >  /<Ra>teInelig<ibility
  /RateRu>le
/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" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  RateRule id=>"<;membership_progr>am"<;
    RateIneligibi>lity
      Ine<ligibilityReasonprog>ram_mem<ber/Ineligibility>Reason
  <    Ineligi>bilityTypeex<istence/Ineligibil>ityTy<pe
    /RateIneli>gibilit<y
    UserRateCon>dition
      MembershipPr<ogram[enter progra>m nam<e here]/Membership>Pro<gram
    >/<UserRateCondition>
  /RateRule
/RateRuleSettings

隐藏成员费率的示例（多个条件）

op="any"

会员的受众群体名单费率 + 非会员的会员费率隐藏（存在折扣）

此私享费率示例指定了 existence 类型的会员费率隐藏界面处理方式，该费率将向用户显示，但不会向受众群体名单显示。受众群体名单中的用户将看到受众群体费率。

<?xml version="1.0" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  RateRule id=>"<;membership_progr>am"<;
    RateIneligibi>lity
      Ine<ligibilityReasonprog>ram_mem<ber/Ineligibility>Reason
  <    Ineligi>bilityTypeex<istence/Ineligibil>ityTy<pe
    /RateIneligibility
>    Use<rRateCondition op>="any"
      Me<mbershipProgram[en>ter pro<gram name >here]/MembershipProgram
      Use<rListId[ent>er yo<u audience list id> he<re]/UserL>i<stId
    /UserRat>eCondition
  /RateRule
/RateRuleSettings

op="all"

仅针对受众群体名单用户隐藏会员价格

此私人费率示例指定了 exact 类型的会员费率隐藏界面处理方式，并添加了“另有免费 Wi-Fi”这一附加文字。此界面处理方式将向符合受众群体名单条件的用户显示。

<?xml version="1.0" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  RateRule id="membership_p>rogra<m_for_audience_li>st"<;
    RateIneligibi>lity
      Ine<ligibilityReasonprog>ram_mem<ber/Ineligibility>Reaso<n
      Ineligibil>ityTy<peexact/Ineligibil>ityTy<pe
    /RateInel>igibili<ty
    RateM>odificati<on
      Hote>lAmen<ityfree_wifi/Hote>lAmen<ity
    /RateModification
>    Use<rRateCondition op>="all"
      Me<mbershipProgram[en>ter pro<gram name >here]/MembershipProgram
      Use<rListId[ent>er yo<u audience list id> he<re]/UserL>i<stId
    /UserRat>eCondition
  /RateRule
/RateRuleSettings

透明/可见界面

此示例展示了如何为受众群体列表中的用户指定两种界面处理方式（透明界面和可见界面）的会员价，并为所有其他用户指定隐藏价格。

<?xml version="1.0" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  RateRule id=>"<;membership_progr>am"<;
    RateIneligibi>lity
      Ine<ligibilityReasonprog>ram_mem<ber/Ineligibility>Reason
  <    Ineligi>bilityTypeex<istence/Ineligibil>ityTy<pe
    /RateIneligibility
>    Use<rRateCondition op>="any"
      Me<mbershipProgram[en>ter pro<gram name here]/Membership>Program
 <     UserRateCondition op="all"
 <       UserListId[en<ter you audience list id here]/>UserListId
 <       AlwaysEligibleMemb>ershipProgramp<rogram_name/Always>Eligi<bleMembershipProgr>am
<      /Us>e<rRateCondition
  >  /UserRateCondition
  /RateRule
/RateRuleSettings

`<RateModification>`

修改了不公开费率的界面处理方式。

在费率规则 XML 层次结构中，<RateModification> 元素显示在以下位置：

+ 
<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" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  RateRule id=>"<;membership_progr>am"<;
    RateIneligibi>lity
      Ine<ligibilityReasonprog>ram_mem<ber/Ineligibility>Reason
   <   Ineligib>ilityTypepri<ce_band/Ineligibil>ityTy<pe
    /RateInel>igibili<ty
    RateM>odificati<on
      Hote>lAmen<ityfree_wifi/Hote>lAmen<ity
    /RateModi>ficatio<n
    UserRateCon>dition
      MembershipPr<ogram[enter progra>m nam<e here]/Membership>Pro<gram
    >/<UserRateCondition>
  /RateRule
/RateRuleSettings

价格调节系数

对价格 Feed 中的移动设备专属费率应用 5% 的折扣

<?xml version="1.0" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  >RateR<ule id="mob>ile&quo<t;
    RateModi>fica<tion
      Price>Multi<plier0.95/PriceMu>ltipl<ier
    /RateModi>ficatio<n
    UserRate>Condit<ion
      UserD>evice<Typemobile/UserDev>ice<Type
    >/<UserRateCondition>
  /RateRule
/RateRuleSettings

直售优惠

在价格 Feed 中对移动设备直接预订优惠费率应用 15% 的折扣

<?xml version="1.0" encodin>g<="UTF-8&quo>t;?<
RateRuleSettings
  Rat>eRule< id="do-mob>ile&quo<t;
    RateModi>fica<tion
      Price>Multi<plier0.85/PriceMu>ltipl<ier
    /RateModi>ficatio<n
    UserRate>Condit<ion
      UserD>eviceTy<pemobile/Us>erDeviceType<
      Packa>geTyp<edirect_offer/Pack>age<Type
    >/<UserRateCondition>
  /RateRule
/RateRuleSettings

费率规则 XML 参考 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

<RateRuleSettings>

语法

属性

子元素

条件式价格示例

移动设备用户

美国用户

<RateRule>

语法

属性

子元素

<UserRateCondition>

语法

属性

子元素

条件式价格示例

用户百分比

英国用户和移动设备用户

日本和非日本

任意、全部和无

非公开价格示例

显示会员费率 1

显示会员费率 2

受众群体名单费率 1

受众群体名单费率 2

<RateIneligibility>

语法

属性

子元素

非公开价格示例

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

确切折扣

频段折扣

提示折扣

隐藏成员费率的示例（多个条件）

op="any"

op="all"

透明/可见界面

<RateModification>

属性

子元素

非公开价格示例

酒店设施

价格调节系数

直售优惠

费率规则 XML 参考

`<RateRuleSettings>`

`<RateRule>`

`<UserRateCondition>`

`<RateIneligibility>`

`<RateModification>`