Partager via


Créer un fichier de flux de propriétés CSV (anciennement flux d’hôtel)

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 de propriétés et la documentation sont susceptibles d’être modifiés.

Pour fournir à Microsoft vos listes d’hôtels, créez un fichier CSV 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 et les coordonnées géographiques de l’hôtel.

Pour plus d’informations sur la création d’un fichier de flux à l’aide d’un document XML, consultez Création d’un fichier de flux de propriétés XML.

Remarque

Le flux De propriétés prend uniquement en charge la langue anglaise.

Le format CSV ne prend pas en charge les images. Utilisez plutôt le format XML.

Obtenir les données correctement

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

Si votre 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. Une fois que votre TAM a importé votre fichier de flux Property, il vous envoie un rapport qui indique les hôtels que Microsoft a mis en correspondance ou n’a pas correspondu. 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 obtenir de l’aide sur l’amélioration de votre taux de correspondance, utilisez votre TAM.

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

La première ligne du fichier de flux est la ligne d’en-tête, qui contient les noms de colonnes des données d’hôtel dans le flux. L’en-tête doit inclure les noms de colonne de tous les éléments de données requis. Incluez uniquement les noms des colonnes facultatives si vous leur fournissez des données.

Voici la liste des colonnes que vous pouvez inclure dans le flux. Le fichier de flux peut contenir les colonnes dans n’importe quel ordre et les noms de colonnes ne respectent pas la casse.

Nom de colonne Description Type de données Obligatoire
id ID opaque défini par l’utilisateur qui identifie de façon unique l’hôtel dans le flux.

Lorsque vous créez votre flux Price, utilisez cet ID dans l’élément Property de votre flux Price pour identifier l’hôtel.
Chaîne Oui
nom Le nom de l’hôtel. Le nom peut contenir un maximum de 200 caractères. Chaîne Oui
address Adresse postale de l’hôtel en texte libre. Séparez chaque composant de l’adresse par une virgule et placez l’adresse entre guillemets. Par exemple, « 1234 Billings Way, Redmond, WA, 98030 ».

Utilisez cette colonne uniquement si vous fournissez l’adresse à l’aide d’un texte de forme libre ; sinon, utilisez les colonnes du composant d’adresse telles que addr1, city et province. Il est préférable d’utiliser les colonnes du composant d’adresse au lieu d’utiliser du texte de forme libre.
Chaîne Oui
addr1 L’adresse de la rue de l’hôtel. Par exemple, 1234 Billings Way. L’adresse doit être une adresse postale physique et non une boîte postale ou une autre adresse postale uniquement. Chaîne Oui
addr2 Deuxième ligne d’adresse postale. Chaîne Non
addr3 Troisième ligne d’adresse postale. Chaîne Non
Ville Nom de la ville où se trouve l’hôtel. Chaîne Oui
province Nom de l’état, de la région ou de la province où se trouve l’hôtel. Chaîne Oui
postal_code Le code postal de l’adresse. Chaîne Oui
country Pays ou région où se trouve l’hôtel. Spécifiez le pays ou la région à l’aide du code de pays ISO 3116 à deux lettres. Par exemple, utilisez US pour États-Unis. Chaîne Oui
latitude Latitude des coordonnées géographiques de l’hôtel.

Remarques :
  • La latitude et la longitude ne sont requises que si vous ne spécifiez phonepas . Il est préférable de spécifier à la fois le téléphone et les coordonnées géographiques.
  • La latitude doit être comprise entre -90,0 et 90,0.
  • Utilisez l’API d’emplacement ou un autre outil de géocodage pour générer les coordonnées à partir d’une adresse postale.
Décimal Non
longitude Longitude des coordonnées géographiques de l’hôtel.

Remarques :
  • La latitude et la longitude ne sont requises que si vous ne spécifiez phonepas . Il est préférable de spécifier à la fois le téléphone et les coordonnées géographiques.
  • La longitude doit être comprise entre -180,0 et 180,0.
  • Utilisez l’API d’emplacement ou un autre outil de géocodage pour générer les coordonnées à partir d’une adresse postale.
Décimal Non
phone Numéro de téléphone vocal principal que les clients utilisent pour contacter l’hôtel. Le numéro 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.

Remarques :
  • Utilisez des tirets, des espaces ou des parenthèses dans le numéro de téléphone pour faciliter la lecture. Par exemple, utilisez « 610-222-3333 » ou « (610) 222-3333 » au lieu de « 6102223333 ».
  • Spécifiez un seul numéro de téléphone ; ne spécifiez pas plusieurs nombres, tels que 650-123-2222/33.
  • Le numéro de téléphone peut contenir une extension allant jusqu’à 7 chiffres. Précède les extensions de l’une des abréviations suivantes : « ext », « extn » et « x ». Par exemple, « 408-555-1111x12345 » ou « 408-555-1111 x12345 ».
  • Le numéro de téléphone peut ne pas inclure de caractères alphabétiques.
  • Si le numéro de téléphone inclut l’indicatif du pays, faites-le précéder de « + ». Par exemple, « +65 6722-2323 » pour un numéro à Singapour où l’indicatif du pays est 65, ou « +001 (408) 555-1111 » pour un numéro aux États-Unis où l’indicatif du pays est 001.
Chaîne Oui
category Catégorie qui identifie le type d’hôtel. Le format attendu 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.
Chaîne Non
hotel_brand La marque de la chaîne d’hôtels. Par exemple, Fabrikam Residences by Contoso, où Contoso est la marque. Chaîne Non
star_rating La note d’étoiles de l’hôtel. Les valeurs possibles sont comprises entre 1 et 5. Chaîne Non

Remarque

La address colonne et les addrcolonnes , addr2, cityaddr3, province, et postal_code s’excluent mutuellement. Spécifiez la address colonne ou les colonnes du composant d’adresse. Il est préférable de spécifier les colonnes du composant d’adresse.

Bien que vous pouvez spécifier des coordonnées géographiques ou un 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.

Pour inclure une description, des images et des révisions pour une description, utilisez un fichier de flux XML. Consultez Créer un fichier de flux de propriétés XML.

Voici un exemple d’en-tête au format CSV. Séparez toutes les colonnes par une virgule. Incluez uniquement les colonnes qui contiennent des valeurs pour au moins un hôtel.

id,name,addr1,city,province,postal_code,country,phone

Après la ligne d’en-tête, incluez une ligne pour chaque hôtel que vous publiez. Le flux doit inclure des listes pour tous vos hôtels. Le processus de flux ne prend pas en charge les mises à jour partielles. N’incluez pas de lignes vides dans votre flux.

Si une valeur contient une virgule, vous devez entourer la valeur de guillemets. L’exemple suivant montre le contenu d’un exemple de fichier CSV.

id,name,addr1,city,province,postal_code,country,latitude,longitude,phone
abc123,Great Ambers Getaway,1234 Porter Rd,Goldendale,WA,98234,US,47.694351,-122.451782,123-456-7890

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.

Étapes suivantes

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

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

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 Flux de prix.