Créer un message de transaction

Article
12/21/2023

Pour fournir à Bing vos données de tarification et de disponibilité d’hôtel, créez un document XML qui contient un message de transaction. Le message de transaction contient une liste de dates de case activée, des durées de séjour et des tarifs.

Les messages de transaction peuvent contenir jusqu’à 180 jours de réservation avancée, et chaque réservation peut spécifier un séjour de 14 nuits maximum. Une date de case activée et une durée de séjour sont appelées itinéraires. Si vous spécifiez le nombre maximal d’itinéraires, le message contient 2 520 itinéraires.

Les messages de transaction sont limités à 100 Mo de données non compressées ou à 10 Mo de données compressées (à l’aide de la compression GZip). Pour réduire le trafic réseau, vous devez envoyer des données compressées.

Un message de transaction doit contenir uniquement les itinéraires que vous ajoutez ou mettez à jour. N’incluez pas les itinéraires qui n’ont pas été modifiés depuis la dernière fois que vous avez envoyé un message.

Le document doit utiliser l’encodage UTF-8 et doit être conforme à transaction XSD.

Importante

Vous devez lire et suivre toutes les politiques de Hotel Price Ads. Pour obtenir la liste des stratégies, consultez Stratégies de programmes pilotes.

Remarque

Bing ne prend pas en charge tous les éléments Transaction XSD. Bing ignore tout élément ou attribut dans le message qu’il ne prend pas en charge. La référence des messages de transaction inclut uniquement les éléments et attributs pris en charge par Bing.

Remarque

Le message doit spécifier les éléments dans l’ordre défini dans transaction XSD (ou comme indiqué dans la référence).

Élément Transaction de niveau supérieur

Les messages de transaction contiennent un seul élément Transaction de niveau supérieur.

<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">

Vous devez spécifier les timestamp attributs et id .

L’attribut timestamp doit identifier l’heure à laquelle vous envoyez le message. Bing utilise l’horodatage pour s’assurer qu’il traite uniquement les itinéraires les plus récents. Par exemple, si Bing traite un message avec un horodatage de 14 :10, puis traite un message avec un horodatage de 14 :09, Bing traite uniquement les itinéraires du message 14 :09 qui n’étaient pas inclus dans le message 14 :10.

L’attribut id est un ID défini par l’utilisateur qui identifie de façon unique le message à l’annonceur. L’annonceur utilise l’ID pour identifier le message dans la liste des rapports de flux d’hôtel status.

Spécification de la liste des itinéraires

L’élément Transaction contient une liste d’éléments Result , un pour chaque itinéraire qu’il définit. Le message doit inclure uniquement les nouveaux itinéraires ou ceux qui ont changé.

L’exemple suivant montre un Result élément qui spécifie les éléments enfants requis.

  <Result>
    <Property>13579</Property>
    <Checkin>2017-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
  </Result>

L’ID Property doit correspondre à l’ID d’une propriété dans votre fichier de flux d’hôtel. La Checkin date doit être comprise dans la fenêtre de réservation avancée de 90 jours et doit être comprise entre 1 et Nights 14.

spécifie Baserate le coût de toute la durée du séjour et non le tarif de la chambre à la nuit.

Si vous autorisez une réservation avancée de cinq jours et des séjours de trois nuits maximum, votre message contiendra 15 Result éléments. L’exemple suivant montre les itinéraires d’une journée.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

Après avoir défini les 15 itinéraires, chaque message suivant inclurait uniquement les itinéraires modifiés. Par exemple, les changements de tarification ou de disponibilité.

Suppression d’itinéraires

Pour supprimer un itinéraire, définissez ses Baserateéléments , Taxet OtherFees sur -1.00. Bing supprime automatiquement les itinéraires avec case activée de dates passées.

Utilisation des éléments Result facultatifs

L’exemple suivant montre un Result élément qui inclut les éléments enfants facultatifs.

  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <ExpirationTimestamp>2017-05-28T09:00:34Z</ExpirationTimestamp>
    <ChargeCurrency>deposit</ChargeCurrency>
    <Custom1>summer2017</Custom1>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>

Utilisez ExpirationTimestamp pour spécifier une date d’expiration pour l’itinéraire. Par exemple, dans le cas 1, l’itinéraire est servi.

Cas 1 :

Aujourd’hui = 16/03/2018
CheckInDate = 1/4/2018
ExpirationTimestamp = 20/03/2018

Mais dans le cas 2, l’itinéraire n’est pas servi.

Cas 2 :

Aujourd’hui = 21/03/2018
CheckInDate = 1/4/2018
ExpirationTime = 20/03/2018

Utilisez l’élément ChargeCurrency pour spécifier quand l’utilisateur est facturé pour la réservation. Par défaut, l’utilisateur paie lors de la réservation (il s’agit de l’option Web). Cet exemple utilise Le dépôt, qui demande à l’utilisateur de payer une partie lors de la réservation et le reste ultérieurement (par exemple, lorsqu’il case activée).

Utilisez un ou plusieurs des cinq Custom éléments pour fournir des valeurs de substitution pour les paramètres dynamiques dans une URL de point de vente (PDV). Par exemple, si l’URL de point de vente est https://www.partnerdomain.com?promo=(CUSTOM1) et Custom1 est définie sur summer2017, l’URL de point de vente utilisée par Bing est https://www.partnerdomain.com?promo=summer2017. Pour plus d’informations, consultez Utilisation des paramètres de requête dynamique.

La somme de toutes les valeurs Custom[1-5] est limitée à un maximum de 1 000 caractères, mais gardez à l’esprit que la limite pratique peut être inférieure compte tenu de la longueur maximale d’une URL.

Utilisez l’élément AllowablePointsOfSale pour spécifier des URL POS spécifiques que l’utilisateur peut utiliser pour la réservation. Par défaut, l’utilisateur peut utiliser n’importe quel point de vente dans le fichier de flux des points de vente du partenaire. L’attribut id doit correspondre à un PDV dans le fichier de flux.

Prochaines étapes

Avant d’envoyer des messages de transaction, assurez-vous que votre fichier de flux d’hôtel et votre fichier de points de vente sont à jour. Pour mettre à jour ces fichiers, contactez votre TAM. Une fois que le TAM a importé les données dans Bing, vous pouvez commencer à envoyer des messages de transaction. Les messages de transaction envoyés avant l’importation des données échouent.

Validez le message de transaction avant de l’envoyer à Bing. Pour plus d’informations, consultez Validation de votre message de transaction.

Pour plus d’informations sur l’envoi bing de votre message de transaction, consultez Envoi de messages de transaction à Bing ou Envoi de messages de transaction Pull Bing.

Pour plus d’informations sur l’ajout d’offres groupées de salles à vos itinéraires, consultez Création d’un message transactionnel de métadonnées et Utilisation de bundles de salles.