Créer un flux de points de vente

  • 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.

Pour fournir à Bing vos données de points de vente, créez un document XML qui contient un point de vente (PDV) pour chaque site de réservation que vous prenez en charge. Un pdV décrit le nom d’affichage, l’URL et les critères de mise en correspondance de l’utilisateur avec un pdV.

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

Remarque

Bing ne prend pas en charge tous les éléments XSD. Bing ignore tout élément ou attribut du document qu’il ne prend pas en charge. La référence points de vente inclut uniquement les éléments et attributs pris en charge par Bing.

Remarque

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

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

Le flux des points de vente contient un seul élément PointsOfSale de niveau supérieur. L’élément PointsOfSale nécessite un élément enfant PointOfSale pour chaque site que les utilisateurs peuvent utiliser pour réserver une salle.

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

L’élément PointOfSale décrit le nom d’affichage, l’URL et les critères de mise en correspondance de l’utilisateur avec un pdV. Pour plus d’informations sur la définition d’un point de vente, consultez Définition d’un point de vente.

Définition d’un point de vente

L’élément PointsOfSale contient une liste d’éléments PointOfSale , un pour chaque site pos que les utilisateurs peuvent utiliser pour réserver des salles. La liste doit contenir des points de vente pour un partenaire unique.

L’exemple suivant montre PointOfSale les éléments qui définissent des points de vente pour les utilisateurs anglophones. Le premier PointOfSale élément définit un point de vente pour les utilisateurs finaux anglophones sur n’importe quel appareil, et le deuxième PointOfSale élément définit un point de vente pour les utilisateurs finaux anglophones sur les appareils mobiles. L’URL du point de vente inclut des détails sur la transaction, tels que les dates de case activée et de case activée, l’ID d’hôtel et la langue de l’utilisateur. Bing utilise le nom d’affichage et l’URL de point de vente pour créer un lien hypertexte ajouté à la publicité. Lorsque l’utilisateur clique sur le lien, il est dirigé vers le site de réservation. Si vous utilisez des modèles de suivi pour le suivi des performances, l’élément LPURL de l’URL de page d’accueil doit être configuré dans le fichier de flux PDV pour que le suivi fonctionne. Bing utilise le nom d’affichage et l’URL de pdV ou LPURL pour créer un lien hypertexte ajouté à l’annonce. Lorsque l’utilisateur clique sur le lien, il est dirigé vers le site de réservation.

  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>

Incluez l’élément DisplayNames uniquement pour les agences de voyage en ligne. N’incluez pas pour les DisplayNames fournisseurs de système de réservation central (CRS) (également appelés partenaires d’intégration) et les fournisseurs directs (tels que les propriétaires d’hôtels ou les chaînes). Pour les fournisseurs CRS et les fournisseurs directs, Bing utilise le nom de l’hôtel à partir du flux d’hôtel.

Si vous incluez DisplayNames, vous devez inclure un Match élément dont le critère de langue est défini sur la même langue.

Bing utilise le PDV qui correspond le mieux à l’utilisateur en fonction des critères de correspondance du PDV. En fonction des critères de correspondance ci-dessus, les utilisateurs sur les appareils mobiles utiliseront le pdV English-Mobile et tout le monde utilisera le PDV anglais. Pour plus d’informations sur la façon dont Bing met en correspondance les utilisateurs à un point de vente, consultez Mise en correspondance de points de vente. Pour obtenir la liste des critères sur lesquels vous pouvez faire correspondre, consultez l’élément Match .

L’élément URL spécifie le lien vers le site où l’utilisateur peut réserver la salle. L’exemple montre l’utilisation de paramètres de requête dynamique. Bing substitue des valeurs aux variables dynamiques au moment de l’exécution. Pour plus d’informations sur l’utilisation des paramètres de requête dynamique, consultez Utilisation des paramètres de requête dynamique.

Remarque

Si vous spécifiez le critère de correspondance langue et pays, ils doivent être définis sur en et US uniquement.

L’exemple suivant montre un document XML complet sur les points de vente.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
</PointsOfSale>

Points de vente correspondants

Les points de vente incluent un Match élément qui contient les critères utilisés par Bing pour faire correspondre un utilisateur à un pdV. Voici le critère utilisé par Bing pour faire correspondre les utilisateurs aux points de vente. La liste est dans l’ordre de préférence.

  • country
  • Monnaie
  • language
  • device

