Documentation de référence XML sur les règles d'offres

Le fichier XML de règles d'offres définit les règles de diffusion des tarifs sous conditions tarifs préférentiels. Vous pouvez ajouter ou modifier un fichier XML de règles d'offres à l'aide de la méthode Page Règles d'offres dans Hotel Center. Pour en savoir plus sur les tarifs sous conditions et les tarifs préférentiels, consultez Tarifs préférentiels et sous conditions.

Chaque règle d'offres nécessite un id, qui peut être référencé dans un <Rate> d'un message Transaction. Un élément <Rate> qui fait référence à un ID de règle d'offres n'est diffusée qu'auprès des utilisateurs, définies par la règle d'offres. Un identifiant de règle d'offres peut également être référencé à l'aide d'un dans une URL de page de destination.

<RateRuleSettings>

Élément racine du fichier XML de règles d'offres. La L'élément <RateRuleSettings> (anciennement <PrivateRates>) contient:

  • Éléments <UserRateCondition> qui définissent les conditions à mettre en correspondance pour les tarifs sous conditions et préférentiels. Par exemple, vous pouvez créer un tarif sous conditions qui correspond à la condition de tous les utilisateurs d'une certaine pays.

  • Les éléments <RateRule> qui définissent chacun une règle d'offres dans un élément <Rate> dans un message Transaction. Chaque <RateRule> spécifie les conditions et le traitement dans l'interface utilisateur. qui établissent un tarif sous conditions ou préférentiel.

L'élément <RateRuleSettings> apparaît à l'emplacement suivant dans le tarif de règles XML:

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

Syntaxe

L'élément <RateRuleSettings> utilise la syntaxe suivante :

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

Attributs

L'élément <RateRuleSettings> ne comporte aucun attribut.

Éléments enfants

L'élément <RateRuleSettings> comporte les éléments enfants suivants :

Élément enfant Obligatoire ? Type Description
<RateRule> Required <RateRule>

Définit les conditions de correspondance, les modifications et l'éligibilité pour proposant un tarif préférentiel ou sous conditions. Nécessite un id qui peut être référencé dans un élément <Rate> d'une transaction. message ou dans un l'URL de la page de destination.
<UserRateCondition> Optional <UserRateCondition>

Définit une ou plusieurs conditions qui, lorsqu'il est mis en correspondance, génèrent tarifs préférentiels ou sous conditions auxquels sont proposés.

Vous pouvez définir les conditions de façon intégrée en utilisant <UserRateCondition> éléments enfants, par référence à un autre l'élément <UserRateCondition> à l'aide de reference_id. ou les deux par référence. Toutefois, <UserRateCondition> avec reference_id doit avoir 0 enfants.

Un élément <UserRateCondition> de niveau supérieur sous <RateRuleSettings> doit comportent un attribut id.

Exemples de tarifs sous conditions

Les exemples suivants présentent des méthodes de base pour définir des tarifs sous conditions.

En faisant référence à des conditions prédéfinies, comme illustré dans l'exemple Utilisateurs de mobiles est recommandé.

Utilisateurs de mobiles

L'exemple de tarif sous conditions suivant définit une règle d'offres qui correspond tous les utilisateurs mobiles en référençant un <UserRateCondition> prédéfini:

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

Utilisateurs aux États-Unis

L'exemple de tarif sous conditions suivant définit une règle d'offres qui correspond tous les utilisateurs effectuant des recherches aux États-Unis en référençant un <UserRateCondition>:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="us">
    <UserCountry>US</UserCountry>
  </UserRateCondition>
  <RateRule id="us">
    <UserRateCondition reference_id="us"/>
  </RateRule>
</RateRuleSettings>

<RateRule>

Conteneur permettant de spécifier les éléments suivants:

  • Conditions de diffusion d'un tarif
  • Modifications, le cas échéant, du prix et du traitement dans l'interface utilisateur pour le tarif
  • Utilisation de traitements masqués dans l'interface utilisateur pour les tarifs préférentiels

L'élément <RateRule> apparaît à l'emplacement suivant dans le fichier XML des règles d'offres hiérarchique:

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

Syntaxe

L'élément <RateRule> utilise la syntaxe suivante :

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

Attributs

L'élément <RateRule> comporte les attributs suivants :

Attribute Requis ? Type Description
id Obligatoire chaîne

