Riferimento XML per le regole tariffarie

Il file XML delle regole tariffarie definisce le regole per la pubblicazione di tariffe agevolate e 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 valore id, a cui è possibile fare riferimento in <Rate> di un messaggio Transaction. Un elemento <Rate> che fa riferimento a un ID regola tariffaria viene pubblicato solo per gli utenti e nelle 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 di corrispondenza per le tariffe agevolate e private. Ad esempio, puoi creare una tariffa agevolata che corrisponda alla condizione relativa a tutti gli utenti in un determinato paese.

• Elementi <RateRule>, ognuno dei quali definisce una regola tariffaria a cui fare riferimento in un elemento <Rate> di un messaggio Transaction. Ciascun <RateRule> specifica le condizioni e l'opzione di interfaccia utente che costituiscono 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, determinano 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 sia per riferimento. Tuttavia, tutti gli elementi <UserRateCondition> con un valore 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 dei metodi di base per definire le tariffe agevolate.

È consigliabile fare riferimento a 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 degli 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 <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 container per specificare:

• Condizioni per la pubblicazione di una tariffa
• Eventuali modifiche al prezzo e al trattamento nell'interfaccia utente della tariffa
• Utilizzo di opzioni di interfaccia utente nascoste per le tariffe private

L'elemento <RateRule> viene visualizzato 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 dei segmenti 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 per la regola tariffaria. A questo ID viene fatto riferimento tramite l'attributo rate_rule_id di un elemento <Rate> in un messaggio Transaction per pubblicare una tariffa agevolata o privata. È anche possibile fare riferimento alla regola tariffaria id utilizzando 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 <MembershipProgram>. Valido solo quando <MembershipProgram> è specificato in <UserRateCondition>.
<UserRateCondition>	Required	<UserRateCondition>	Definisce una o più condizioni che, se soddisfatte, determinano 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> mediante l'attributo reference_id oppure sia in linea sia per riferimento. Tieni presente, tuttavia, che quando un <UserRateCondition> è un elemento secondario di <RateRule>, l'elemento <UserRateCondition> non può avere un attributo id e non può essere utilizzato come riferimento da un altro <UserRateCondition>.
<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 PROMO-CODE pagina di destinazione.

<UserRateCondition>

Definisce una o più condizioni che, se soddisfatte, determinano la pubblicazione di 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 per questo <UserRateCondition>. Può essere fatto riferimento da un attributo id <RateRule> o da 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 solo un'altra condizione, <AlwaysEligibleMembershipProgram> o <MembershipProgram>. any: includi gli utenti finali che soddisfano una qualsiasi delle condizioni definite da questa regola tariffaria. none: esclude 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 affiliazione.
<Description>	Optional	string	Descrive il <UserRateCondition>. A scopo di documentazione, 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 di un 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, determinano 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 di 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 in base all'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. Il valore false indica che l'utente non deve aver eseguito l'accesso. Se non è importante che l'utente abbia 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ò provenire da qualsiasi paese diverso da quello dell'hotel. Se vuoi 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 venti% 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 <UserRateCondition> incorporato:

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

Tutti, Tutti e Nessuno

Il seguente esempio di tariffe agevolate mostra come l'attributo op può essere utilizzato per trovare corrispondenze 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 trovare corrispondenze degli utenti in uno dei vari 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), ad eccezione di 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 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 elenco del segmento di pubblico 2

Questo esempio di tariffe private mostra come specificare una tariffa per membri visibile dell'interfaccia utente 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 nascosta della tariffa per membri. Se non è incluso, l'opzione di interfaccia utente nascosta della tariffa per i membri non viene visualizzata.

Per utilizzare <RateIneligibility> in un <RateRule>, <MembershipProgram> deve essere specificato anche in un elemento <UserRateCondition> per <RateRule>.

L'elemento <RateIneligibility> viene visualizzato 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 il modo in cui 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 dell'1-5%, il testo sarà "Sconto 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 in 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 di tariffa per membri nascosta (di base) ed esempi di tariffa per membri nascosta (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 tariffa per membri nascosta (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 suggerimento

<?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 tariffa per membri nascosta (con condizioni multiple)

op="any"

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

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

<?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 membro nascosta solo per gli utenti degli elenchi del segmento di pubblico

Questo esempio di tariffa privata specifica il tipo exact di trattamento UI nascosto della tariffa per membri, modificato con il testo aggiuntivo "più Wi-Fi gratuito". Questo trattamento dell'interfaccia utente verrà mostrato 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: se UserListId restituisce true, la condizione visibile della tariffa per membri AlwaysEligibleMembershipProgram viene compilata insieme, attivando così la tariffa per membri visibile. Quando il valore diventa false, il valore UserRateCondition incluso diventa false, il che a sua volta rimuove il AlwaysEligibleMembershipProgram. In questo caso, la condizione nascosta della tariffa per 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	Combinalo con <MembershipProgram> e <RateIneligibility> per modificare l'opzione di interfaccia utente nascosta della tariffa per 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 membro nascosta per tutti gli utenti (sconti su 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>