Bing utilise les règles suivantes pour trouver la meilleure correspondance pdV.

  • Bing donne la préférence la plus élevée aux correspondances par pays et la préférence la moins élevée pour les correspondances d’appareil.

  • Si Match ne spécifie pas l’un des critères, Bing correspond implicitement à toutes les valeurs du critère. Par exemple, si Match spécifie la langue et la devise, Bing correspond implicitement à n’importe quel pays et appareil.

  • Si Match spécifie un ou plusieurs critères, Bing utilise le pdV avec les correspondances les plus explicites.

  • Si l’utilisateur correspond à plusieurs points de vente, Bing utilise le pdV avec la meilleure qualité de correspondance. Si plusieurs points de vente ont la même qualité de correspondance, Bing utilise le premier point de vente qu’il a trouvé avec cette qualité de correspondance. La qualité de correspondance est basée sur :

    • Correspond avec la préférence la plus élevée. Par exemple, si un PDV correspond uniquement à la devise de l’utilisateur et qu’un autre correspond uniquement à l’appareil de l’utilisateur, Bing utilise le PDV qui correspond à la devise de l’utilisateur, car il est plus élevé dans l’ordre préféré.
    • Les correspondances explicites sont préférées aux correspondances implicites. Par exemple, si un PDV correspond explicitement au pays de l’utilisateur et qu’un autre correspond implicitement au pays de l’utilisateur, Bing utilise le PDV qui correspond explicitement.

L’attribut Match status de l’élément détermine s’il faut inclure ou exclure le PDV en fonction de la correspondance. Si status n’est jamais et que Bing correspond à tous les critères, Bing n’utilise pas le pdV. Pour exclure un pdV, tous les critères doivent correspondre. Dans l’exemple suivant, Bing exclut explicitement le pdv si l’utilisateur est originaire de l’États-Unis ou de la France, et l’inclut implicitement si l’utilisateur est originaire d’un autre pays.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='never' country='US' />
  <Match status='never' country='FR' />
  . . .
</PointOfSale>

Si status est oui, Bing n’éliminera pas de considération les points de vente qui ne correspondent pas explicitement à tous les critères, mais la préférence est accordée au pdV qui correspond le plus au critère. Dans l’exemple suivant, Bing fait explicitement correspondre l’utilisateur au pdv si le pays de l’utilisateur est la France. Si le pays de l’utilisateur n’est pas la France, le PDV est toujours pris en compte jusqu’à ce qu’une meilleure correspondance soit trouvée. Si aucune meilleure correspondance n’est trouvée, Bing utilise le PDV.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='yes' country='FR' />
  . . .
</PointOfSale>

Bing recommande d’utiliser les mêmes critères de correspondance pour chaque PDV. Cela réduit la complexité de déterminer pourquoi un point de vente correspond à un autre.

Utilisation des paramètres de requête dynamique

Un point de vente contient un URL élément qui identifie le site où les utilisateurs peuvent réserver des salles. L’URL peut contenir des paramètres de requête dynamique, qui sont des paramètres définis par l’utilisateur qui contiennent un jeton prédéfini pour sa valeur. Bing remplace ensuite le jeton par une valeur avant d’ajouter l’URL à la publicité. En utilisant des paramètres de requête dynamique, vous pouvez inclure l’ID de l’hôtel, la date de case activée, la durée du séjour, etc. dans l’URL.

L’exemple suivant montre la syntaxe que vous utilisez pour spécifier les paramètres de requête dynamiques dans votre URL de point de vente. Étant donné que les paramètres de requête dynamique sont des paramètres de requête, ils doivent suivre le symbole de point d’interrogation ( ?) dans l’URL.

http://domain.com/path?param-name=(dynamic-variable-name)

Voici les noms de variables dynamiques respectant la casse possibles que vous pouvez spécifier dans l’URL.

Nom Description
ADVANCE-BOOKING-WINDOW Nombre de jours avant la date de case activée de la réservation. Par exemple, 36.
BING-SITE Propriété Bing à l’origine de la demande d’annonce. Voici les valeurs possibles.
  • localuniversal : l’annonce provient d’une page de résultats de recherche.
  • mapresults : l’annonce provient d’un site de cartes.
  • PropertyPromotionAd : l’annonce provient de la première page de résultats affichée dans une recherche de mappages.
  • unknown : l’annonce provient d’une source indéterminée.
  • vérification : Bing utilise cette valeur lors de l’exécution de tests de qualité des données sur votre site. Ces requêtes ne vous sont pas facturées. Bing Analytics utilise ce paramètre et sa valeur pour identifier le trafic de vérification hotel Price Ads.
