Riferimento XML per le regole tariffarie

Il file XML delle regole tariffarie definisce le regole per la pubblicazione delle tariffe agevolate e delle tariffe private. Puoi aggiungere o modificare un file XML delle regole tariffarie utilizzando la pagina Regole tariffarie in Hotel Center. Per ulteriori informazioni sulle tariffe agevolate e private, consulta Tariffe agevolate e private.

Ogni regola tariffaria richiede un id, a cui è possibile fare riferimento in un <Rate> di un messaggio Transaction. Un elemento <Rate> che fa riferimento a un ID regola tariffaria viene pubblicato solo per gli utenti e alle condizioni definite dalla regola tariffaria. È possibile fare riferimento a un ID regola tariffaria anche utilizzando una variabile in un URL pagina di destinazione.

<RateRuleSettings>

L'elemento principale del file XML delle regole tariffarie. L'elemento <RateRuleSettings> (in precedenza <PrivateRates>) contiene:

• Elementi <UserRateCondition> che definiscono le condizioni per la corrispondenza delle tariffe agevolate e private. Ad esempio, puoi creare una tariffa agevolata che corrisponda alla condizione per tutti gli utenti in un determinato paese.

• Elementi <RateRule>, ciascuno dei quali definisce una regola tariffaria a cui fare riferimento in un <Rate> in un messaggio Transaction. Ogni elemento <RateRule> specifica le condizioni e l'opzione di interfaccia utente che creano una tariffa agevolata o privata.

L'elemento <RateRuleSettings> compare nella seguente posizione nella gerarchia XML delle regole tariffarie:

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

Sintassi

L'elemento <RateRuleSettings> utilizza la seguente sintassi:

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

Attributi

L'elemento <RateRuleSettings> non ha attributi.

Elementi secondari

L'elemento <RateRuleSettings> ha i seguenti elementi secondari:

Elemento secondario	Campo obbligatorio?	Tipo	Descrizione
<RateRule>	Required	<RateRule>	Definisce le condizioni di corrispondenza, le modifiche e l'idoneità per la pubblicazione di una tariffa agevolata o privata. Richiede un attributo id a cui è possibile fare riferimento in un elemento <Rate> di un messaggio Transaction o in un URL pagina di destinazione.
<UserRateCondition>	Optional	<UserRateCondition>	Definisce una o più condizioni che, se soddisfatte, comportano la pubblicazione di tariffe agevolate o private. Le condizioni possono essere definite in linea utilizzando gli elementi secondari <UserRateCondition>, mediante un riferimento a un altro elemento <UserRateCondition> tramite l'attributo reference_id oppure sia in linea che tramite riferimento. Tuttavia, tutti gli elementi <UserRateCondition> con reference_id devono avere 0 elementi secondari. Un elemento <UserRateCondition> di primo livello in <RateRuleSettings> deve avere un attributo id.

Esempi di tariffe agevolate

I seguenti esempi mostrano i metodi di base per definire le tariffe agevolate.

È consigliabile fare riferimento alle condizioni predefinite, come mostrato nell'esempio Utenti di dispositivi mobili.

Utenti di dispositivi mobili

Il seguente esempio di tariffe agevolate definisce una regola tariffaria che corrisponde a tutti gli utenti di dispositivi mobili facendo riferimento a un valore <UserRateCondition> predefinito:

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

Utenti negli Stati Uniti

Il seguente esempio di tariffe agevolate definisce una regola tariffaria che corrisponde a tutti gli utenti che eseguono ricerche negli Stati Uniti facendo riferimento a un valore <UserRateCondition> predefinito:

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

Un contenitore per specificare:

• Condizioni per la pubblicazione di una tariffa
• Eventuali modifiche al prezzo e all'opzione di interfaccia utente per la tariffa
• Utilizzo di trattamenti di interfaccia utente nascosti per le tariffe private

L'elemento <RateRule> compare nella seguente posizione nella gerarchia XML delle regole tariffarie:

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

Sintassi

L'elemento <RateRule> utilizza la seguente sintassi:

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

Punto chiave: il supporto degli elenchi del segmento di pubblico (UserListId) per le tariffe private è disponibile solo per gli annunci. Non è più disponibile per i link di prenotazione gratuiti.

Attributi

L'elemento <RateRule> ha i seguenti attributi:

Attributo	Campo obbligatorio?	Tipo	Descrizione
id	Obbligatorio	stringa	Un identificatore univoco della regola tariffaria. A questo ID viene fatto riferimento tramite l'attributo rate_rule_id di un <Rate> in un messaggio Transaction per pubblicare una tariffa agevolata o privata. È possibile fare riferimento alla regola tariffaria id anche mediante una variabile e condizioni in un URL pagina di destinazione. Il numero massimo di caratteri consentiti è 40.

