このページは Cloud Translation API によって翻訳されました。

料金ルールの XML リファレンス
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

料金ルール XML ファイルには、限定価格と非公開料金の提供に関するルールを定義します。料金ルール XML ファイルを追加または編集するには、Hotel Center の [料金ルール] ページを使用します。限定価格と非公開レートの詳細については、限定価格と非公開レートをご覧ください。

各レートルールには id が必要です。これは、トランザクションメッセージの <Rate> で参照できます。料金ルール ID を参照する <Rate> は、料金ルールで定義された条件に基づいて、ユーザーにのみ配信されます。料金ルール ID は、ランディングページの URL 内の変数を使用して参照することもできます。

`<RateRuleSettings>`

料金ルール XML ファイルのルート要素。<RateRuleSettings>（旧 <PrivateRates>）要素には次のものが含まれます。

限定価格と非公開レートの照合条件を定義する <UserRateCondition> 要素。たとえば、特定の国内のすべてのユーザーの条件に一致する限定価格を作成できます。
<RateRule> 要素: Transaction メッセージの <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>`	限定価格または非公開レートを提供する際の一致条件、変更、利用資格を定義します。`id` 属性が必要です。これは、トランザクションメッセージの `<Rate>` またはランディングページ URL で参照できます。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	一致すると限定価格または非公開レートが提供される 1 つ以上の条件を定義します。条件は、`<UserRateCondition>` 子要素を使用してインラインで定義するか、`reference_id` 属性を使用して別の `<UserRateCondition>` 要素を参照するか、インラインと参照の両方で定義できます。ただし、`reference_id` を含む `<UserRateCondition>` には子が 0 個必要です。 `<RateRuleSettings>` の下の最上位の `<UserRateCondition>` には `id` 属性が必要です。

<RateRule>

Required

<RateRule>

限定価格または非公開レートを提供する際の一致条件、変更、利用資格を定義します。id 属性が必要です。これは、トランザクションメッセージの <Rate> またはランディングページ URL で参照できます。

<UserRateCondition>

Optional

<UserRateCondition>

一致すると限定価格または非公開レートが提供される 1 つ以上の条件を定義します。

条件は、<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>`

以下を指定するコンテナ。

レートを配信する条件
料金と料金の UI 処理の変更（該当する場合）
非公開レートの非表示 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 は、限定価格または非公開レートを提供するトランザクションメッセージの `<Rate>` の `rate_rule_id` 属性を使用して参照されます。料金ルール `id` は、ランディングページ URL の変数と条件を使用して参照することもできます。最大 40 文字まで使用できます。

id

必須

文字列

料金ルールの一意の識別子。この ID は、限定価格または非公開レートを提供するトランザクションメッセージの <Rate> の rate_rule_id 属性を使用して参照されます。料金ルール id は、ランディングページ URL の変数と条件を使用して参照することもできます。

最大 40 文字まで使用できます。

子要素

<RateRule> 要素には次の子要素があります。

子要素	必須	型	説明
`<RateIneligibility>`	Optional	`<RateIneligibility>`	`<MembershipProgram>` レートの特定の UI 処理を決定する値を指定します。 `<UserRateCondition>` で `<MembershipProgram>` が指定されている場合にのみ有効です。
`<UserRateCondition>`	Required	`<UserRateCondition>`	一致すると限定価格または非公開レートが提供される 1 つ以上の条件を定義します。条件は、`<UserRateCondition>` 子要素を使用してインラインで定義するか、`reference_id` 属性を使用して別の `<UserRateCondition>` を参照するか、インラインと参照の両方で定義できます。ただし、`<UserRateCondition>` が `<RateRule>` の子要素である場合、`<UserRateCondition>` 要素に `id` 属性を指定することはできず、別の `<UserRateCondition>` によって参照することもできません。
`<RateModification>`	Optional	`<RateModification>`	非公開レートの UI 処理を変更しました。
`<PromoCode>`	Optional	string	この料金ルールが適用された場合に料金に関連付けるコードを指定します。`PROMO-CODE` ランディングページ変数に反映されます。

`<UserRateCondition>`

一致すると、条件付きレートまたは非公開レートが提供される条件を 1 つ以上定義します。

