Partager via

Prise en main des flux de prix (anciennement Messages de transaction)

  • Article

Remarque

Cette version bêta de Hotel Price Ads est disponible uniquement pour certains participants. Pour plus d’informations sur la participation au programme de version bêta, contactez votre responsable de compte ou inscrivez-vous ici.

Si vous créez des campagnes publicitaires pour les hôtels dans Microsoft Advertising, utilisez les flux de prix pour mettre à jour vos données d’itinéraire (tarification et disponibilité).

Avant de pouvoir envoyer des flux de prix Microsoft, vous devez contacter votre responsable de compte pour vous inscrire.

Différents modes pour envoyer à Microsoft vos données d’itinéraire

Microsoft prend en charge les modes suivants que vous pouvez utiliser pour fournir vos données d’itinéraire.

  • Mode Push
  • Mode d’extraction
  • Mode d’extraction avec des indicateurs

Avec le mode Push, vous envoyez à Microsoft vos mises à jour non sollicitées aux intervalles que vous choisissez. Pour utiliser ce mode, vous devez fournir les adresses IPv4 (ou plages d’adresses au format CIDR) de tous les serveurs que vous utiliserez pour envoyer des flux de prix. Pour plus d’informations, consultez Envoi de flux de prix à Microsoft.

Avec les options du mode d’extraction , Microsoft vous envoie des messages de requête qui spécifient les données d’itinéraire d’hôtel que vous devez retourner. La différence entre les deux modes d’extraction est la quantité de données que vous envoyez à Microsoft. Avec le mode d’extraction, vous retournez des données pour tous les itinéraires et tous les hôtels. Mais avec l’extraction avec des indicateurs, vous indiquez à Microsoft quelles données ont changé et il demande uniquement ces données. Pour plus d’informations, consultez Avoir des flux de prix d’extraction Microsoft.

Qu’est-ce qu’un flux de prix ?

Un flux de prix est un document XML qui contient des données de tarification et de disponibilité pour une ou plusieurs propriétés d’hôtel. Pour chaque propriété d’hôtel, spécifiez un Result élément pour chaque Checkin combinaison et Nights (également connu sous le nom d’itinéraire) dans votre fenêtre de réservation avancée. 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">100.00</Baserate>
    <Tax currency="USD">10.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">8.00</OtherFees>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">300.00</Baserate>
    <Tax currency="USD">30.00</Tax>
    <OtherFees currency="USD">12.00</OtherFees>
  </Result>
</Transaction>

Vous pouvez spécifier jusqu’à 180 jours de réservation avancée avec des séjours de 14 nuits maximum. Par exemple, si le message timestamp est 2017-06-10, la dernière Checkin date que le message peut spécifier est 2017-09-08.

Le document doit utiliser l’encodage UTF-8.

En savoir plus

Valider le message avant de l’envoyer

Avant d’envoyer le flux De prix à Microsoft, utilisez transaction XSD pour valider le message. Cela permet d’économiser du temps et des allers-retours en interceptant les erreurs de syntaxe de document et les contraintes imposées par le XSD.

L’exemple suivant illustre l’utilisation de xmllint pour valider le message contenu dans SampleTransaction.xml.

xmllint.exe --schema transaction.xsd SampleTransaction.xml

Remarque

Il existe des contraintes non définies par le XSD qui peuvent générer des erreurs au moment où Microsoft traite le message. Assurez-vous que votre message est conforme à toutes les contraintes définies dans ce document.