Riferimento XML per le regole tariffarie

Il file XML delle regole tariffarie definisce le regole per la pubblicazione di tariffe agevolate e 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 la sezione Tariffe agevolate e private.

Ogni regola tariffaria richiede un id, a cui è possibile fare riferimento in un <Rate> di un messaggio di transazione. Un <Rate> che fa riferimento a un ID regola tariffaria viene fornito solo agli 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 radice del file XML delle regole tariffarie. L'elemento <RateRuleSettings> (in precedenza <PrivateRates>) contiene:

• Elementi <UserRateCondition> che definiscono le condizioni di corrispondenza per tariffe condizionali e private. Ad esempio, è possibile creare una tariffa condizionale che si applichi alle condizioni di tutti gli utenti di un determinato Paese.

• <RateRule> elementi che definiscono ciascuno una regola tariffaria di riferimento in un <Rate> in un messaggio di transazione. Ogni elemento <RateRule> specifica le condizioni e l'opzione di interfaccia utente che costituiscono una tariffa agevolata o privata.

L'elemento <RateRuleSettings> appare 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 figlio:

Elemento figlio	Obbligatorio?	Tipo	Descrizione
<RateRule>	Required	<RateRule>	Definisce le condizioni di corrispondenza, le modifiche e l'idoneità per la presentazione di una tariffa condizionale 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 l'applicazione di tariffe condizionate o private. Le condizioni possono essere definite in linea utilizzando gli elementi figlio <UserRateCondition>, tramite riferimento a un altro elemento <UserRateCondition> utilizzando l'attributo reference_id oppure sia in linea che tramite riferimento. Tuttavia, qualsiasi <UserRateCondition> con un reference_id deve avere 0 figli. Un <UserRateCondition> di primo livello sotto <RateRuleSettings> deve avere un attributo id.

Esempi di tariffe condizionate

Gli esempi seguenti mostrano i metodi base per definire le tariffe condizionate.

Si consiglia di fare riferimento a condizioni predefinite, come mostrato nell'esempio Utenti mobili.

Utenti di dispositivi mobili

Il seguente esempio di tariffe condizionali definisce una regola tariffaria che corrisponde a tutti gli utenti di dispositivi mobili facendo riferimento a un <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 statunitensi

Il seguente esempio di tariffe condizionali definisce una regola tariffaria che corrisponde a tutti gli utenti che effettuano 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 contenitore per specificare:

• Condizioni per la presentazione di una tariffa
• Eventuali modifiche al prezzo e al trattamento di invalidità per la tariffa
• Utilizzo di trattamenti UI nascosti per tariffe private

L'elemento <RateRule> appare 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.

Attributi

L'elemento <RateRule> ha i seguenti attributi:

Attributo	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 all'id della regola tariffaria tramite una variabile e condizioni in un URL pagina di destinazione. Il numero massimo di caratteri consentito è 40. Questo ID non può essere una stringa vuota.

Elementi secondari

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

Elemento figlio	Obbligatorio?	Tipo	Descrizione
<RateIneligibility>	Optional	<RateIneligibility>	Specifica i valori che determinano il trattamento UI specifico per una tariffa <MembershipProgram>. Valido solo quando <MembershipProgram> è specificato in <UserRateCondition>.
<UserRateCondition>	Required	<UserRateCondition>	Definisce una o più condizioni che, se soddisfatte, determinano l'applicazione di tariffe condizionate o private. È possibile definire le condizioni come incorporate, utilizzando gli elementi secondari <UserRateCondition>, mediante un riferimento a un altro elemento <UserRateCondition> utilizzando l'attributo reference_id oppure sia incorporate che mediante un riferimento. Tieni presente, tuttavia, che quando un <UserRateCondition> è figlio di <RateRule>, l'elemento <UserRateCondition> non può avere un attributo id e non può essere referenziato 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 della pagina di destinazione.

<UserRateCondition>

Definisce una o più condizioni che, se soddisfatte, determinano l'applicazione di tariffe condizionate o private.

L'elemento <UserRateCondition> appare 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> prevede i seguenti attributi:

Attributo	Obbligatorio?	Tipo	Descrizione
id	Required (if top-level under <RateRuleSettings>)	string	Un identificatore univoco per questo <UserRateCondition>. È possibile farvi riferimento mediante un attributo id di <RateRule> o un attributo reference_id di <UserRateCondition>.
op	Optional	enum	L'attributo op è obbligatorio quando <UserRateCondition> ha più elementi figlio. 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: per includere 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 <UserRateCondition> predefinito con un id corrispondente. Quando è presente reference_id: Gli elementi figlio non devono essere analizzati id e op non devono essere presenti

Elementi secondari

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

Elemento secondario	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>. Ciò avviene a scopo di documentazione e non ha alcun effetto sulle sue capacità.
<LanguageCode>	Optional	string	Specifica che la tariffa verrà offerta agli utenti la cui lingua corrisponde a questo codice lingua di due lettere. Nota: ti consigliamo di utilizzare <UserCountry> anziché <LanguageCode> ove possibile.
<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 determina un target del 20% degli utenti finali.
<MembershipProgram>	Optional	string	Specifica che la tariffa utilizzerà un'opzione di interfaccia utente di un programma di affiliazione, come stabilito dall'elemento <IneligibilityReason> di <RateIneligibility>. Perché <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 l'applicazione di tariffe condizionate 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 a quello 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	ID dell'elenco utenti di Google Ads di un elenco 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 avere eseguito l'accesso al proprio Account Google. Un valore di true indica che l'utente deve aver eseguito l'accesso. Un valore di 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 dell'hotel. Il valore true indica che l'utente deve trovarsi nello stesso paese dell'hotel. Un valore di false indica che l'utente può trovarsi in un paese diverso da quello dell'hotel. Se vuoi un controllo più granulare, utilizza la condizione <UserCountry>.

