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 elemento <Rate> di un messaggio Transaction. Un elemento <Rate> che fa riferimento a un ID regola tariffaria viene pubblicato solo per gli utenti definiti dalla regola tariffaria e alle condizioni definite dalla regola stessa. È 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 determinare la corrispondenza per le tariffe agevolate e private. Ad esempio, puoi creare una tariffa agevolata che abbia come condizione "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. Ogni elemento <RateRule> specifica le condizioni e l'opzione di interfaccia utente che, nell'insieme, 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> prevede i seguenti elementi secondari:

Elemento secondario 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.

È 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. 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 alcuni metodi di base per la definizione delle 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 mediante il riferimento a un elemento <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 effettuano ricerche negli Stati Uniti mediante il riferimento a un elemento <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
  • Modifiche, se presenti, al prezzo e all'opzione di interfaccia utente per la tariffa
  • Utilizzo di opzioni di interfaccia utente nascoste 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>

Attributi

L'elemento <RateRule> prevede 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 consentiti è 40.

Elementi secondari

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

Elemento secondario 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.

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

Tuttavia, tieni presente che quando <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 elemento <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 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> 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 secondari. Il valore dell'attributo può essere uno dei seguenti:

  • all: per includere 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 un riferimento a un altro elemento <UserRateCondition> predefinito con un id corrispondente.

Quando è presente reference_id:

  • Gli elementi secondari non vengono analizzati
  • id e op non devono essere presenti

Elementi secondari

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

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 affiliazione.
<Description> Optional string Contiene la descrizione dell'elemento <UserRateCondition>. È a scopo di documentazione e non ha 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.

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 affiliazione.
<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 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 per il 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> o 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. Il valore 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 agevolate

Percentuale di utenti

Il seguente esempio di tariffe agevolate specifica che la tariffa sarà 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 agevolate definisce una regola tariffaria che corrisponde a tutti gli utenti che eseguono ricerche nel Regno Unito con un dispositivo mobile, utilizzando un elemento <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>

Valori any, all e none

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

Tariffa per membri 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>

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 un'opzione di interfaccia utente visibile della tariffa per membri per più elenchi di 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 membri nascosta. Se non è incluso, l'opzione di interfaccia utente della tariffa per membri nascosta non viene visualizzata.

Per utilizzare <RateIneligibility> in un elemento <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> prevede i seguenti elementi secondari:

Elemento secondario 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: una fascia di sconto. Il testo sarà "Sconto dal X% al Y% con l'iscrizione senza costi". Per sconti dall'1% al 5%, il testo sarà "Con uno 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".

Per ulteriori informazioni sulle opzioni di interfaccia utente, consulta la sezione Dettagli ed esempi di 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 gli esempi, consulta la sezione 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>

Fascia di sconto

<?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 con messaggio hint

<?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 nascoste (con 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="all"

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

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

<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> prevede i seguenti elementi secondari:

Elemento secondario Obbligatorio? Tipo Descrizione
<HotelAmenity> Optional enum

Da combinare con <MembershipProgram> e <RateIneligibility> per modificare l'opzione di interfaccia utente per la tariffa per membri nascosta.

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 base = 100 $, tasse = 20 $, commissioni = 10 $; dopo l'applicazione del moltiplicatore: tariffa base = 90 $, tasse = 18 $, commissioni = 9 $.

In questo modo puoi applicare uno sconto a tutte le tariffe con una certa 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>