Dokumentacja XML reguł stawek

Plik XML reguł stawek określa reguły wyświetlania stawek warunkowych i stawek prywatnych. Plik XML reguł dotyczących ceny możesz dodać lub edytować na stronie Reguły dotyczące ceny w Hotel Center. Więcej informacji o cenach warunkowych i prywatnych znajdziesz w artykule Ceny warunkowe i prywatne.

Każda reguła ceny wymaga elementu id, do którego można się odwołać w elemencie <Rate> wiadomości o transakcji. <Rate>, która odwołuje się do identyfikatora reguły stawki, jest wyświetlana tylko użytkownikom i na warunkach określonych przez tę regułę. Do identyfikatora reguły stawki można się też odwoływać za pomocą zmiennej w adresie URL strony docelowej.

<RateRuleSettings>

Element główny pliku XML z regułami cen. Element <RateRuleSettings> (wcześniej <PrivateRates>) zawiera:

• <UserRateCondition> elementy, które określają warunki dopasowania w przypadku cen warunkowych i prywatnych. Możesz na przykład utworzyć stawkę warunkową, która będzie dopasowywana do wszystkich użytkowników w określonym kraju.

• Elementy <RateRule>, które definiują regułę stawki do wykorzystania w elemencie <Rate> w wiadomości Transaction. Każdy element <RateRule>określa warunki i sposób wyświetlania w interfejsie, które tworzą cenę warunkową lub prywatną.

Element <RateRuleSettings> pojawia się w następującym miejscu w hierarchii XML reguł stawek:

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

Składnia

Element <RateRuleSettings> ma tę składnię:

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

Atrybuty

Element <RateRuleSettings> nie ma żadnych atrybutów.

Elementy potomne

Element <RateRuleSettings> ma te elementy podrzędne:

Element podrzędny	Wymagany?	Typ	Opis
<RateRule>	Required	<RateRule>	Określa warunki dopasowywania, modyfikacje i kryteria kwalifikacji do wyświetlania ceny warunkowej lub prywatnej. Wymaga atrybutu id, do którego można się odwołać w atrybucie <Rate> wiadomości Transaction lub w  adresie URL strony docelowej.
<UserRateCondition>	Optional	<UserRateCondition>	Definiuje jeden lub więcej warunków, których spełnienie powoduje stosowanie stawek warunkowych lub prywatnych. Warunki można zdefiniować wbudowane za pomocą elementów podrzędnych <UserRateCondition>, przez odwołanie do innego elementu <UserRateCondition> za pomocą atrybutu reference_id lub wbudowane i przez odwołanie. Jednak każdy element <UserRateCondition> z atrybutem reference_id musi mieć 0 elementów podrzędnych. <UserRateCondition> najwyższego poziomu poniżej <RateRuleSettings> musi mieć atrybut id.

Przykłady stawek warunkowych

Poniższe przykłady pokazują podstawowe sposoby definiowania stawek warunkowych.

Zaleca się odwołanie się do wstępnie zdefiniowanych warunków, jak pokazano w przykładzie Użytkownicy urządzeń mobilnych.

Użytkownicy urządzeń mobilnych

Poniższy przykład stawek warunkowych definiuje regułę stawek, która pasuje do wszystkich użytkowników urządzeń mobilnych, odwołując się do wstępnie zdefiniowanego parametru <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>

Użytkownicy z USA

Poniższy przykład stawek warunkowych definiuje regułę stawek, która dopasowuje wszystkich użytkowników wyszukujących w USA, odwołując się do wstępnie zdefiniowanego parametru <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>

Kontener do określania:

• Warunki świadczenia usług
• Wszelkie zmiany ceny i sposobu wyświetlania stawki w interfejsie
• Wykorzystanie ukrytych interfejsów użytkownika w przypadku stawek prywatnych

Element <RateRule> pojawia się w następującym miejscu w hierarchii XML reguł stawek:

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

Składnia

