Créer un fichier de flux d’hôtel XML

  • Article

Remarque

Depuis le 9 avril, vous n’aurez plus accès à Hotel Center. Nous sommes impatients de vous présenter le Centre de propriétés, qui fournira des fonctionnalités intéressantes en libre-service. Merci d’avoir attendu patiemment alors que nous mettons à jour notre contenu d’aide avec les nouvelles fonctionnalités. En attendant, vous pouvez en savoir plus sur ces modifications à venir et sur la façon de rendre votre processus de migration plus fluide.

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.

Le flux et la documentation de l’hôtel sont susceptibles d’être modifiés.

Pour fournir à Microsoft vos listes d’hôtels, créez un document XML qui contient une description de chaque hôtel que vous souhaitez publier. Une description décrit le nom, l’adresse, le numéro de téléphone, les coordonnées géographiques, les commodités et bien plus encore.

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

Pour plus d’informations sur la création d’un fichier de flux à l’aide du format de fichier CSV ou TSV, consultez Création d’un fichier de flux d’hôtel CSV.

Remarque

Microsoft ne prend pas en charge tous les éléments XSD. Microsoft ignore tout élément ou attribut du document qu’il ne prend pas en charge. La référence du flux d’hôtel inclut uniquement les éléments et attributs pris en charge par Microsoft.

Remarque

Le document doit spécifier les éléments dans l’ordre défini dans le XSD hotel (et comme indiqué dans la référence).

Obtenir les données correctement

Étant donné que Microsoft tente de faire correspondre les propriétés de votre flux d’hôtel aux entreprises de Bing Cartes, il est important que les données que vous fournissez sur l’hôtel soient précises et complètes.

Si un hôtel a des informations manquantes ou incorrectes, Microsoft peut ne pas être en mesure de les faire correspondre. Si Microsoft ne peut pas correspondre à l’hôtel, Microsoft ne le publiera pas. Vous serez en mesure d’afficher un rapport correspondant dans le centre hôtelier qui indique les hôtels correspondants ou non. Si Microsoft ne correspond pas à l’hôtel, le rapport inclut le message Impossible de faire correspondre cet hôtel à une propriété dans Bing. Pour vous aider à améliorer votre taux de correspondance, vérifiez qu’ils sont disponibles dans les emplacements Bing pour les entreprises.

Élément de niveau supérieur dans votre flux

Le flux d’hôtel contient un seul élément de référencement de niveau supérieur. L’élément listings contient deux éléments enfants obligatoires : language et listing.

<?xml version="1.0" encoding="UTF-8"?>
<listings  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <language>en</language>
  <listing>
    . . .
  </listing>
  ...
</listings>

Remarque

Actuellement, nous prenons en charge les données de flux uniquement en anglais.

L’élément language spécifie la langue dans laquelle les données du flux sont écrites. Pour spécifier la langue, utilisez le code de langue ISO 639 à deux lettres. Par exemple, utilisez en pour l’anglais.

L’élément listing contient des informations sur l’hôtel, telles que son nom, son adresse et son numéro de téléphone. Pour plus d’informations sur la définition d’une description, consultez Définition d’une description d’hôtel.

Définition d’une description d’hôtel

L’élément listing définit un hôtel. Vous devez spécifier un listing élément pour chaque hôtel que vous publiez. L’exemple suivant montre les éléments minimaux que vous devez spécifier pour une description. L’exception est que vous pouvez spécifier les coordonnées géographiques ou un numéro de téléphone. Bien que vous pouvez spécifier les coordonnées ou le numéro de téléphone, vous devez spécifier les deux pour garantir une meilleure probabilité de correspondance des propriétés dans Bing Cartes.

  <listing>
    <id>abc123</id>
    <name>Great Ambers Getaway</name>
    <address>
      <component name="addr1">1234 Porter Road</component>
      <component name="city">Goldendale</component>
      <component name="province">WA</component>
      <component name="postal_code">98234</component>
    </address>
    <country>US</country>
    <latitude>47.694351</latitude>
    <longitude>-122.451782</longitude>
    <phone type="main">123-456-7890</phone>
  </listing>

