Share via

Créer un message de transaction de métadonnées

  • Article

Si vous utilisez des offres groupées de salles, vous créez généralement un message de transaction qui contient uniquement des données de salle et de package. Il est préférable d’utiliser un message distinct pour les métadonnées plutôt que de l’inclure dans le même message avec des données d’itinéraire, car il ne change pas aussi souvent que les données d’itinéraire et libère de l’espace pour les données d’itinéraire.

Les messages de transaction sont limités à 100 Mo de données non compressées ou à 10 Mo de données compressées (à l’aide de la compression GZip). Pour réduire le trafic réseau, vous devez envoyer des données compressées.

Le message de transaction doit contenir uniquement les métadonnées que vous ajoutez ou mettez à jour. N’incluez pas les métadonnées qui n’ont pas changé depuis la dernière fois que vous avez envoyé un message.

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

Importante

Vous devez lire et suivre toutes les politiques de Hotel Price Ads. Pour obtenir la liste des stratégies, consultez Stratégies de programmes pilotes.

Remarque

Bing ne prend pas en charge tous les éléments Transaction XSD. Bing ignore tout élément ou attribut dans le message qu’il ne prend pas en charge. La référence des messages de transaction inclut uniquement les éléments et attributs pris en charge par Bing.

Remarque

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

Importante

Bien que vous pouvez spécifier la salle et le package en ligne avec un itinéraire, cela n’est pas recommandé, car il est inefficace, probablement redondant et réduit la quantité d’espace disponible pour les itinéraires.

Élément Transaction de niveau supérieur

Pour fournir à Bing vos données de salle et de package, créez un document XML qui contient un message de transaction. Le message contient un seul élément Transaction de niveau supérieur.

<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">

Vous devez spécifier les timestamp attributs et id .

L’attribut timestamp doit identifier l’heure à laquelle vous envoyez le message. Bing utilise l’horodatage pour s’assurer qu’il traite uniquement les métadonnées les plus récentes. Par exemple, si Bing traite un message avec un horodatage de 14 :10, puis traite un message avec un horodatage de 14 :09, Bing traite uniquement les métadonnées du message 14 :09 qui n’étaient pas incluses dans le message 14 :10.

L’attribut id est un ID défini par l’utilisateur qui identifie de façon unique le message à l’annonceur. L’annonceur utilise l’ID pour identifier le message dans la liste des rapports de flux d’hôtel status.

Spécification des métadonnées

L’élément Transaction contient une liste d’éléments PropertyDataSet , un pour chaque propriété pour laquelle vous définissez des métadonnées. Le message doit inclure uniquement les nouvelles métadonnées ou celles qui ont changé.

L’exemple suivant montre un PropertyDataSet élément pour la propriété 12345. L’ID Property doit correspondre à l’ID d’une propriété dans votre fichier de flux d’hôtel. Vous pouvez spécifier n’importe quel nombre d’éléments RoomData et PackageData .

  <PropertyDataSet>
    <Property>88888</Property>
    <RoomData>. . .</RoomData>
    <RoomData>. . .</RoomData>
    <RoomData>. . .</RoomData>
    <PackageData>. . .</PackageData>
    <PackageData>. . .</PackageData>
  </PropertyDataSet>

Spécifiez un RoomData objet pour chaque type de salle et de capacité disponible dans la propriété . L’exemple suivant montre tous les éléments que vous pouvez spécifier. Plus vous pouvez fournir d’informations, mieux c’est, mais les seuls éléments requis sont RoomID et Name. Bien que facultatif, vous devez toujours inclure Capacityégalement . Dans la plupart des cas, vous incluez Occupancy également, sauf si le package le spécifie (par exemple, un package lune de miel pour deux).

  <RoomData>
    <RoomID>12345</RoomID>
    <Name>
      <Text text="Double queen room - Non-smoking" language="en" />
    </Name>
    <Description>
      <Text text="A spacious, non-smoking room with two queen beds" language="en" />
    </Description>
    <PhotoURL>
      <URL>https://mydomain.com/pic1.jpg</URL>
      <Caption>
        <Text text="Desk with USB outlets for charging your devices" language="en" />
      </Caption>
    </PhotoURL>
    <Capacity>4</Capacity>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
    </OccupancyDetails>
  </RoomData>

Spécifiez un PackageData objet pour chaque package de commodités que vous définissez. Bien que vous puissiez spécifier Capacity et Occupancy dans le package, vous les incluez généralement dans RoomData. Toutefois, vous incluez Occupancy dans PackageData si le forfait est basé sur l’occupation, par exemple un forfait lune de miel qui est pour deux. Le seul agrément requis est Remboursable. Cet exemple montre les différentes façons dont vous pouvez spécifier des valeurs booléennes.

  <PackageData>
    <PackageID>67890</PackageID>
    <Name>
      <Text text="Standard" language="en" />
    </Name>
    <Description>
      <Text text="Standard room package that applies to most rooms" language="en" />
    </Description>
    <Capacity>4</Capacity>
    <Occupancy>2</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
    </OccupancyDetails>
    <ChargeCurrency>Web</ChargeCurrency>
    <Refundable available="true" refundable_until_days="2" refundable_until_time="17:00:00" />
    <BreakfastIncluded/>
    <ParkingIncluded>true</ParkingIncluded>
    <InternetIncluded>1</InternetIncluded>
    <MembershipBenefitsIncluded>
      <ProgramName>
        <Text text="Holiday" language="en" />
      </ProgramName>
      <ProgramLevel>
        <Text text="Platinum" language="en" />
      </ProgramLevel>
      <NightlyValue currency="USD">50.00</NightlyValue>
    </MembershipBenefitsIncluded>
    <CarRentalIncluded/>
    <MilesIncluded>
      <NumberOfMiles>1500</NumberOfMiles>
      <Provider>
        <Text text="Contoso" language="en" />
      </Provider>
    </MilesIncluded>
    <OnPropertyCredit currency="USD">25.00</OnPropertyCredit>
  </PackageData>

Prochaines étapes

Avant d’envoyer des messages de transaction, assurez-vous que votre fichier de flux d’hôtel est à jour. Pour mettre à jour les fichiers de flux, contactez votre TAM. Une fois que le TAM a importé les données dans Bing, vous pouvez commencer à envoyer des messages de transaction. Les messages de transaction envoyés avant l’importation des données échouent.

Validez le message de transaction avant de l’envoyer à Bing. Pour plus d’informations, consultez Validation de votre message de transaction.

Pour plus d’informations sur l’envoi bing de votre message de transaction, consultez Envoi de messages de transaction à Bing ou Envoi de messages de transaction Pull Bing.

Pour plus d’informations sur l’utilisation des métadonnées dans vos itinéraires, consultez Utilisation de bundles de salles.