Element <RateRule> używa następującej składni:

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

Ważne: obsługa list odbiorców (UserListId) w przypadku stawek prywatnych jest dostępna tylko w przypadku reklam. Nie są już dostępne

linki do rezerwacji.

Atrybuty

Element <RateRule> ma te atrybuty:

Atrybut	Wymagany?	Typ	Opis
id	Wymagany	ciąg znaków	Unikalny identyfikator reguły stawki. Do tego identyfikatora odwołuje się za pomocą atrybutu rate_rule_id <Rate> w komunikacie transakcji, aby podać stawkę warunkową lub prywatną. Do reguły stawki id można odwołać się również za pomocą zmiennej i warunków w adresie URL strony docelowej. Maksymalna liczba znaków wynosi 40. Ten identyfikator nie może być pustym ciągiem.

Elementy potomne

Element <RateRule> ma następujące elementy podrzędne:

Element podrzędny	Wymagany?	Typ	Opis
<RateIneligibility>	Optional	<RateIneligibility>	Określa wartości, które decydują o konkretnym sposobie wyświetlania w interfejsie stawki <MembershipProgram>. Obowiązuje tylko wtedy, gdy w parametrze <UserRateCondition> określono wartość <MembershipProgram>.
<UserRateCondition>	Required	<UserRateCondition>	Określa co najmniej 1 warunek, którego spełnienie powoduje wyświetlanie cen warunkowych lub prywatnych. Warunki można zdefiniować wbudowanie za pomocą elementów podrzędnych <UserRateCondition>, przez odwołanie do innego elementu <UserRateCondition> za pomocą atrybutu reference_id lub zarówno wbudowanie, jak i przez odwołanie. Pamiętaj jednak, że jeśli element <UserRateCondition> jest elementem podrzędnym elementu <RateRule>, nie może mieć atrybutu id ani nie może być elementem odwołującym się do innego elementu <UserRateCondition>.<UserRateCondition>
<RateModification>	Optional	<RateModification>	Zmienia sposób obsługi stawek prywatnych w interfejsie użytkownika.
<PromoCode>	Optional	string	Określa kod, który ma być powiązany ze stawką, jeśli ta reguła stawki jest stosowana. Odzwierciedlona w zmiennej PROMO-CODE strona docelowa.

<UserRateCondition>

Definiuje jeden lub więcej warunków, których spełnienie powoduje stosowanie stawek warunkowych lub prywatnych.

Element <UserRateCondition> występuje w tym miejscu w hierarchii XML reguł cen:

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

Składnia

Element <UserRateCondition> ma tę składnię:

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

Atrybuty

Element <UserRateCondition> ma te atrybuty:

Atrybut	Wymagany?	Typ	Opis
id	Required (if top-level under <RateRuleSettings>)	string	Unikalny identyfikator tego <UserRateCondition>. Można się do niego odwoływać za pomocą atrybutu <RateRule> id lub atrybutu <UserRateCondition> reference_id.
op	Optional	enum	Atrybut op jest wymagany, gdy element <UserRateCondition> ma wiele elementów podrzędnych. Wartość atrybutu może być jedną z tych opcji: all: uwzględnia użytkowników, którzy spełniają wszystkie warunki określone w tej regule stawki. Tej wartości nie można używać, gdy jednym z warunków jest <UserListId>, chyba że zdefiniowany jest tylko jeden inny warunek – <AlwaysEligibleMembershipProgram> lub <MembershipProgram>. any: uwzględnia użytkowników, którzy spełniają dowolny z warunków określonych w tej regule stawki. none: Wyklucz użytkowników końcowych, którzy spełniają którykolwiek z warunków zdefiniowanych przez tę regułę stawki. Tej wartości nie można użyć, gdy jeden z warunków jest spełniony: <UserListId>.
reference_id	Optional	string	Określa ten element jako odwołanie do innego predefiniowanego <UserRateCondition> z pasującym id. Gdy występuje reference_id: Elementy podrzędne nie są analizowane id i op nie powinny być obecne

