Créer un fichier de flux d’hôtel CSV
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 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 d’hôtel XML.
Remarque
Le flux d’hôtel 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 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 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 d’hôtel, il vous envoie un rapport qui indique les hôtels que Microsoft a mis en correspondance 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 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 message de transaction, utilisez cet ID dans l’élément Property de votre message de transaction 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. | String | 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 :
|
Décimal | Non |
| longitude | Longitude des coordonnées géographiques de l’hôtel. Remarques :
|
Décimal | Non |
| phone | Le numéro de téléphone vocal main 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 :
|
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 star 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 d’hôtel 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.
Prochaines étapes
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.