CHECKINDAY Jour à deux chiffres spécifié dans l’élément Checkin du message de transaction. Par exemple, 20.
CHECKINDAY-OF-WEEK Jour de la semaine où le case activée-in a lieu. Bing utilise les chiffres 0 à 6 pour représenter le lundi au dimanche. Par exemple, 1 est mardi.
CHECKINMONTH Mois à deux chiffres spécifié dans l’élément Checkin du message de transaction. Bing utilise les chiffres 00 à 11 pour représenter janvier à décembre. Par exemple, 05 correspond à juin.
CHECKINYEAR Année à quatre chiffres spécifiée dans l’élément Checkin du message Transaction. Par exemple, 2021.
CHECKOUTDAY Jour à deux chiffres que l’utilisateur extrait. Bing utilise les Nights éléments et Checkin de TransactionMessage pour calculer le jour. Par exemple, 23.
CHECKOUTMONTH Mois à deux chiffres que l’utilisateur extrait. Bing utilise les Nights éléments et Checkin du message de transaction pour calculer le mois. Par exemple, 07.
CHECKOUTYEAR Année à quatre chiffres que l’utilisateur extrait. Bing utilise les Nights éléments et Checkin du message transactionnel pour calculer l’année. Par exemple, 2021.
TYPE DE CLIC Indique si l’utilisateur a cliqué sur une annonce d’hôtel ou une annonce groupée de chambres. Voici les valeurs possibles.
  • hotel : l’utilisateur a cliqué sur une annonce d’hôtel.
  • room : l’utilisateur a cliqué sur une annonce d’offre groupée de salles.
NOTE: Bing ne prend pas en charge l’option de salle.
CUSTOM[1-5] Valeurs des champs personnalisés (par exemple, Custom1) spécifiés dans l’élément Result du message Transaction.
DATE-TYPE Indique si l’utilisateur a spécifié case activée et case activée dates de sortie. Voici les valeurs possibles.
  • default : l’utilisateur a cliqué sur une annonce d’hôtel qui utilisait des dates par défaut.
  • sélectionné : l’utilisateur a cliqué sur une annonce d’hôtel avec des dates d’case activée entrée et de case activée spécifiques.
HOTELGROUP_ID ID du groupe d’hôtels auquel appartient l’annonce de l’hôtel.
LONGUEUR Longueur de séjour spécifiée dans l’élément Nights du message de transaction. Par exemple, 3.
NOMBRE-ADULTES Nombre d’adultes occupant la chambre. La valeur par défaut est 2.
PARTNER-CURRENCY Code monétaire à trois lettres spécifié dans l’attribut currency de l’élément Baserate dans le message de transaction. Par exemple, USD.
PARTNER-HOTEL-ID ID de l’hôtel spécifié dans l’élément id du flux d’hôtel.
PARTNER-ROOM-ID ID qui identifie de façon unique la salle. Il s’agit de l’ID spécifié dans <l’élément RoomID> du <bloc Result>, <RoomBundle> ou <RoomData> , selon l’utilisation.
PRICE-DISPLAYED-TAX Montant des taxes dans la devise locale de l’utilisateur. Le montant de la taxe est basé sur l’élément Tax spécifié dans le message de transaction. Par exemple, 3.14.
PRIX AFFICHÉ-TOTAL Coût total de la salle dans la devise locale de l’utilisateur. Le montant est basé sur la somme des Baserateéléments , Taxet OtherFees spécifiés dans le message de transaction. Par exemple, 152.13.
SLOT_TYPE Positionnement de l’annonce sur la page de résultats. Le paramètre peut contenir les valeurs possibles suivantes :
  • R : emplacement prioritaire où les annonces sont affichées sur la page de résultats lors du chargement.
  • B : emplacement secondaire où les publicités sont affichées uniquement après que l’utilisateur a cliqué sur Plus de tarifs.
SUBACCOUNT_ID ID du sous-compte auquel appartient la campagne d’annonces de prix d’hôtel. Si votre implémentation Google utilise CAMPAIGN-ID, remplacez SUBACCOUNT_ID PAR CAMPAIGN-ID.
USER-COUNTRY Code de pays à deux lettres du pays où se trouve l’utilisateur. La valeur est extraite des paramètres client de l’utilisateur final. Par exemple, les États-Unis.
USER-CURRENCY Code monétaire à trois lettres de la devise locale utilisée par l’utilisateur. La valeur est déduite à partir des paramètres client de l’utilisateur final. Par exemple, USD.
UTILISATEUR-APPAREIL Type d’appareil de l’utilisateur final. Voici les valeurs possibles.
  • mobile
  • Tablette
  • Bureau
  • unknown
La valeur est déduite à partir des paramètres client de l’utilisateur final.
USER-LANGUAGE Code de langue à deux lettres qui spécifie la langue d’affichage de l’annonce. La valeur est déduite à partir des paramètres client de l’utilisateur final. Par exemple, en.
VÉRIFICATION Boolean qui indique si Bing a généré le lien. Si Bing a généré le lien, la valeur est true. Sinon, false.

