料金ルール XML ファイルでは、限定価格を配信するためのルールを定義し、 非公開レートです。料金ルールの XML ファイルを追加または編集するには、 Hotel Center の [料金ルール] ページ。 限定価格と非公開レートについて詳しくは、以下をご覧ください。 限定価格と非公開レート。
各料金ルールには id
が必要です。これは
トランザクション メッセージの <Rate>
。<Rate>
:
ルールの ID を参照する場合、条件はユーザーにのみ配信されます。
ルールで定義されます。料金ルール 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> |
一致する条件、変更、適格性を定義します。
限定価格や非公開レートを提供する場合です |
<UserRateCondition> |
Optional | <UserRateCondition> |
一致した場合に返される 1 つ以上の条件を 限定価格や非公開レートが配信されます 条件は、Terraform を使用してインラインで定義することも、
|
限定価格の例
次の例は、限定価格を定義する基本的な方法を示しています。
モバイル ユーザーの例で示されている事前定義の条件の参照。 が推奨されます。
モバイル ユーザー
次の限定価格の例では、次に一致する料金ルールを定義しています。
事前定義の <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 は、
トランザクション内の 最大文字数は 40 文字です。 |
子要素
<RateRule>
要素には次の子要素があります。
子要素 | 必須 | 型 | 説明 |
---|---|---|---|
<RateIneligibility> |
Optional | <RateIneligibility> |
特定の UI 処理を決定する値を指定します。
<MembershipProgram> レート。
|
<UserRateCondition> |
Required | <UserRateCondition> |
一致した場合に返される 1 つ以上の条件を 限定価格や非公開レートが配信されます 条件は、 ただし、 |
<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 |
この |
op |
Optional | enum |
|
reference_id |
Optional | string |
この要素を、事前定義済みの別の参照として
|
子要素
<UserRateCondition>
要素には次の子要素があります。
子要素 | 必須 | 型 | 説明 |
---|---|---|---|
<AlwaysEligibleMembershipProgram> |
Optional | string | メンバー料金の表示 UI を使用することを指定します。 あります。 この要素の値には、任意のメンバーシップ プログラム名を指定できます。 |
<Description> |
Optional | string | <UserRateCondition> を記述します。これはドキュメント用です
その機能には影響しません。
|
<LanguageCode> |
Optional | string | 次の言語のユーザーに料金が適用されることを指定します。 この 2 文字の と一致します。 言語コード。 |
<MaxUsersPercent> |
Optional | float | この割合に対して料金がランダムに提供されることを指定します。 サポートします。 値は 0 ~ 100 の整数にする必要があります。対象 たとえば 20 に設定すると、エンドユーザーの 20% がターゲットに設定されます。 |
<MembershipProgram> |
Optional | string | メンバーシップ プログラムの UI 処理を料金に使用することを指定します
|
<UserRateCondition> |
Optional | <UserRateCondition> |
一致した場合に返される 1 つ以上の条件を 限定価格や非公開レートが配信されます
|
<UserCountry> |
Optional | string | CLDR
国コード(例: ユーザーが指定した国に居住する必要があることを指定します。 Google はエンドユーザーの国を IP アドレスから判断します。 |
<UserDeviceType> |
Optional | enum | デバイスタイプの条件を定義します。使用できる値は次のとおりです。
<ph type="x-smartling-placeholder">
|
<UserListId> |
Optional | string | オーディエンス リストの Google 広告ユーザーリスト ID。
この条件は次の場合にのみ使用できます
|
<UserSignedIn> |
Optional | boolean | ユーザーがログインする必要があるかどうかを指定するブール値
できます。値 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>
日本ではなく日本
次の限定価格の例は、以下に一致する料金ルールを 1 つ示しています。 その他の料金ルールも適用されます。 世界(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
この非公開レートの例は、表示されるメンバー料金を指定する方法を示しています。 複数のオーディエンス リストの 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>
を使用するには、<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>
メンバー料金の非表示の例(複数の条件)
op="any"
メンバーのオーディエンス リスト料金 + 非表示のメンバー料金(存在割引) (メンバー以外の視聴者向け)
この非公開レートの例では、existence
タイプのメンバー料金を指定しています。
非表示の 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>
<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) 適用することもできます。
<?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 |
指定できる値は次のとおりです。
|
<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>