<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`: この料金ルールで定義されたすべての条件に一致するエンドユーザーを含めます。条件の 1 つが `<UserListId>` の場合、他の条件（`<AlwaysEligibleMembershipProgram>` または `<MembershipProgram>`）が 1 つだけ定義されている場合を除き、この値は使用できません。 `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: この料金ルールで定義されたすべての条件に一致するエンドユーザーを含めます。条件の 1 つが <UserListId> の場合、他の条件（<AlwaysEligibleMembershipProgram> または <MembershipProgram>）が 1 つだけ定義されている場合を除き、この値は使用できません。
any: この料金ルールで定義されたいずれかの条件に一致するエンドユーザーを含めます。
none: この料金ルールで定義された条件のいずれかに一致するエンドユーザーを除外します。条件のいずれかが <UserListId> の場合、この値は使用できません。

reference_id

Optional

string

この要素を、一致する id を持つ別の事前定義された <UserRateCondition> への参照として定義します。

reference_id が存在する場合:

子要素が解析されない
id と op は指定しないでください

子要素

<UserRateCondition> 要素には次の子要素があります。

子要素	必須	型	説明
`<AlwaysEligibleMembershipProgram>`	Optional	string	メンバー料金の表示 UI 処理が料金で使用されることを指定します。この要素の値は、任意のメンバーシッププログラム名にすることができます。
`<Description>`	Optional	string	`<UserRateCondition>` の説明。これはドキュメント作成を目的としており、機能には影響しません。
`<LanguageCode>`	Optional	string	この 2 文字の言語コードと一致する言語を使用しているユーザーに料金が提示されることを指定します。
`<MaxUsersPercent>`	Optional	float	この割引率が、この割合のエンドユーザーにランダムに提供されることを指定します。値は 0 ～ 100 の整数（指定した値を含む）で指定してください。たとえば、20 はエンドユーザーの 20% をターゲットにします。
`<MembershipProgram>`	Optional	string	料金で、`<RateIneligibility>` の `<IneligibilityReason>` によって決定されるメンバーシッププログラムの UI 処理を使用することを指定します。 `<MembershipProgram>` を有効にするには、`<RateIneligibility>` を指定する必要があります。 `<MembershipProgram>` の値は、任意の会員プログラム名にできます。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	一致すると限定価格または非公開レートが提供される 1 つ以上の条件を定義します。 `reference_id` を含む `<UserRateCondition>` には子要素が 0 個必要です。
`<UserCountry>`	Optional	string	CLDR 国コード（`DE` や `FR` など）。国によっては、CLDR コードが 2 文字の ISO コードと同じではないことに注意してください。CLDR 地域コードはサポートされていません。ユーザーが指定された国に居住している必要があることを指定します。 Google は、エンドユーザーの IP アドレスからエンドユーザーの国を判定します。
`<UserDeviceType>`	Optional	enum	デバイスの種類の条件を定義します。指定できる値は次のとおりです。 `mobile` `desktop` `tablet`
`<UserListId>`	Optional	string	オーディエンスリストの Google 広告ユーザーリスト 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>

日本と日本以外

次の限定価格の例は、日本のユーザーに一致する料金ルールと、その他の国（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

この限定公開料金の例は、複数のオーディエンスリストに対してメンバー限定料金の表示 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	取り消し線が引かれた料金の横に表示されるテキストで、非表示の料金をどのように説明するかを定義します。指定できる値は次のとおりです。 `exact`: 割引率。「無料登録で X% オフ」のようなテキストが表示されます。 `price_band`: 割引範囲。「無料登録で X ～ Y% オフ」と表示されます。割引率が 1 ～ 5% の場合は、「最大 5% オフ」と表示されます。割引率が 5% よりも大きい場合は、5 ポイント刻みで表示されます（「5 ～ 10% オフ」、「10 ～ 15% オフ」など）。 `existence`: 具体的なヒントなし。この場合、「無料登録していただくと、割引価格をご利用いただけます」のようなテキストが表示されます。 UI 処理の詳細については、非公開レートの詳細と例をご覧ください。
`<IneligibilityReason>`	Required	enum	指定できる値は次のとおりです。 `program_member`: メンバー料金の非表示 UI 処理を使用して料金を表示します。