Esempi di tariffe condizionate

Percentuale di utenti

Il seguente esempio di tariffe condizionate specifica che la tariffa verrà offerta in modo casuale al venti percento 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 condizionali definisce una regola tariffaria che corrisponde a tutti gli utenti che effettuano ricerche nel Regno Unito con un dispositivo mobile utilizzando un <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 Giappone

Il seguente esempio di tariffe condizionali 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, tutto e nessuno

Il seguente esempio di tariffe agevolate illustra l'uso dell'attributo op per stabilire corrispondenze con più condizioni in modi diversi utilizzando i valori any, all e none. Ad esempio, come indicato nella condizione au_nz, puoi utilizzare "any" per stabilire corrispondenze per gli utenti in uno qualsiasi di vari paesi. Come illustrato nella regola tariffaria au_nz_mobile_tablet, puoi utilizzare all per richiedere che gli utenti soddisfino più condizioni. La regola tariffaria row_mobile_tablet stabilirà una corrispondenza per gli utenti che si trovano nel resto del mondo (ROW), ad esclusione 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

Tasso di iscrizione 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 per membri 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>

Tasso di ascolto 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 un trattamento dell'interfaccia utente visibile per le tariffe dei membri per più elenchi 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 membri nascosta. Se non è incluso, l'opzione di interfaccia utente della 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 figlio:

Elemento figlio	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: Percentuale di sconto. Il testo sarà: "Ottieni uno sconto del X% con l'iscrizione senza costi". price_band: Un intervallo di sconto. Il testo sarà: "Ottieni uno sconto del XY% con l'iscrizione senza costi". Per sconti dall'1 al 5%, il testo riporterà la dicitura "Ottieni fino al 5% di sconto". Gli sconti più grandi saranno mostrati in incrementi di 5 punti, ad esempio "Ottieni il 5-10% di sconto" o "Ottieni il 10-15% di sconto". existence: Un suggerimento non specifico. In questo caso, il testo sarà: "Ottieni un prezzo più basso con l'iscrizione senza costi". Per saperne di più sui trattamenti di inabilità al lavoro, consulta Dettagli ed esempi sulle tariffe private.
<IneligibilityReason>	Required	enum	I valori validi sono: program_member: visualizza la tariffa utilizzando l'opzione di interfaccia utente nascosta della tariffa per membri.

Esempi di tariffe private

In questa sezione sono riportati esempi di tariffa per membri nascosta (base) ed esempi di tariffa per membri nascosta (con condizioni multiple). Puoi anche mostrare le tue tariffe per membri a sottogruppi di utenti. Per visualizzare i prezzi delle tariffe per i membri, devi inviare prima il prezzo della tariffa per i membri per il pacchetto camera più economico, seguito dai prezzi dei restanti pacchetti camera. Non è consentita la determinazione del prezzo per più tariffe per i membri.

Per alcuni esempi, vedere Esempi di tariffe private.

Esempi di tariffe per membri nascoste (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 sulla fascia

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

Suggerimento sconto

<?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 nascosti di tariffe per i membri (condizioni multiple)

op="any"

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

Questo esempio di tariffe private specifica il tipo existence di opzione di interfaccia utente per tariffa per membri nascosta, che verrà mostrata agli utenti e non all'elenco del segmento di pubblico. Gli utenti nell'elenco del segmento di pubblico vedranno la tariffa 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="tutto"

Tariffa per membri nascosta solo per gli utenti di elenchi dei segmenti di pubblico

Questo esempio di tariffa privata specifica il tipo di trattamento dell'interfaccia utente nascosta della tariffa per i membri exact, 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>

Interfaccia utente trasparente/visibile

Questo esempio mostra come specificare la tariffa per membri con due opzioni di interfaccia utente (interfaccia utente 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 viene valutato come true, la condizione di visibilità del tasso di membro AlwaysEligibleMembershipProgram viene popolata insieme, attivando così la visibilità del tasso di membro e quando viene valutato come false, il UserRateCondition che lo racchiude diventa false, che quindi rimuove AlwaysEligibleMembershipProgram. In questo caso, la condizione nascosta della tariffa per i soci ‐MembershipProgram‐ attiva tutte le tariffe non idonee.

<RateModification>

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

L'elemento <RateModification> appare 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> prevede i seguenti elementi secondari:

Elemento figlio	Obbligatorio?	Tipo	Descrizione
<HotelAmenity>	Optional	enum	Combina con <MembershipProgram> e <RateIneligibility> per modificare il trattamento dell'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 base, le tasse e le commissioni. Ad esempio, se PriceMultiplier = 0,9, tariffa base = 100 $, tasse = 20 $, commissioni = 10 $; dopo l'applicazione del moltiplicatore: tariffa base = 90 $, tasse = 18 $, commissioni = 9 $. Ciò consente di applicare uno sconto a tutte le tariffe con una determinata regola tariffaria.

Esempi di tariffe private

Servizio dell'hotel

Tariffa per membri nascosta a tutti gli utenti (fasce di sconto) + 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>