Créer un flux de prix (anciennement Message de transaction)

Article
06/22/2024

Pour fournir à Bing vos données de tarification et de disponibilité d’hôtel, créez un document XML qui contient un flux de prix. Le flux Prix contient une liste de dates d’enregistrement, de durées de séjour et de tarification.

Les flux de prix 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 d’enregistrement et une durée de séjour sont désignées comme un itinéraire. Si vous spécifiez le nombre maximal d’itinéraires, le message contient 2 520 itinéraires.

Les flux de prix 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 flux De prix 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 du flux de prix 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 flux de prix 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 d’état de flux de propriétés.

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 de propriétés. 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 dont les dates d’enregistrement sont 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 au moment de la réservation et le reste ultérieurement (par exemple, lors du départ).

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 pages d’accueil du partenaire. L’attribut id doit correspondre à un PDV dans le fichier de flux.

Étapes suivantes

Avant d’envoyer des flux de prix, assurez-vous que votre fichier de flux de propriétés et le fichier pages d’accueil 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 flux de prix. Les flux de prix envoyés avant l’importation des données échouent.

Validez le flux Price avant de l’envoyer à Bing. Pour plus d’informations, consultez Validation de votre flux de prix.

Pour plus d’informations sur l’envoi à Bing de votre flux de prix, consultez Envoi de flux de prix à Bing ou Avoir des flux de prix Bing Pull.

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

Partager via