Toutes les dates, telles que CHECKINDAY, se trouvent dans le fuseau horaire de l’hôtel.

Voici un exemple d’URL qui contient des paramètres de requête dynamiques et des entités encodées.

<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Avant que Bing n’utilise l’URL dans l’annonce, il remplace les valeurs par les noms de variables dynamiques. Par exemple, si l’utilisateur réserve une chambre pour 6 nuits à compter du 7/06/2021 pour hotel #42, Bing affiche l’URL comme suit :

http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6

Bing obtient des valeurs pour les paramètres dynamiques à partir de votre message de transaction et de votre flux d’hôtel, ainsi que des paramètres spécifiques à l’utilisateur. Par exemple, la valeur de la variable LENGTH provient de l’élément Nights dans le message de transaction, et la valeur de la variable PARTNER-HOTEL-ID provient de l’élément id dans le flux d’hôtel.

Certaines variables sont des sous-ensembles d’éléments de message de transaction. Par exemple, les variables CHECKINDAY, CHECKINMONTH et CHECKINYEAR sont extraites de l’élément Checkin . Les autres variables sont calculées en fonction des paramètres régionaux de l’utilisateur et d’autres paramètres client.

Règles d’URL générales

Voici les règles générales à suivre lors de l’utilisation de variables dynamiques.

  • Tous les paramètres dynamiques sont facultatifs. Vous n’êtes pas obligé d’insérer des paramètres dynamiques dans votre URL de pdv. Toutefois, l’utilisation de variables pour transmettre des informations spécifiques à l’itinéraire et à l’utilisateur crée généralement une meilleure expérience pour l’utilisateur final.

  • Entourez les noms de variables dynamiques avec des parenthèses ouvertes et fermées.

  • Utilisez des entités encodées pour les caractères spéciaux. Par exemple, remplacez les esperludes (&) par & ;, l’espace par %20 et la barre oblique (/) par %2F.

  • Les valeurs d’un seul paramètre peuvent être construites à partir de plusieurs variables. Par exemple, vous pouvez construire la valeur d’un paramètre de requête checkinDate à partir des variables CHECKINDAY, CHECKINMONTH et CHECKINYEAR.

    <URL>http://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>

  • Pour les variables dynamiques que Bing a reconnues mais ne prend pas en charge, Bing remplace la chaîne de variable par une chaîne vide.

  • Étant donné que les paramètres de requête dynamique sont des paramètres de requête, ils doivent suivre le symbole de point d’interrogation ( ?) dans l’URL.

Utilisation de directives conditionnelles

En plus des variables répertoriées ci-dessus, vous pouvez également utiliser les directives suivantes pour créer une logique conditionnelle.

  • IF-DEFAULT-DATE : résout la valeur true si l’utilisateur a cliqué sur une annonce d’hôtel qui a utilisé des dates par défaut (l’utilisateur n’a pas choisi les dates). Si la valeur est true, Bing insère les valeurs qui suivent cette directive dans l’URL. Sinon, Bing insère les valeurs suivant la directive ELSE.

  • ELSE : si la condition précédente n’est pas remplie, Bing insère les valeurs qui suivent cette directive.

  • ENDIF : met fin au bloc conditionnel.

Par exemple, l’URL suivante définit le paramètre de requête popup_datepicker sur true si l’utilisateur a utilisé des dates par défaut au lieu de spécifier des dates.

<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)
&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)
&amp;popup_datepicker=false(ENDIF)</URL>

Si la valeur est true, Bing restitue l’URL comme suit :

http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true

Sinon, Bing restitue l’URL comme suit :

http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false

Règles générales

  • Utilisez la XSD PointsOfSale pour valider votre fichier de flux points de vente avant de l’envoyer à Bing.

  • Le document de flux de points de vente doit utiliser l’encodage UTF-8.

  • Le flux doit inclure des points de vente pour tous les sites que les utilisateurs utilisent pour réserver des salles . Le processus de flux ne prend pas en charge les mises à jour partielles.

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

  • Les éléments doivent être dans l’ordre spécifié dans la XSD PointsOfSale.

  • 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 de nom complet pour un hôtel, n’incluez pas d’élément DisplayNames> vide<.

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

Étapes suivantes

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

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

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

Une fois que vous avez correctement importé votre flux de points de vente et votre flux d’hôtel, vous pouvez commencer à envoyer vos données de tarification et de disponibilité. Pour plus d’informations, consultez Messages de transaction.