Elementy potomne

Element <UserRateCondition> ma następujące elementy podrzędne:

Element podrzędny	Wymagany?	Typ	Opis
<AlwaysEligibleMembershipProgram>	Optional	string	Określa, że stawka będzie korzystała z widocznego interfejsu użytkownika dla stawki członkowskiej. Wartością tego elementu może być dowolna nazwa programu członkowskiego.
<Description>	Optional	string	Opisuje element <UserRateCondition>. Służy to tylko do celów dokumentacyjnych i nie ma wpływu na możliwości usługi.
<LanguageCode>	Optional	string	Określa, że stawka będzie oferowana użytkownikom, których język odpowiada dwuliterowemu kodowi języka. Uwaga>: Zaleca się używanie<UserCountry> zamiast<LanguageCode> gdziekolwiek to możliwe.
<MaxUsersPercent>	Optional	float	Określa, że stawka będzie oferowana losowo tej grupie procentowej użytkowników końcowych. Wartość musi być liczbą całkowitą z przedziału od 0 do 100 (włącznie). Na przykład 20 będzie skierowane do 20% użytkowników końcowych.
<MembershipProgram>	Optional	string	Określa, że stawka będzie korzystać z interfejsu użytkownika programu członkowskiego zgodnie z <IneligibilityReason> <RateIneligibility>. Aby <MembershipProgram> było prawidłowe, należy określić <RateIneligibility>. Wartością <MembershipProgram> może być dowolna nazwa programu wspierania.
<UserRateCondition>	Optional	<UserRateCondition>	Definiuje jeden lub więcej warunków, których spełnienie powoduje stosowanie stawek warunkowych lub prywatnych. <UserRateCondition> z reference_id nie może mieć 0 dzieci.
<UserCountry>	Optional	string	Kod kraju CLDR, np. DE lub FR. Pamiętaj, że w przypadku niektórych krajów kod CLDR nie jest taki sam jak dwuliterowy kod ISO. Kody regionów CLDR nie są obsługiwane. Określa, że użytkownik musi znajdować się w określonym kraju. Google określa kraj użytkownika końcowego na podstawie jego adresu IP.
<UserDeviceType>	Optional	enum	Definiuje warunek typu urządzenia. Dozwolone wartości to: mobile desktop tablet
<UserListId>	Optional	string	Identyfikator listy użytkowników Google Ads dla listy odbiorców. Ten warunek można stosować tylko w przypadku <AlwaysEligibleMembershipProgram> lub <MembershipProgram> albo gdy op ma wartość any.
<UserSignedIn>	Optional	boolean	Wartość logiczna określająca, czy użytkownik musi być zalogowany na swoje konto Google. Wartość true oznacza, że użytkownik musi być zalogowany. Wartość false oznacza, że użytkownik nie może być zalogowany. Jeśli nie ma dla Ciebie znaczenia, czy użytkownik jest zalogowany, czy nie, nie uwzględniaj warunku <UserSignedIn>.
<IsDomestic>	Optional	boolean	Wartość logiczna określająca, czy użytkownik musi pochodzić z tego samego kraju, w którym znajduje się hotel. Wartość true oznacza, że użytkownik musi pochodzić z tego samego kraju co hotel. Wartość false oznacza, że użytkownik może pochodzić z dowolnego kraju innego niż kraj, w którym znajduje się hotel. Jeśli chcesz mieć większą kontrolę, użyj warunku <UserCountry>.

Przykłady cen warunkowych

Odsetek użytkowników

W tym przykładzie cen warunkowych określono, że cena będzie oferowana losowo 20% użytkowników:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="20_percent_users">
    <UserRateCondition>
      <MaxUsersPercent>20</MaxUsersPercent>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

Użytkownicy z Wielkiej Brytanii i użytkownicy urządzeń mobilnych

