요금 규칙 XML 참조

요금 규칙 XML 파일은 조건부 요금과 특별 요금을 제공하는 규칙을 정의합니다. Hotel Center의 요금 규칙 페이지를 사용하여 요금 규칙 XML 파일을 추가하거나 수정할 수 있습니다. 조건부 요금 및 특별 요금에 대한 자세한 내용은 조건부 요금 및 특별 요금을 참고하세요.

각 요금 규칙에는 id가 필요하며, 이는 거래 메시지의 <Rate>에서 참조할 수 있습니다. 요금 규칙 ID를 참조하는 <Rate>은 요금 규칙에 정의된 사용자에게만 해당 조건에 따라 게재됩니다. 방문 페이지 URL의 변수를 사용하여 요금 규칙 ID를 참조할 수도 있습니다.

<RateRuleSettings>

요금 규칙 XML 파일의 루트 요소입니다. <RateRuleSettings> (이전 <PrivateRates>) 요소에는 다음이 포함됩니다.

  • 조건부 요금 및 특별 요금에 대해 일치해야 하는 조건을 정의하는 <UserRateCondition> 요소입니다. 예를 들어 특정 국가의 모든 사용자의 조건과 일치하는 조건부 요금을 만들 수 있습니다.

  • 각각 트랜잭션 메시지의 <Rate>에서 참조할 요율 규칙을 정의하는 <RateRule> 요소 각 <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>

일치할 경우 조건부 또는 비공개 요금이 게재되는 하나 이상의 조건을 정의합니다.

조건은 <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자(영문 기준)입니다.

하위 요소

<RateRule> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소 필수 여부 유형 설명
<RateIneligibility> Optional <RateIneligibility> <MembershipProgram> 요금의 특정 UI 처리를 결정하는 값을 지정합니다.

<MembershipProgram><UserRateCondition>에 지정된 경우에만 유효합니다.

<UserRateCondition> Required <UserRateCondition>

일치할 경우 조건부 또는 비공개 요금이 게재되는 하나 이상의 조건을 정의합니다.

조건은 <UserRateCondition> 하위 요소를 사용하여 인라인으로 정의하거나, reference_id 속성을 사용하여 다른 <UserRateCondition>를 참조하거나, 인라인과 참조를 모두 사용하여 정의할 수 있습니다.

하지만 <UserRateCondition><RateRule>의 하위 요소인 경우 <UserRateCondition> 요소는 id 속성을 가질 수 없으며 다른 <UserRateCondition>에 의해 참조될 수 없습니다.

<RateModification> Optional <RateModification> 특별 요금의 UI 처리를 수정합니다.
<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가 있는 경우:

  • 하위 요소가 파싱되지 않음
  • idop이 있으면 안 됩니다.

하위 요소

<UserRateCondition> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소 필수 여부 유형 설명
<AlwaysEligibleMembershipProgram> Optional string

요금에 회원 요금 표시 UI 처리가 사용됨을 지정합니다.

이 요소의 값은 모든 멤버십 프로그램 이름이 될 수 있습니다.

<Description> Optional string <UserRateCondition>를 설명합니다. 이는 문서화 목적으로만 사용되며 기능에는 영향을 미치지 않습니다.
<LanguageCode> Optional string 언어가 이 두 글자 언어 코드와 일치하는 사용자에게 요금이 제공됨을 지정합니다.

참고>: 가능한 경우 <LanguageCode> 대신 <UserCountry>를 사용하는 것이 좋습니다.

<MaxUsersPercent> Optional float

이 비율의 최종 사용자에게 요금이 무작위로 제공됨을 지정합니다.

값은 0 이상 100 이하여야 합니다. 예를 들어 20은 최종 사용자의 20% 를 타겟팅합니다.

<MembershipProgram> Optional string

요율이 <RateIneligibility><IneligibilityReason>에 따라 결정된 멤버십 프로그램 UI 처리를 사용하도록 지정합니다.

<MembershipProgram>이 유효하려면 <RateIneligibility>을 지정해야 합니다.

<MembershipProgram> 값은 모든 멤버십 프로그램 이름이 될 수 있습니다.

<UserRateCondition> Optional <UserRateCondition>

일치할 경우 조건부 또는 비공개 요금이 게재되는 하나 이상의 조건을 정의합니다.

reference_id이 있는 <UserRateCondition>에는 하위 요소가 0개여야 합니다.

<UserCountry> Optional string

DE 또는 FR과 같은 CLDR 국가 코드입니다. 일부 국가의 경우 CLDR 코드가 2자리 ISO 코드와 동일하지 않습니다. CLDR 지역 코드는 지원되지 않습니다.

사용자가 지정된 국가에 있어야 함을 지정합니다. Google은 IP 주소에서 최종 사용자의 국가를 확인합니다.

<UserDeviceType> Optional enum 기기 유형 조건을 정의합니다. 허용되는 값은 다음과 같습니다.
  • mobile
  • desktop
  • tablet
<UserListId> Optional string 잠재고객 목록의 Google Ads 사용자 목록 ID입니다.

이 조건은 <AlwaysEligibleMembershipProgram> 또는 <MembershipProgram>와 함께 사용하거나 opany인 경우에만 사용할 수 있습니다.

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

Any, all, none

다음 조건부 요율 예에서는 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>를 사용하려면 <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

텍스트 (취소선이 그어진 요금 옆에 표시됨)가 숨겨진 요금을 설명하는 방식을 정의합니다.

유효한 값은 다음과 같습니다.

  • exact: 할인율입니다. 텍스트에는 '무료 등록 시 X% 할인 제공'이라고 표시됩니다.
  • price_band: 할인 범위입니다. 텍스트에는 '무료 등록 시 X~Y% 할인 제공'이라고 표시됩니다. 1~5% 할인의 경우 텍스트에는 '최대 5% 할인'이 표시됩니다. 더 큰 폭의 할인율은 '5~10% 할인' 또는 '10~15% 할인'과 같이 5포인트 단위로 표시됩니다.
  • 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"

잠재고객 목록 사용자에게만 회원 요금 숨김

이 비공개 요금 예시에서는 추가 텍스트 '무료 Wi-Fi 포함'으로 수정된 숨겨진 회원 요금 UI 처리의 exact 유형을 지정합니다. 이 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

이 예에서는 잠재고객 목록의 사용자에 대해 두 가지 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달러가 됩니다.

이렇게 하면 특정 요금 규칙이 있는 모든 요금에 할인을 적용할 수 있습니다.

특별 요금 예시

호텔 편의시설

모든 사용자에게 회원 요금 숨김 (밴드 할인) + 무료 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>