이 페이지는 Cloud Translation API를 통해 번역되었습니다.

요금 규칙 XML 참조

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

각 요금 규칙에는 거래 메시지의 <Rate>에서 참조할 수 있는 id가 필요합니다. 요금 규칙 ID를 참조하는 <Rate>는 요금 규칙에서 정의한 조건을 충족하는 사용자에게만 사용자에게 제공됩니다. 요금 규칙 ID는 방문 페이지 URL의 변수를 사용하여 참조할 수도 있습니다.

`<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>`	조건부 요금 또는 특별 요금을 제공하기 위한 일치 조건, 수정, 자격 요건을 정의합니다. 거래 메시지의 `<Rate>` 또는 방문 페이지 URL에서 참조할 수 있는 `id` 속성이 필요합니다.
`<UserRateCondition>`	Optional	`<UserRateCondition>`	일치 시 조건부 요금 또는 특별 요금이 제공되는 하나 이상의 조건을 정의합니다. 조건은 `<UserRateCondition>` 하위 요소를 사용하여 인라인으로 정의하거나 `reference_id` 속성을 사용하여 다른 `<UserRateCondition>` 요소를 참조하거나 인라인 및 참조로 정의할 수 있습니다. 그러나 `reference_id`가 있는 모든 `<UserRateCondition>`에는 하위 요소가 0개 있어야 합니다. `<RateRuleSettings>` 아래의 최상위 `<UserRateCondition>`에는 `id` 속성이 있어야 합니다.

<RateRule>

Required

<RateRule>

조건부 요금 또는 특별 요금을 제공하기 위한 일치 조건, 수정, 자격 요건을 정의합니다. 거래 메시지의 <Rate> 또는 방문 페이지 URL에서 참조할 수 있는 id 속성이 필요합니다.

<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`	필수 항목	string	요금 규칙의 고유 식별자입니다. 이 ID는 조건부 요금 또는 특별 요금을 제공하기 위해 거래 메시지에서 `<Rate>`의 `rate_rule_id` 속성을 사용하여 참조됩니다. 요금 규칙 `id`은 방문 페이지 URL의 변수 및 조건을 사용하여 참조할 수도 있습니다. 허용되는 최대 문자 수는 40자(영문 기준)입니다.

id

필수 항목

string

요금 규칙의 고유 식별자입니다. 이 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`: 이 요금 규칙에서 정의한 모든 조건과 일치하는 최종 사용자를 포함합니다. 다른 조건(`<AlwaysEligibleMembershipProgram>` 또는 `<MembershipProgram>`) 하나만 정의된 경우가 아니면 조건 중 하나가 `<UserListId>`이면 이 값을 사용할 수 없습니다. `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: 이 요금 규칙에서 정의한 모든 조건과 일치하는 최종 사용자를 포함합니다. 다른 조건(<AlwaysEligibleMembershipProgram> 또는 <MembershipProgram>) 하나만 정의된 경우가 아니면 조건 중 하나가 <UserListId>이면 이 값을 사용할 수 없습니다.
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>`	일치 시 조건부 요금 또는 특별 요금이 제공되는 하나 이상의 조건을 정의합니다. `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 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>

일본(일본 제외)

다음 조건부 요금 예에서는 일본의 사용자와 일치하는 요금 규칙과 나머지 국가 (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>를 사용하려면 <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~10% 할인' 또는 '10~15% 할인'과 같이 5포인트 단위로 표시됩니다. `existence`: 구체적이지 않은 힌트. 이 경우 다음과 같은 텍스트가 표시됩니다. '무료 등록 시 할인 혜택을 받으세요.' 특별 요금 세부정보 및 예시에서 UI 처리에 대해 자세히 알아보세요.
`<IneligibilityReason>`	Required	enum	유효한 값은 다음과 같습니다. `program_member`: 회원가 숨겨진 UI 처리를 사용하여 요금을 표시합니다.

<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="모두"

회원의 잠재고객 목록 요금 + 비회원의 회원 요금 숨김 (존재 할인)

이 특별 요금 예시에서는 숨겨진 회원 요금 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가 됩니다. 이렇게 하면 특정 요금 규칙이 있는 모든 요금에 할인을 적용할 수 있습니다.

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