Elementi secondari

L'elemento <RateRule> ha i seguenti elementi secondari:

Elemento secondario	Campo obbligatorio?	Tipo	Descrizione
<RateIneligibility>	Optional	<RateIneligibility>	Specifica i valori che determinano la specifica opzione di interfaccia utente per una tariffa di <MembershipProgram>. Valido solo quando <MembershipProgram> è specificato in <UserRateCondition>.
<UserRateCondition>	Required	<UserRateCondition>	Definisce una o più condizioni che, se soddisfatte, comportano la pubblicazione di tariffe agevolate o private. Le condizioni possono essere definite in linea utilizzando gli elementi secondari <UserRateCondition>, mediante un riferimento a un altro <UserRateCondition> tramite l'attributo reference_id oppure sia in linea che tramite riferimento. Tuttavia, tieni presente che quando <UserRateCondition> è un elemento secondario di <RateRule>, l'elemento <UserRateCondition> non può avere un attributo id e un altro elemento <UserRateCondition> non può fare riferimento.
<RateModification>	Optional	<RateModification>	Modifica l'opzione di interfaccia utente per le tariffe private.
<PromoCode>	Optional	string	Specifica un codice da associare alla tariffa se viene applicata questa regola tariffaria. Si riflette nella variabile della pagina di destinazione PROMO-CODE.

<UserRateCondition>

Definisce una o più condizioni che, se soddisfatte, generano tariffe agevolate o private.

L'elemento <UserRateCondition> compare nella seguente posizione nella gerarchia XML delle regole tariffarie:

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

Sintassi

L'elemento <UserRateCondition> utilizza la seguente sintassi:

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

Attributi

L'elemento <UserRateCondition> ha i seguenti attributi:

Attributo	Campo obbligatorio?	Tipo	Descrizione
id	Required (if top-level under <RateRuleSettings>)	string	Un identificatore univoco di <UserRateCondition>. Può fare riferimento a un attributo id <RateRule> o a un attributo reference_id <UserRateCondition>.
op	Optional	enum	L'attributo op è obbligatorio quando <UserRateCondition> ha più elementi secondari. Il valore dell'attributo può essere uno dei seguenti: all: includi gli utenti finali che soddisfano tutte le condizioni definite da questa regola tariffaria. Questo valore non può essere utilizzato quando una delle condizioni è <UserListId>, a meno che non sia definita una sola altra condizione, <AlwaysEligibleMembershipProgram> o <MembershipProgram>. any: includi gli utenti finali che soddisfano una qualsiasi delle condizioni definite da questa regola tariffaria. none: per escludere gli utenti finali che soddisfano una qualsiasi delle condizioni definite da questa regola tariffaria. Questo valore non può essere utilizzato quando una delle condizioni è <UserListId>.
reference_id	Optional	string	Definisce questo elemento come riferimento a un altro elemento <UserRateCondition> predefinito con un valore id corrispondente. Quando è presente reference_id: Gli elementi secondari non vengono analizzati id e op non devono essere presenti

Elementi secondari

L'elemento <UserRateCondition> ha i seguenti elementi secondari:

Elemento secondario	Campo obbligatorio?	Tipo	Descrizione
<AlwaysEligibleMembershipProgram>	Optional	string	Specifica che la tariffa utilizzerà l'opzione di interfaccia utente visibile della tariffa per membri. Il valore di questo elemento può essere qualsiasi nome di programma di abbonamento.
<Description>	Optional	string	Descrive il <UserRateCondition>. È a scopo di documentazione e non ha alcun effetto sulle sue funzionalità.
<LanguageCode>	Optional	string	Specifica che la tariffa verrà offerta agli utenti la cui lingua corrisponde a questo codice lingua di due lettere.
<MaxUsersPercent>	Optional	float	Specifica che la tariffa verrà offerta in modo casuale a questa percentuale di utenti finali. Il valore deve essere un numero intero compreso tra 0 e 100 (inclusi). Ad esempio, 20 sceglierà come target il 20% degli utenti finali.
<MembershipProgram>	Optional	string	Specifica che la tariffa utilizzerà un'opzione di interfaccia utente del programma di abbonamento, come stabilito da <IneligibilityReason> di <RateIneligibility>. Affinché <MembershipProgram> sia valido, è necessario specificare <RateIneligibility>. Il valore di <MembershipProgram> può essere qualsiasi nome di programma di abbonamento.
<UserRateCondition>	Optional	<UserRateCondition>	Definisce una o più condizioni che, se soddisfatte, comportano la pubblicazione di tariffe agevolate o private. Un elemento <UserRateCondition> con reference_id deve avere 0 elementi secondari.
<UserCountry>	Optional	string	Un codice paese CLDR, ad esempio DE o FR. Tieni presente che, per alcuni paesi, il codice CLDR non corrisponde al codice ISO a due lettere. I codici regione CLDR non sono supportati. Specifica che l'utente deve trovarsi nel paese specificato. Google determina il paese dell'utente finale dal suo indirizzo IP.
<UserDeviceType>	Optional	enum	Definisce la condizione del tipo di dispositivo. I valori consentiti sono: mobile desktop tablet
<UserListId>	Optional	string	L'ID elenco utenti Google Ads di un elenco del segmento di pubblico. Questa condizione può essere utilizzata solo con <AlwaysEligibleMembershipProgram> o <MembershipProgram> oppure quando op è any.
<UserSignedIn>	Optional	boolean	Un valore booleano che specifica se l'utente deve aver eseguito o meno l'accesso al proprio Account Google. Il valore true indica che l'utente deve aver eseguito l'accesso. Un valore false indica che l'utente non deve aver eseguito l'accesso. Se non ti interessa se l'utente ha eseguito o meno l'accesso, non includere una condizione <UserSignedIn>.
<IsDomestic>	Optional	boolean	Un valore booleano che specifica se l'utente deve trovarsi o meno nello stesso paese in cui si trova l'hotel. Un valore true indica che l'utente deve trovarsi nello stesso paese dell'hotel. Un valore false indica che l'utente può trovarsi in qualsiasi paese diverso da quello dell'hotel. Per un controllo più granulare, utilizza la condizione <UserCountry>.

Esempi di tariffe agevolate

Percentuale di utenti

Il seguente esempio di tariffe agevolate specifica che la tariffa verrà offerta in modo casuale al 20% degli utenti:

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

Utenti del Regno Unito e di dispositivi mobili

Il seguente esempio di tariffe agevolate definisce una regola tariffaria che corrisponde a tutti gli utenti che effettuano ricerche nel Regno Unito con un dispositivo mobile utilizzando un elemento <UserRateCondition> in linea:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="gb_mobile">
    <UserRateCondition op="all">
      <UserCountry>GB</UserCountry>
      <UserDeviceType>mobile</UserDeviceType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

Giappone e non in Giappone

Il seguente esempio di tariffe agevolate mostra una regola tariffaria che corrisponde agli utenti in Giappone e un'altra regola tariffaria che corrisponde agli utenti nel resto del mondo (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>

Qualsiasi, tutti e nessuno

Il seguente esempio di tariffe agevolate mostra come l'attributo op può essere utilizzato per trovare una corrispondenza con più condizioni in modi diversi utilizzando i valori any, all e none. Ad esempio, come mostrato nella condizione au_nz, puoi utilizzare "qualsiasi" per associare gli utenti in uno qualsiasi di più paesi. Come mostrato nella regola tariffaria au_nz_mobile_tablet, puoi utilizzare all per richiedere che gli utenti soddisfino più condizioni. La regola tariffaria row_mobile_tablet corrisponderà agli utenti che si trovano nel resto del mondo (riga), tranne Australia e Nuova Zelanda, e che soddisfano anche la condizione 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>

Esempi di tariffe private

Tariffa membro visibile 1

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

Tariffa membro visibile 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>

Tariffa di elenco del segmento di pubblico 1

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

Tariffa di elenco del segmento di pubblico 2

Questo esempio di tariffe private mostra come specificare un trattamento visibile nell'interfaccia utente della tariffa per membri per più elenchi dei segmenti di pubblico:

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

Indica come visualizzare l'opzione di interfaccia utente della tariffa per i membri nascosta. Se non viene inclusa, l'opzione di interfaccia utente con tariffa per membri nascosta non viene visualizzata.

Per utilizzare <RateIneligibility> in un <RateRule>, è necessario specificare anche <MembershipProgram> in un elemento <UserRateCondition> per <RateRule>.

L'elemento <RateIneligibility> compare nella seguente posizione nella gerarchia XML delle regole tariffarie:

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

Sintassi

L'elemento <RateIneligibility> utilizza la seguente sintassi:

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

Attributi

L'elemento <RateIneligibility> non ha attributi.

Elementi secondari

L'elemento <RateIneligibility> ha i seguenti elementi secondari:

Elemento secondario	Campo obbligatorio?	Tipo	Descrizione
<IneligibilityType>	Required	enum	Definisce in che modo il testo (visualizzato accanto alla tariffa barrata) descriverà la tariffa nascosta. I valori validi sono: exact: una percentuale di sconto. Il testo sarà "Sconto del X% con l'iscrizione senza costi". price_band: un intervallo di sconto. Il testo sarà "Sconto dal X% al Y% con l'iscrizione senza costi". Per sconti dall'1 al 5%, il testo sarà "Sconto del 5% fino al 5%". Gli sconti maggiori verranno mostrati con incrementi di 5 punti, ad esempio "Sconto del 5-10%" o "Sconto del 10-15%". existence: un suggerimento non specifico. In questo caso, il testo sarà: "Tariffa ridotta con l'iscrizione senza costi". Scopri di più sulle opzioni di interfaccia utente nella sezione Dettagli ed esempi di tariffe private.
<IneligibilityReason>	Required	enum	I valori validi sono: program_member: mostra la tariffa utilizzando l'opzione di interfaccia utente nascosta della tariffa per i membri.

Esempi di tariffe private

Questa sezione include esempi nascosti di tariffe per i membri (di base) e esempi nascosti di tariffe per membri (più condizioni). Puoi anche mostrare le tariffe per i membri a sottoinsiemi di utenti. Per alcuni esempi, consulta la sezione Esempi di tariffe private.

Esempi di tariffe nascoste per i membri (base)

Sconto esatto

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

Sconto cinturino

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

Sconto per suggerimenti

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

Esempi di tariffe per membri nascosti (più condizioni)

op="any"

Tariffa dell'elenco del segmento di pubblico per membri + tariffa per membri nascosta (sconto esistente) per i non membri

Questo esempio di tariffe private specifica il tipo existence di opzione dell'interfaccia utente nascosta della tariffa per membri, che verrà mostrata agli utenti e non all'elenco del segmento di pubblico. Gli utenti nell'elenco del segmento di pubblico vedranno la percentuale del segmento di pubblico.

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

Tariffa per membri nascosta solo per gli utenti dell'elenco del segmento di pubblico

Questo esempio di tariffa privata specifica il tipo exact di trattamento UI nascosta della tariffa per membri, modificato con il testo aggiuntivo "più Wi-Fi gratuito". Questa opzione di interfaccia utente verrà mostrata agli utenti che corrispondono all'elenco del segmento di pubblico.

<?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 trasparente/visibile

Questo esempio mostra come specificare la tariffa per i membri con due opzioni di interfaccia utente (UI trasparente e visibile) per gli utenti nell'elenco del segmento di pubblico e tariffe nascoste per tutti gli altri utenti.

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

Nota: quando UserListId restituisce true, la condizione di visibilità della tariffa membro AlwaysEligibleMembershipProgram viene compilata insieme, attivando così la tariffa per i membri visibile e, quando valuta false, il valore UserRateCondition di incorporamento diventa false, quindi rimuove AlwaysEligibleMembershipProgram. In questo caso, la condizione della tariffa nascosta per i membri ‐MembershipProgram‐ attiva tutte le tariffe non idonee.

<RateModification>

Modifica l'opzione di interfaccia utente per le tariffe private.

L'elemento <RateModification> compare nella seguente posizione nella gerarchia XML delle regole tariffarie:

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

Attributi

L'elemento <RateModification> non ha attributi.

Elementi secondari

L'elemento <RateModification> ha i seguenti elementi secondari:

Elemento secondario	Campo obbligatorio?	Tipo	Descrizione
<HotelAmenity>	Optional	enum	Combina <MembershipProgram> e <RateIneligibility> per modificare l'opzione di interfaccia utente nascosta della tariffa per i membri. I valori validi sono: free_wifi: aggiunge plus free wifi al testo.
<PriceMultiplier>	Optional	float	Modifica il prezzo moltiplicando questo valore per la tariffa di base, le tasse e le commissioni. Ad esempio, se PriceMultiplier = 0,9, tariffa di base = 100 $, tasse = 20 $, commissioni = 10 $.Dopo aver applicato il moltiplicatore: tariffa di base = 90 $, tasse = 18 $, commissioni = 9 $. In questo modo puoi applicare uno sconto a tutte le tariffe con una determinata regola tariffaria.

Esempi di tariffe private

Servizi dell'hotel

Tariffa per membri nascosta per tutti gli utenti (sconti di banda) + Wi-Fi gratuito

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

Moltiplicatore di prezzo

Applica il 5% di sconto alle tariffe per dispositivi mobili nel feed del prezzo

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