Condividi tramite


Creare un feed di prezzi dei metadati (in precedenza messaggio di transazione)

Se si usano bundle di camere, in genere si crea un feed Price 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 feed di prezzo 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 feed Prezzi deve contenere solo i metadati che si sta aggiungendo o aggiornando, senza 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. Il riferimento al feed di prezzi 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 stanza e del pacchetto, creare un documento XML contenente un feed prezzi. 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 di proprietà.

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 di proprietà. È 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 i feed di prezzo, assicurarsi che il file del feed di proprietà sia aggiornato. Per aggiornare i file del feed, contattare il TAM. Dopo che il TAM ha importato i dati in Bing, è possibile iniziare a inviare feed price. I feed di prezzo inviati prima dell'importazione dei dati avranno esito negativo.

Convalidare il feed Prezzi prima di inviarlo a Bing. Per informazioni, vedere Convalida del feed di prezzi.

Per informazioni sull'invio di Bing al feed di prezzi, vedere Push dei feed price in Bing o Having Bing Pull Price feeds .For information about Bing your Price feed, see Push Price feeds to Bing or Having Bing Pull Price feeds.For information about Bing your Price feed, see Push Price feeds to Bing or Having Bing Pull Price feeds.

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