Message promotionnel

Présentation

Le message Promotions définit les règles de remise des tarifs en utilisant OTA_HotelRateAmountNotifRQ Pour chaque tarif, les promotions définies sont évaluées et que la remise la plus élevée est appliquée taux de conversion. Ce type de message est facultatif. Il vous suffit de définir si elles sont utilisées dans votre système pour appliquer des remises sur les tarifs.

Vous pouvez combiner des promotions et les appliquer à différents attributs, comme le type d'appareil (mobile, tablette, ordinateur) et les codes pays.

Important :Lorsque plusieurs promotions s'appliquent à des tarifs spécifiques (type de chambre + offre ou nombre de personnes), l'utilisateur bénéficie de la promotion la moins chère autorisée ou combinaison de promotions. Les remises sont automatiquement appliquées.

Pour obtenir des exemples de scénarios liés aux promotions, consultez Guides d'utilisation

Les sections suivantes fournissent des consignes générales, un exemple de base et des instructions pour vous lancer dans l'ajout et la mise à jour de promotions.

Consignes

Cette section aborde les consignes courantes et les instructions spéciales pour configurer promotions.

Respectez les consignes suivantes concernant les promotions:

Actions

Supprimer

Utilisez une action delete dans l'élément <Promotion> pour supprimer une seule promotion par son ID.

Superposition

Utilisez une action overlay dans l'élément <HotelPromotions> pour remplacer toutes les promotions d'un établissement.

Delta

Si aucune action n'est spécifiée, alors toutes les promotions seront spécifiées. dans <HotelPromotions> sont ajoutés ou remplacés. Si une promotion associée à cet identifiant n'a jamais été ajoutée ou a été supprimée, la promotion est ajoutée. Si un une promotion associée à cet identifiant existe, elle est remplacée par la nouvelle définition.

Général

• Il peut y avoir une seule ou plusieurs promotions pour chaque établissement, promotion comporte un ensemble de conditions. Cette promotion ne peut être appliquée que si si les conditions sont remplies.

• Vous souhaitez qu'une promotion ne s'applique qu'à une date, un type de chambre ou un tarif spécifiques l'objet, puis l'indiquer dans les conditions de cette promotion. Si le ne s'applique pas à une date, un type de chambre ou un plan tarifaire spécifiques, vous n'avez pas besoin de les définir.

• Chaque promotion est associée à un établissement spécifique. Si vous utilisez la même promotion pour plusieurs propriétés, vous devez les envoyer séparément pour chacune d'entre elles. À spécifiez l'identifiant de votre propriété, utilisez l'attribut hotel_id de Élément <HotelPromotions>.

• Vous pouvez inclure jusqu'à 99 promotions. Contactez votre TAM Google si vous devez inclure plus de 10 utilisateurs.

• Utilisez l'élément <Stacking> pour spécifier comment combiner les promotions. Par par défaut, Google utilise le type de pile base, ce qui signifie que le meilleur la promotion de base est sélectionnée et appliquée en premier, avant les autres. Remarque que base ne peut être associé qu'à second ou any, et ne peut pas être associé avec un autre élément base ou none.

• Même si plusieurs promotions peuvent être appliquées ensemble, il se peut que cette pile ne soit pas celle qui est utilisée s'il y a une autre une seule promotion ou pile de promotions offrant la remise la plus importante. La promotion (combinaison) avec la remise la plus élevée est appliquée à la réservation lorsque plusieurs promotions (ou des combinaisons) sont éligibles.

• Mettez à jour votre message Promotions dès qu'un changement ayant un impact sur votre activité se produit. vos promotions.

  Important :Vous ne pouvez pas proposer plus de 500 promotions par établissement. Vous pouvez utiliser Message <Promotions> pour supprimer les promotions d'un établissement.

Taxes

La meilleure promotion (ou pile de promotions) est appliquée à l'AmountAfterTax. montant. Si seul AmountBeforeTax est spécifié, les promotions sont appliquée à AmountBeforeTax.

Exemple

Cette section fournit un exemple de message Promotions de base utilisant des éléments obligatoires et facultatifs. Une fois votre fichier prêt, envoyez-le à Google via un message POST à ce point de terminaison:

https://www.google.com/travel/hotels/uploads/promotions

Pour en savoir plus sur la méthode push/POST du message, consultez Transférer des messages :

Important : Envoyez à Google un message de promotion mis à jour chaque fois que vous modifiez vos promotions.

Pour l'attribut hotel_id de <HotelPromotions>, utilisez l'ID d'hôtel unique. que vous avez utilisés dans votre système pour identifier l'établissement. Cette valeur doit correspondre ID de l'hôtel spécifié à l'aide de <id> dans le champ <listing> dans le flux Hotel List Feed. La cohérence avec votre système est essentielle pour garantissant que Google affiche correctement vos données.

UserCountry permet de lister les zones géographiques des utilisateurs (pays) éligibles pour la promotion. Si cette option est spécifiée, seuls les utilisateurs des pays répertoriés sont proposé le tarif réduit.

