Creare un messaggio di transazione dei metadati

Se si usano i bundle della sala, in genere si crea un messaggio di transazione che contiene solo i dati della sala e del pacchetto. L'uso di un messaggio separato per i metadati è preferibile che includerlo nello stesso messaggio con i dati dell'itinerario perché non cambia con la frequenza dei dati dell'itinerario e libera spazio per i dati dell'itinerario.

I messaggi di transazione sono limitati a 100 MB di dati non compressi o a 10 MB di dati compressi (usando la compressione GZip). Per ridurre il traffico di rete, è necessario inviare dati compressi.

Il messaggio di transazione deve contenere solo i metadati che si sta aggiungendo o aggiornando. Non includere metadati che non sono stati modificati dall'ultima volta che è stato inviato un messaggio.

Il documento deve usare la codifica UTF-8 e deve essere conforme a Transaction XSD.

Importante

È necessario leggere e seguire tutte le politiche di Hotel Price Ads. Per l'elenco dei criteri, vedere Criteri dei programmi pilota.

Nota

Bing non supporta tutti gli elementi XSD delle transazioni. Bing ignora qualsiasi elemento o attributo nel messaggio che non supporta. Transaction Message Reference include solo gli elementi e gli attributi supportati da Bing.

Nota

Il messaggio deve specificare gli elementi nell'ordine definito in Transaction XSD (o come illustrato nel riferimento).

Importante

Anche se è possibile specificare spazio e pacchetto inline con un itinerario, non è consigliabile perché è inefficiente, probabilmente ridondante e riduce la quantità di spazio disponibile per gli itinerari.

Elemento Transaction di primo livello

Per fornire a Bing i dati della sala e del pacchetto, creare un documento XML contenente un messaggio di transazione. Il messaggio contiene un singolo elemento Transaction di primo livello.

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

È necessario specificare gli timestamp attributi e id .

L'attributo timestamp deve identificare l'ora in cui si invia il messaggio. Bing usa il timestamp per assicurarsi che elabori solo i metadati più recenti. Ad esempio, se Bing elabora un messaggio con timestamp 14:10 e quindi elabora un messaggio con timestamp 14:09, Bing elabora solo i metadati nel messaggio 14:09 non inclusi nel messaggio 14:10.

L'attributo id è un ID definito dall'utente che identifica in modo univoco il messaggio all'inserzionista. L'inserzionista usa l'ID per identificare il messaggio nell'elenco dei report sullo stato del feed dell'hotel.

Specifica dei metadati

L'elemento Transaction contiene un elenco di elementi PropertyDataSet , uno per ogni proprietà per cui si definiscono i metadati. Il messaggio deve includere solo i nuovi metadati o quelli modificati.

Di seguito viene illustrato un PropertyDataSet elemento per la proprietà 12345. L'ID Property deve corrispondere all'ID di una proprietà nel file del feed dell'hotel. È possibile specificare un numero qualsiasi di RoomData elementi e PackageData .

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

Specificare un RoomData oggetto per ogni tipo di stanza e capacità disponibile nella proprietà . L'esempio seguente mostra tutti gli elementi che è possibile specificare. Maggiori sono le informazioni che è possibile fornire, ma gli unici elementi necessari sono RoomID e Name. Anche se facoltativo, è consigliabile includere Capacitysempre anche . Nella maggior parte dei casi, si include Occupancy anche a meno che il pacchetto non lo specifichi (ad esempio, un pacchetto luna di miele per due).

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

Specificare un PackageData oggetto per ogni pacchetto di servizi definiti. Anche se è possibile specificare Capacity e Occupancy nel pacchetto, in genere vengono inclusi in RoomData. Tuttavia, è necessario includere Occupancy in PackageData se il pacchetto è basato sull'occupazione, ad esempio un pacchetto luna di miele che è per due. L'unica comodità necessaria è Rimborsabile. In questo esempio vengono illustrati i diversi modi in cui è possibile specificare valori booleani.

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

Passaggi successivi

Prima di inviare messaggi di transazione, assicurarsi che il file del feed dell'hotel sia aggiornato. Per aggiornare i file del feed, contattare il TAM. Dopo che TAM ha importato i dati in Bing, è possibile iniziare a inviare messaggi di transazione. I messaggi di transazione inviati prima dell'importazione dei dati avranno esito negativo.

Convalidare il messaggio di transazione prima di inviarlo a Bing. Per informazioni, vedere Convalida del messaggio di transazione.

Per informazioni sull'invio di Bing al messaggio di transazione, vedere Push transaction messages to Bing (Push dei messaggi di transazione a Bing ) o Having Bing Pull Transaction Messages (Messaggi di transazione pull Bing).

Per informazioni sull'uso dei metadati negli itinerari, vedere Uso dei bundle di sala.