L’ID dans l’élément id est défini par l’utilisateur et doit être unique dans le flux.

L’adresse dans l’élément address est l’adresse postale de l’hôtel. L’adresse doit être une adresse postale et non une boîte postale. Vous pouvez spécifier l’adresse de l’hôtel à l’aide de l’élément component vu dans l’exemple ci-dessus ou à l’aide d’une chaîne de forme libre dans l’exemple ci-dessous. La préférence est d’utiliser des component éléments.

    <address>1234 Porter Road, Goldendale, WA, 98234</address>

L’élément latitude et longitude spécifie les coordonnées géographiques de l’hôtel. Utilisez une API de géocodage telle que l’API Emplacement pour générer les coordonnées à partir d’une adresse postale.

La description doit spécifier au moins le numéro de téléphone main de l’hôtel. Le numéro main doit être le numéro de téléphone de la réception et non un numéro de téléphone central de réservation. Plus vous fournissez de numéros de téléphone de contact, mieux c’est. L’exemple suivant montre les autres options de téléphone.

    <phone type="main">123-456-7890</phone>
    <phone type="tollfree">800-456-7890</phone>
    <phone type="fax">123-456-7890</phone>
    <phone type="tdd">123-456-7890</phone>
    <phone type="mobile">123-456-7890</phone>

Pour plus d’informations sur la spécification des numéros de téléphone, consultez l’élément phone .

Spécification des champs de référencement d’hôtels facultatifs

L’exemple suivant montre les éléments facultatifs que vous pouvez inclure dans la liste. Bien que facultatif, vous devez inclure autant d’informations que possible pour prendre en charge les scénarios d’utilisation actuels et futurs.

  <listing>
    . . .
    <category>hotel | inn</category>
    <content>
      <text type="description">
        <body>This element contains the hotel's description.</body>
      </text>
      <review type="user">
        <body>This element contains a review of the hotel.</body>
        <date month="2" day="24" year="2018" />
        <link>https://contoso.com/reviews/hotels?id=sd87s90</link>
        <rating>8.5</rating>
      </review>
      <attributes>
        <website>https://contoso.com</website>
        <attr name="air_conditioned">Yes</attr>
        <attr name="has_airport_shuttle">Yes</attr>
        <attr name="parking_type">No payment required</attr>
      </attributes>
      <image type="photo" url="https://contoso.com/photos?id=345k43llj" width=800 height=600>
        <date month="3" day="3" year="2018" />
        <link>https://contoso.com/...</link>
        <title>Hotel entrance</title>
      </image>
      <neighborhoods>
        <neighborhood>Sodo District</neighborhood>
      </neighborhoods>
      <brand>Contoso</brand>
    </content>
  </listing>

Le category format attendu de l’élément est vacation_rental ou hôtel suivi du caractère de canal et d’une valeur personnalisée. Par exemple, vacation_rental | 'custom value' ou hotel | 'custom value'

Pour obtenir la liste des valeurs personnalisées, consultez Catégories de propriétés d’hébergement.

L’élément text contient une description de l’hôtel. Vous devez spécifier l’élément body qui contient la description réelle. Selon la longueur de la description, elle peut être tronquée lorsqu’elle est affichée. Si vous incluez les link éléments et title , l’URL du lien pointe vers la description en ligne.

L’élément review contient une révision utilisateur ou une révision éditoriale. Une révision éditoriale est une revue professionnelle effectuée par une autorité de révision telle qu’un blogueur de voyage. Vous pouvez inclure n’importe quel nombre de révisions, mais selon le nombre de révisions envoyées, elles peuvent ne pas toutes être affichées. Vous devez spécifier l’élément body , qui contient la révision. Selon la longueur de l’avis, il peut être tronqué lorsqu’il est affiché. Si vous incluez l’élément link , il pointe vers la liste complète des avis en ligne.