Identifiant unique de la règle d'offres. Cet ID est référencé à l'aide de la méthode Attribut rate_rule_id d'un élément <Rate> dans une transaction pour diffuser un tarif sous conditions ou préférentiel. Règle d'offre id peut également être référencé à l'aide d'une variable et de conditions sur une page de destination URL.

Le nombre maximal de caractères autorisés est de 40.

Éléments enfants

L'élément <RateRule> comporte les éléments enfants suivants :

Élément enfant Obligatoire ? Type Description
<RateIneligibility> Optional <RateIneligibility> Spécifie les valeurs qui déterminent le traitement spécifique dans l'interface utilisateur pour une Tarif : <MembershipProgram>.

Valide uniquement lorsque <MembershipProgram> est spécifié dans <UserRateCondition>.
<UserRateCondition> Required <UserRateCondition>

Définit une ou plusieurs conditions qui, lorsqu'il est mis en correspondance, génèrent tarifs préférentiels ou sous conditions auxquels sont proposés.

Les conditions peuvent être définies de manière intégrée à l'aide de <UserRateCondition> éléments enfants, par référence à un autre élément <UserRateCondition> en utilisant l'attribut reference_id, ou les deux référence.

Notez toutefois que lorsqu'un <UserRateCondition> est un enfant de <RateRule>, l'élément <UserRateCondition> ne peut pas avoir de id et ne peut pas être référencé par un autre attribut <UserRateCondition>
<RateModification> Optional <RateModification> Modifie le traitement dans l'interface utilisateur pour les tarifs préférentiels.
<PromoCode> Optional string Spécifie un code à associer au tarif si cette règle d'offres est appliquée. Reflète sur la page de destination PROMO-CODE .

<UserRateCondition>

Définit une ou plusieurs conditions qui, lorsqu'elles sont mises en correspondance, génèrent des résultats tarifs préférentiels en vigueur.

L'élément <UserRateCondition> apparaît à l'emplacement suivant dans Hiérarchie XML des règles d'offres:

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

Syntaxe

L'élément <UserRateCondition> utilise la syntaxe suivante :

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

Attributs

L'élément <UserRateCondition> comporte les attributs suivants :

Attribute Requis ? Type Description
id Required (if top-level under <RateRuleSettings>) string

Identifiant unique de ce <UserRateCondition>. Peuvent être référencées par un attribut id <RateRule> ou par <UserRateCondition> reference_id.
op Optional enum

L'attribut op est obligatoire lorsque <UserRateCondition> a plusieurs éléments enfants. La valeur de l'attribut peut être l'une des suivantes:

  • all: inclure les utilisateurs finaux qui correspondent à tous les définies par cette règle d'offres. Cette valeur ne peut pas être utilisée lorsque l'une des conditions est <UserListId>, sauf une seule autre condition : <AlwaysEligibleMembershipProgram> ou <MembershipProgram> est défini.
  • any: inclure les utilisateurs finaux qui correspondent à l'un des définies par cette règle d'offres.
  • none: exclut les utilisateurs finaux qui correspondent à l'un des définies par cette règle d'offres. Cette valeur ne peut pas être utilisé lorsque l'une des conditions est <UserListId>.
reference_id Optional string

Définit cet élément comme référence à un autre élément prédéfini <UserRateCondition> par un id correspondant.

Lorsque reference_id est présent:

  • Les éléments enfants ne sont pas analysés.
  • id et op ne doivent pas être présents

Éléments enfants

L'élément <UserRateCondition> comporte les éléments enfants suivants :

Élément enfant Obligatoire ? Type Description
<AlwaysEligibleMembershipProgram> Optional string

Indique que le tarif s'affichera dans l'interface utilisateur visible du tarif pour les membres de traitement.

La valeur de cet élément peut être n'importe quel nom de programme d'adhésion.
<Description> Optional string Décrit l'élément <UserRateCondition>. Ceci est destiné à la documentation et n'a aucun effet sur ses capacités.
<LanguageCode> Optional string Indique que le tarif est proposé aux utilisateurs dont la langue correspond à ce à deux lettres code de langue.
<MaxUsersPercent> Optional float

Indique que le tarif est proposé de manière aléatoire à ce pourcentage des utilisateurs finaux.

La valeur doit être un nombre entier compris entre 0 et 100 (inclus). Pour exemple, 20 ciblera 20% des utilisateurs finaux.
<MembershipProgram> Optional string

Indique que le tarif sera appliqué dans l'interface utilisateur d'un programme d'adhésion comme déterminé par le <IneligibilityReason> de <RateIneligibility>