Remarque :La définition d'un code pays est facultative. S'il n'est pas spécifié, les utilisateurs situés dans le tarif réduit est proposé dans n'importe quel pays.

Cet exemple montre comment définir une remise de 15% pour un séjour prolongé Pour les utilisateurs situés aux États-Unis et en Italie:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

Pour voir d'autres exemples, consultez Exemples de promotions.

Guides pratiques

Cette section fournit des solutions aux scénarios que vous pouvez rencontrer lorsque vous définissez promotions.

Scénario 1: Ajouter une promotion pour un séjour prolongé

Description

Vous souhaitez proposer des nuitées à prix réduit certains jours d'un séjour prolongé.

Solution

Utilisez le paramètre FreeNights pour personnaliser le type de remise appliqué en fonction sur le nombre de nuitées.

Échantillon

Cet exemple montre comment ajouter une remise de 20% pour deux nuits toutes les sept nuits. ont séjourné pendant la période de réservation spécifiée. Pour un séjour de 15 nuits, Une remise de 20% s'applique à un total de quatre nuits.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

Scénario 2: Définir les types d'appareils

Vous définissez devices pour spécifier les appareils des utilisateurs éligibles à promotion. Si spécifié, seuls les utilisateurs des appareils listés sont proposés le tarif réduit.

Remarque :S'il n'est pas spécifié, le tarif réduit est proposé aux utilisateurs sur n'importe quel appareil.

Description

Vous souhaitez spécifier le type d'appareil d'utilisateur éligible à la promotion.

Solution

Définissez le type d'appareil sur une ou plusieurs des valeurs suivantes: desktop, tablet, ou mobile.

Échantillon

L'exemple suivant montre comment spécifier une remise de 25 % pour les utilisateurs de mobiles et de tablettes :

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

Scénario 3 : Remplacer les anciennes promotions par de nouvelles

Description

L'ensemble actuel de promotions pour un établissement est obsolète ou incorrect et doit soit remplacé par un tout nouvel ensemble.

Solution

Utilisez l'action overlay pour remplacer les promotions.

Remarque :L'utilisation de overlay (plutôt que d'une delete individuelle) est méthode recommandée pour remplacer toutes les promotions d'un établissement. Utilisez les delete si vous souhaitez supprimer uniquement des promotions spécifiques d'une .

Échantillon

L'exemple suivant présente les deux remises d'origine de 20 % et 30 % pour l'établissement.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Cet exemple montre comment utiliser overlay pour remplacer le deux promotions avec une seule remise de 15% pour l'établissement.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Scénario 4: Supprimer une ou toutes les promotions

Description

Vous souhaitez supprimer une ou toutes les promotions (sans les remplacer), car le a supprimé toutes ses promotions sans en définir de nouvelles ; ou vous avez fait une erreur et devez la corriger.

Solution

Utilisez l'action delete si vous souhaitez supprimer uniquement des personnes spécifiques des promotions d'un établissement, puis utilisez l'action overlay (et non delete) pour les supprimer toutes les promotions existantes sans les remplacer.

Remarque :L'utilisation de overlay (plutôt que d'actions delete individuelles) est méthode recommandée pour écraser toutes les promotions d'un établissement.

Pour savoir comment remplacer les promotions avec overlay, consultez Scénario 3 :

Exemples

L'exemple suivant montre comment supprimer une seule promotion pour un établissement:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

Cet exemple montre comment supprimer toutes les promotions sans les remplacer pour une propriété:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

Scénario 5: Empiler les promotions

L'empilement spécifie comment les promotions peuvent être combinées. S'il n'est pas spécifié, type est défini sur base, ce qui signifie que la meilleure promotion de base éligible est sélectionnées et appliquées en premier, avant les autres promotions. Lorsque l'attribut type de Stacking est any, et peut être combiné avec n'importe quelle autre promotion.

Remarque :La promotion (combinaison) offrant la remise la plus élevée est appliquée au réservation lorsque plusieurs combinaisons de promotions sont éligibles.

Description

Vous voulez que l'utilisateur ait la possibilité d'utiliser plusieurs promotions en même temps. pour la même propriété.

Solution

Utilisez la superposition pour définir plusieurs remises par établissement. Une pile ne peut contenir qu'un seul base et un seul second, mais un nombre illimité de any. any peut être combiné avec les autres types, à l'exception de none.

Échantillon

Cet exemple montre comment empiler les types d'empilement base, second et any. Pour une remise combinée de 15%, 25 % ou 10%, un prix de 100 $représente un total de 57,38 $ (100 × 0,85 × 0,75 × 0,9).

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Notez que la remise combinée pour les promotions 1 à 3 s'élève à mieux que la remise appliquée pour la promotion 4. La promotion 4 n'est pas cumulable avec d'autres promotions en raison de leur type d'empilement (none). Si la promotion 4 avait un de 43% ou plus, il sera utilisé à la place de la combinaison promotions 1 à 3.