L’élément attributes contient une liste des équipements de l’hôtel, tels que la climatisation, une piscine et le petit déjeuner gratuit. Pour obtenir la liste des commodités possibles, consultez Attribut. Si vous ne spécifiez pas d’agrément, il est supposé que l’hôtel ne le fournit pas.

L’élément image contient une image de l’hôtel. Vous pouvez inclure n’importe quel nombre d’images, mais selon le nombre d’images envoyées, elles peuvent ne pas toutes être affichées. La ration d’aspect recommandée est de 4 :3 et la largeur minimale est de 720 pixels. Les images doivent être des photographies d’origine et ne peuvent pas être des captures d’écran. Notez que l’URL link doit être accessible par le robot AdIdxBot. Si votre site inclut le fichier robots.txt, il doit inclure les éléments suivants :

  • User-Agent : AdIdxBot
  • Permettre:/

L’élément neighborhood identifie le quartier où se trouve l’hôtel. Vous pouvez spécifier plusieurs quartiers si l’hôtel est situé au centre de plusieurs quartiers.

L’élément brand identifie la marque de l’hôtel. Par exemple, Fabrikam Residences by Contoso, où Contoso est la marque.

Que se passe-t-il si le contenu de l’hôtel change ?

Si vous modifiez l’une des valeurs de propriété de l’hôtel entre les exécutions de flux (par exemple, son nom, son adresse, son téléphone, etc.), Microsoft Advertising peut la traiter comme une nouvelle propriété d’hôtel et créer une nouvelle description pour celle-ci. Si Microsoft crée une nouvelle liste, l’historique des performances antérieures de l’ancien hôtel reste disponible pendant 36 mois maximum. Notez que les enchères et les multiplicateurs de l’ancien hôtel ne seront pas transférés à la nouvelle entité de l’hôtel.

Si vous supprimez un hôtel et que vous le rajoutez dans un flux ultérieur avec les mêmes valeurs de propriété qu’auparavant, Microsoft le traite comme une nouvelle description. En outre, le rapport de performances l’affiche sous la forme de deux listes distinctes.

Règles générales

  • Utilisez hotel XSD pour valider votre fichier de flux d’hôtel avant de l’envoyer à Microsoft.

  • Le document de flux d’hôtel doit utiliser l’encodage UTF-8.

  • Le flux doit inclure des listes pour tous vos hôtels. Le processus de flux ne prend pas en charge les mises à jour partielles.

  • Microsoft ignore tout élément ou attribut qu’il ne prend pas en charge.

  • Les éléments doivent être dans l’ordre spécifié dans le XSD hotel.

  • Si vos données incluent des caractères spéciaux tels que des apostrophes ou des guillemets, les placer dans une séquence d’échappement ou utiliser des sections CDATA. Si vous les échappez, vous pouvez utiliser des codes d’entité ou des codes de caractères. Par exemple, vous pouvez échapper à Paul en tant que Paul&apos ; ou Paul's.

  • N’incluez pas d’éléments qui ne contiennent pas de données. Par exemple, si vous ne fournissez pas les coordonnées géographiques d’un hôtel, n’incluez pas d’éléments de latitude> et <de longitude> vides<.

  • N’utilisez pas de code HTML dans vos éléments XML.

Étapes suivantes

Après avoir créé votre fichier de flux, utilisez hotel XSD pour le valider.

Demandez à votre responsable de compte d’importer le fichier de flux.

Veillez également à importer vos données de points de vente. Pour plus d’informations sur la création de votre fichier de flux de points de vente, consultez Flux de points de vente.

Une fois que Microsoft a importé vos données et est en mesure de faire correspondre vos hôtels aux propriétés dans Bing Cartes, vous pouvez commencer à envoyer vos données de tarification et de disponibilité. Pour plus d’informations, consultez Messages de transaction.