Pour que <MembershipProgram> soit valide, <RateIneligibility> doit être spécifié.

La valeur de <MembershipProgram> peut être n'importe quelle nom du programme d'adhésion.
<UserRateCondition> Optional <UserRateCondition>

Définit une ou plusieurs conditions qui, lorsqu'il est mis en correspondance, génèrent tarifs préférentiels ou sous conditions auxquels sont proposés.

Un élément <UserRateCondition> avec reference_id doit être défini sur 0. enfants.
<UserCountry> Optional string

A CLDR code pays, tel que DE ou FR. Notez que Pour certains pays, le code CLDR est différent du code ISO à deux lettres du code source. Les codes de région CLDR ne sont pas acceptés.

Indique que l'utilisateur doit se trouver dans le pays spécifié. Google détermine le pays de l'utilisateur final à partir de son adresse IP.
<UserDeviceType> Optional enum Définit la condition du type d'appareil. Valeurs autorisées: <ph type="x-smartling-placeholder">
    </ph>
  • mobile
  • desktop
  • tablet
<UserListId> Optional string ID de la liste d'utilisateurs Google Ads d'une liste d'audience.

Cette condition ne peut être utilisée qu'avec <AlwaysEligibleMembershipProgram> ou <MembershipProgram>, ou lorsque op est any
<UserSignedIn> Optional boolean Valeur booléenne indiquant si l'utilisateur doit être connecté ou non leur compte Google. Une valeur de true indique que l'utilisateur doit être connecté. Une valeur de false indique que l'utilisateur ne doit pas être connecté. Si vous ne vous souciez pas de savoir si l'utilisateur est connecté ou déconnecté, n'incluez pas de <UserSignedIn> .
<IsDomestic> Optional boolean Valeur booléenne indiquant si l'utilisateur doit provenir ou non de la même pays que celui de l'hôtel. Une valeur de true indique que l'utilisateur doit se trouver dans le même pays que l'hôtel. A La valeur false indique que l'utilisateur peut provenir de pays autre que celui de l'hôtel. Pour une analyse plus précise utilisez la condition <UserCountry>.

Exemples de tarifs sous conditions

Pourcentage d'utilisateurs

L'exemple de tarif sous conditions suivant indique que le tarif proposée de manière aléatoire à 20 % des utilisateurs:

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

Utilisateurs de mobiles au Royaume-Uni

L'exemple de tarif sous conditions suivant définit une règle d'offres qui correspond tous les utilisateurs effectuant des recherches au Royaume-Uni à l'aide d'un appareil mobile <UserRateCondition> intégré:

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

au Japon et non au Japon

L'exemple de tarif sous conditions suivant présente une règle d'offres qui correspond utilisateurs au Japon et une autre règle d'offres qui correspond aux utilisateurs dans le reste des monde (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>

Toutes, "Toutes" et "Aucune"

L'exemple de tarif sous conditions suivant montre comment op peut être utilisé pour établir une correspondance avec plusieurs conditions de différentes manières à l'aide des valeurs any, all et none. Par exemple, comme illustré dans le au_nz, vous pouvez en utiliser une pour mettre en correspondance les utilisateurs dans l'une pays. Comme indiqué dans la règle d'offres au_nz_mobile_tablet, vous pouvez utiliser all pour exiger que les utilisateurs répondent à plusieurs conditions. La row_mobile_tablet règle d'offre mettra en correspondance les utilisateurs qui se trouvent dans le reste des (ligne), à l'exception de l'Australie et de la Nouvelle-Zélande, et qui correspondent également au 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>

Exemples de tarifs préférentiels

Tarif pour les membres visible 1

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

Tarif pour les membres visible 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>

Tarif pour liste d'audience 1

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

Tarif pour liste d'audience 2

Cet exemple de tarif préférentiel montre comment spécifier un tarif pour les membres visible Traitement de plusieurs listes d'audience dans l'interface utilisateur:

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

Indique comment afficher le traitement masqué dans l'interface utilisateur pour le tarif pour les membres. Si ce n'est pas le cas inclus, le traitement masqué dans l'interface utilisateur pour le tarif pour les membres n'est pas affiché.

Pour utiliser <RateIneligibility> dans un <RateRule>, <MembershipProgram> doit également être spécifiée dans un élément <UserRateCondition> pour <RateRule>.

L'élément <RateIneligibility> apparaît à l'emplacement suivant du tarif de règles XML:

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

Syntaxe

L'élément <RateIneligibility> utilise la syntaxe suivante :

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