Ten przykład stawek warunkowych definiuje regułę stawek, która pasuje do wszystkich użytkowników wyszukujących w Wielkiej Brytanii na urządzeniach mobilnych. W tym celu używa wbudowanego warunku <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>

Japonia i inne kraje

Poniższy przykład stawek warunkowych pokazuje jedną regułę stawek, która pasuje do użytkowników w Japonii, i drugą regułę stawek, która pasuje do użytkowników w pozostałych krajach:

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

Dowolne, wszystkie i żadne

Poniższy przykład stawek warunkowych pokazuje, jak atrybut op może być używany do dopasowywania wielu warunków na różne sposoby za pomocą wartości any, all i none. Na przykład, jak pokazano w au_nzwarunku, możesz użyć dowolnego kraju, aby dopasować użytkowników w dowolnym z kilku krajów. Jak widać w au_nz_mobile_tablet regule stawki, możesz użyć symbolu all, aby wymagać od użytkowników spełnienia kilku warunków. Reguła ceny row_mobile_tablet będzie pasować do użytkowników z pozostałych części świata (wiersz) z wyłączeniem Australii i Nowej Zelandii, którzy spełniają też warunek 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>

Przykłady cen prywatnych

Stawka członkowska widoczna 1

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="member_visible">
    <UserRateCondition>
      <AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

Stawka członkowska widoczna 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>

Stawka listy odbiorców 1

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="audience_list">
    <UserRateCondition>
      <UserListId>[enter an audience list id]</UserListId>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

Stawka listy odbiorców 2

Ten przykład cen prywatnych pokazuje, jak określić cenę dla uczestników programu widoczną w interfejsie dla wielu list odbiorców:

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

Wskazuje, jak wyświetlać ukryty interfejs ceny dla uczestników programu. Jeśli nie jest uwzględniona, interfejs ukrywający cenę dla subskrybentów nie jest wyświetlany.

Aby użyć elementu <RateIneligibility> w elemencie <RateRule>, w elemencie <UserRateCondition> dla elementu <RateRule> musi być też określony element <MembershipProgram>.

Element <RateIneligibility> występuje w tym miejscu w hierarchii XML reguł cenowych:

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

Składnia

Element <RateIneligibility> używa następującej składni:

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

Atrybuty

Element <RateIneligibility> nie ma żadnych atrybutów.

Elementy potomne

Element <RateIneligibility> ma te elementy podrzędne:

Element podrzędny	Wymagany?	Typ	Opis
<IneligibilityType>	Required	enum	Określa, jak tekst (wyświetlany obok przekreślonej ceny) będzie opisywać ukrytą cenę. Prawidłowe wartości to: exact: procent rabatu. Tekst będzie brzmiał: „Zapisz się bezpłatnie, aby uzyskać X% zniżki”. price_band: zakres rabatu. Tekst będzie brzmiał: „Zapisz się bezpłatnie, aby uzyskać zniżkę w wysokości X–Y%”. W przypadku rabatów w wysokości 1–5% tekst będzie brzmiał „Otrzymaj do 5% zniżki”. Większe zniżki będą wyświetlane w 5-punktowych przedziałach, np. „Zyskaj 5–10% zniżki” lub „Zyskaj 10–15% zniżki”. existence: nieokreślona wskazówka. W tym przypadku tekst będzie brzmiał: „Zapisz się bezpłatnie, aby uzyskać niższą cenę”. Dowiedz się więcej o metodach leczenia UI w szczegółach i przykładach stawek prywatnych.
<IneligibilityReason>	Required	enum	Prawidłowe wartości to: program_member: wyświetla cenę z użyciem ukrytego elementu interfejsu ceny dla uczestników programu.

Przykłady cen prywatnych