<IneligibilityType>

Required

enum

取り消し線が引かれた料金の横に表示されるテキストで、非表示の料金をどのように説明するかを定義します。

指定できる値は次のとおりです。

exact: 割引率。「無料登録で X% オフ」のようなテキストが表示されます。
price_band: 割引範囲。「無料登録で X ～ Y% オフ」と表示されます。割引率が 1 ～ 5% の場合は、「最大 5% オフ」と表示されます。割引率が 5% よりも大きい場合は、5 ポイント刻みで表示されます（「5 ～ 10% オフ」、「10 ～ 15% オフ」など）。
existence: 具体的なヒントなし。この場合、「無料登録していただくと、割引価格をご利用いただけます」のようなテキストが表示されます。

UI 処理の詳細については、非公開レートの詳細と例をご覧ください。

<IneligibilityReason>

Required

enum

指定できる値は次のとおりです。

program_member: メンバー料金の非表示 UI 処理を使用して料金を表示します。

非公開レートの例

このセクションでは、メンバー料金の非表示の例（基本）とメンバー料金の非表示の例（複数の条件）について説明します。メンバー限定料金をユーザーのサブセットに表示することもできます。例については、非公開レートの例をご覧ください。

メンバー料金（非表示）の例（基本）

正確な割引

<?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"

メンバー向けのオーディエンスリスト料金 + メンバー料金を非表示（存在割引）にする（メンバー以外）

この非公開レートの例では、メンバー限定料金の非表示 UI 処理の 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 タイプのメンバー限定料金の非表示 UI 処理を指定し、「無料 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

この例では、オーディエンスリスト内のユーザーに対して 2 つの UI 処理（透明な 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>`

非公開レートの UI 処理を変更しました。

<RateModification> 要素は、料金ルールの XML 階層内の次の場所にあります。

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

属性

<RateModification> 要素に属性はありません。

子要素

<RateModification> 要素には次の子要素があります。

子要素必須型説明

子要素	必須	型	説明
`<HotelAmenity>`	Optional	enum	`<MembershipProgram>` と `<RateIneligibility>` を組み合わせて、メンバー料金の非表示 UI 処理を変更します。指定できる値は次のとおりです。 `free_wifi`: テキストに `plus free wifi` を追加します。
`<PriceMultiplier>`	Optional	float	この値を基本料金、税金、手数料に掛けて、料金を変更します。たとえば、`PriceMultiplier` = 0.9、基本料金 = 100 ドル、税金 = 20 ドル、手数料 = 10 ドルの場合、乗数を適用すると、基本料金 = 90 ドル、税金 = 18 ドル、手数料 = 9 ドルとなります。これにより、特定の料金ルールを持つすべての料金に割引を適用できます。

<HotelAmenity>

Optional

enum

<MembershipProgram> と <RateIneligibility> を組み合わせて、メンバー料金の非表示 UI 処理を変更します。

指定できる値は次のとおりです。

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>

価格の乗数

料金フィードでモバイル料金に 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>

料金ルールの XML リファレンス コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

<RateRuleSettings>

構文

属性

子要素

限定価格の例

モバイル ユーザー

米国のお客様

<RateRule>

構文

属性

子要素

<UserRateCondition>

構文

属性

子要素

限定価格の例

ユーザーの割合

英国とモバイル ユーザー

日本と日本以外

任意、すべて、なし

非公開レートの例

メンバー料金を表示 1

メンバー料金を表示 2

オーディエンス リストのレート 1

オーディエンス リストのレート 2

<RateIneligibility>

構文

属性

子要素

非公開レートの例

メンバー料金（非表示）の例（基本）

正確な割引

バンドの割引

ヒント割引

メンバー料金（非表示）の例（複数の条件）

op="any"

op="all"

透明/可視 UI

<RateModification>

属性

子要素

非公開レートの例

ホテルの設備

価格の乗数

料金ルールの XML リファレンス
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

`<RateRuleSettings>`

モバイルユーザー

`<RateRule>`

`<UserRateCondition>`

英国とモバイルユーザー

オーディエンスリストのレート 1

オーディエンスリストのレート 2

`<RateIneligibility>`

`<RateModification>`