Attributs

L'élément <RateIneligibility> ne comporte aucun attribut.

Éléments enfants

L'élément <RateIneligibility> comporte les éléments enfants suivants :

Élément enfant Obligatoire ? Type Description
<IneligibilityType> Required enum

Définit la façon dont le texte (affiché à côté du taux barré) pour décrire le tarif caché.

Les valeurs valides sont les suivantes :

  • exact: pourcentage de remise Le message "Obtenez X% de réduction en vous inscrivant sans frais" s'affiche.
  • price_band: plage de remise. Le message "Inscrivez-vous sans frais pour profiter d'une remise de X à Y %" s'affiche. Pour les remises de 1 à 5%, le message "Jusqu'à 5% de remise" s'affiche. Les remises plus importantes s'affichent par tranches de cinq points, par exemple "Obtenez entre 5 et 10% de remise" ou "Obtenez 10-15% désactivé."
  • existence: indice non spécifique. Dans ce cas, le message suivant s'affiche : "Profitez de tarifs réduits grâce aux de l'inscription ».

Pour en savoir plus sur les traitements de l'interface utilisateur, consultez Tarifs préférentiels des détails et des exemples.
<IneligibilityReason> Required enum

Les valeurs valides sont les suivantes :

  • program_member: affiche le tarif. à l'aide du traitement masqué dans l'interface utilisateur.

Exemples de tarifs préférentiels

Cette section inclut des exemples de tarifs pour les membres masqués (version de base) et de tarif pour les membres exemples masqués (plusieurs conditions). Vous pouvez également présenter vos tarifs pour les membres aux sous-ensembles d'utilisateurs. Pour obtenir des exemples, consultez les exemples de tarifs préférentiels.

Exemples masqués de tarif pour les membres (de base)

Remise exacte

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

Remise sur tranche

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

Remise d'indice

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

Exemples masqués de tarif pour les membres (plusieurs conditions)

op=&quot;any&quot;

Tarif de liste d'audience pour les membres + tarif pour les membres masqué (remise "existence") pour les non-membres

Cet exemple de tarif préférentiel spécifie le type de tarif pour les membres existence. traitement masqué dans l'interface utilisateur, qui sera présentée aux utilisateurs et non à l'audience liste. Les utilisateurs de la liste d'audience verront le tarif d'audience.

<?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=&quot;all&quot;

Tarif pour les membres masqué uniquement pour les utilisateurs de la liste d'audience

Cet exemple de tarif préférentiel spécifie le type de tarif pour les membres exact masqué Traitement dans l'interface utilisateur, modifié avec le texte supplémentaire "plus Wi-Fi gratuit". Cette UI traitement sera présenté aux utilisateurs qui correspondent à la liste d'audience.

<?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 transparente/visible

Cet exemple montre comment spécifier un tarif pour les membres avec deux traitements dans l'interface utilisateur (interface utilisateur transparente et visible) pour les utilisateurs figurant dans la liste d'audience et les tarifs masqués pour tous les autres utilisateurs.

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

Modifie le traitement dans l'interface utilisateur pour les tarifs préférentiels.

L'élément <RateModification> apparaît à l'emplacement suivant dans Hiérarchie XML des règles d'offres:

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

Attributs

L'élément <RateModification> ne comporte aucun attribut.

Éléments enfants

L'élément <RateModification> comporte les éléments enfants suivants :

Élément enfant Obligatoire ? Type Description
<HotelAmenity> Optional enum

Combiner avec <MembershipProgram> et <RateIneligibility> pour modifier le traitement masqué dans l'interface utilisateur du tarif pour les membres.

Les valeurs valides sont les suivantes :

  • free_wifi: ajoute plus free wifi au texte.
<PriceMultiplier> Optional float

Modifie le prix en multipliant cette valeur par le tarif de base, les taxes, et les frais associés. Par exemple, si PriceMultiplier = 0,9, base tarif = 100 $, taxes = 20 $, frais = 10 $ ; puis après en appliquant le multiplicateur: tarif de base = 90 $, taxes = 18 $, frais = 9 $.

Cela vous permet d'appliquer une remise à tous les tarifs associés à un tarif spécifique d'une règle.

Exemples de tarifs préférentiels

Services de l'hôtel

Tarif pour les membres masqué pour tous les utilisateurs (remises sur la bande) + Wi-Fi gratuit

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

Multiplicateur de prix

Appliquer une remise de 5% aux tarifs sur mobile dans le flux des prix

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