Ta sekcja zawiera przykłady ukrytych cen dla uczestników programu (podstawowe) i przykłady ukrytych cen dla uczestników programu (wiele warunków). Możesz też wyświetlać ceny dla uczestników programu lojalnościowego wybranym grupom użytkowników. Aby wyświetlać ceny dla uczestników programu, najpierw prześlij pojedynczą cenę dla uczestników programu za najtańszy pakiet pokoju, a następnie ceny pozostałych pakietów pokoju. Stosowanie wielu cen dla uczestników programu jest niedozwolone.

Przykłady znajdziesz w artykule Przykłady cen prywatnych.

Przykłady ukrytych stawek dla członków programu (podstawowe)

Dokładny rabat

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

Rabat dla zespołu

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

Rabat na podpowiedź

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

Przykłady ukrytych cen dla uczestników programu (wiele warunków)

op="any"

Stawka za listę odbiorców dla członków + ukryta stawka za członka (zniżka za istnienie) dla osób niebędących członkami

Ten przykład cen prywatnych określa existence typ ceny dla członków ukryty w interfejsie, który będzie widoczny dla użytkowników, a nie dla listy odbiorców. Użytkownicy na liście odbiorców zobaczą stawkę dla odbiorców.

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

Stawka dla członków programu ukryta tylko dla użytkowników list odbiorców

Ten przykład ceny prywatnej określa typ exact ukrytej ceny dla uczestników programu, zmodyfikowany o dodatkowy tekst „plus bezpłatne Wi-Fi”. Ten element interfejsu będzie widoczny dla użytkowników, którzy pasują do listy odbiorców.

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

Przezroczysty/widoczny interfejs

W tym przykładzie pokazano, jak określić stawkę członkowską za pomocą dwóch interfejsów użytkownika (przezroczystego i widocznego) dla użytkowników z listy odbiorców oraz ukrytych stawek dla wszystkich pozostałych użytkowników.

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

Uwaga: gdy UserListId ma wartość true, warunek AlwaysEligibleMembershipProgram jest wypełniany razem, co powoduje wyświetlenie ceny dla wspierających. Gdy ma wartość false, otaczający warunek UserRateCondition przyjmuje wartość false, co powoduje usunięcie warunku AlwaysEligibleMembershipProgram. W tym przypadku warunek ukrytej ceny dla członków –MembershipProgram–

wywołuje wszystkie niekwalifikujące się ceny.

<RateModification>

Zmienia sposób wyświetlania interfejsu użytkownika w przypadku stawek prywatnych.

Element <RateModification> występuje w tym miejscu w hierarchii XML reguł cen:

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

Atrybuty

Element <RateModification> nie ma żadnych atrybutów.

Elementy potomne

Element <RateModification> ma następujące elementy podrzędne:

Element podrzędny	Wymagany?	Typ	Opis
<HotelAmenity>	Optional	enum	Połącz z <MembershipProgram> i <RateIneligibility>, aby zmodyfikować ukryty interfejs użytkownika z ceną dla subskrybujących. Prawidłowe wartości to: free_wifi: dodaje do tekstu znak plus free wifi.
<PriceMultiplier>	Optional	float	Modyfikuje cenę, mnożąc tę wartość przez stawkę podstawową, podatki i opłaty. Jeśli na przykład PriceMultiplier = 0,9, stawka podstawowa = 100 zł, podatki = 20 zł, opłaty = 10 zł, to po zastosowaniu mnożnika: stawka podstawowa = 90 zł, podatki = 18 zł, opłaty = 9 zł. Dzięki temu możesz zastosować zniżkę do wszystkich stawek z określoną regułą stawki.

Przykłady cen prywatnych

Udogodnienia hotelowe

Stawka dla członków programu ukryta dla wszystkich użytkowników (zniżki w ramach pasma) + bezpłatne 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>

Mnożnik ceny

Zastosuj 5% rabat do cen na urządzenia mobilne w pliku danych o cenach

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="mobile">
    <RateModification>
      <PriceMultiplier>0.95</PriceMultiplier>
    </RateModification>
    <UserRateCondition>
      <UserDeviceType>mobile</UserDeviceType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>