Criar um feed de preços de metadados

Se utilizar pacotes de salas, normalmente cria um Feed de preços que contém apenas dados de sala e pacote. Utilizar uma mensagem separada para os metadados é melhor do que incluí-la na mesma mensagem com dados de itinerário, uma vez que não é alterada tantas vezes como os dados de itinerário e liberta espaço para os dados do itinerário.

Os feeds de preços estão limitados a 100 MB de dados não comprimidos ou 10 MB de dados comprimidos (com compressão GZip). Para reduzir o tráfego de rede, deve enviar dados comprimidos.

O feed Preço deve conter apenas os metadados que está a adicionar ou atualizar. Não inclua metadados que não tenham sido alterados desde a última vez que enviou uma mensagem.

O documento tem de utilizar a codificação UTF-8 e tem de estar em conformidade com o XSD de Transação.

Importante

Tem de ler e seguir todas as políticas de Anúncios de Preços de Hotel. Para obter a lista de políticas, veja Políticas de programas piloto.

Nota

O Bing não suporta todos os elementos XSD de Transação. O Bing ignora qualquer elemento ou atributo na mensagem que não suporta. A Referência do Feed de preços inclui apenas os elementos e atributos suportados pelo Bing.

Nota

A mensagem tem de especificar os elementos na ordem definida no XSD de Transação (ou conforme mostrado na referência).

Importante

Embora possa especificar espaço e empacotar inline com um itinerário, não é recomendado porque é ineficiente, provavelmente redundante e diminui a quantidade de espaço disponível para itinerários.

O elemento Transação de nível superior

Para fornecer ao Bing a sua sala e empacotar dados, crie um documento XML que contenha um Feed de preços. A mensagem contém um elemento Transação de nível superior único.

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

Tem de especificar os timestamp atributos e id .

O timestamp atributo deve identificar a hora em que submete a mensagem. O Bing utiliza o carimbo de data/hora para garantir que processa apenas os metadados mais recentes. Por exemplo, se o Bing processar uma mensagem com um carimbo de data/hora de 14:10 e, em seguida, processar uma mensagem com um carimbo de data/hora de 14:09, o Bing só processa os metadados na mensagem 14:09 que não foram incluídos na mensagem 14:10.

O id atributo é um ID definido pelo utilizador que identifica exclusivamente a mensagem para o anunciante. O anunciante utiliza o ID para identificar a mensagem na lista de relatórios de estado do feed de propriedades.

Especificar os metadados

O Transaction elemento contém uma lista de elementos PropertyDataSet , um para cada propriedade para a qual está a definir metadados. A mensagem deve incluir apenas novos metadados ou os que foram alterados.

O seguinte mostra um PropertyDataSet elemento para a propriedade 12345. O Property ID tem de corresponder ao ID de uma propriedade no ficheiro de feed de propriedades. Pode especificar qualquer número de RoomData e PackageData elemento.

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

Especifique um RoomData objeto para cada tipo de sala e capacidade que está disponível na propriedade . O exemplo seguinte mostra todos os elementos que pode especificar. Quanto mais informações puder fornecer, melhor, mas os únicos elementos necessários são RoomID e Name. Embora seja opcional, também deve incluir Capacitysempre . Na maioria dos casos, também inclui Occupancy , a menos que o pacote o especifique (por exemplo, um pacote de lua-de-mel para dois).

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

Especifique um PackageData objeto para cada pacote de comodidades que definir. Embora possa especificar Capacity e Occupancy no pacote, normalmente inclui-os no RoomData. No entanto, incluiria Occupancy se PackageData o pacote se baseasse na ocupação, como um pacote de lua-de-mel que é para dois. A única amenidade necessária é Reembolsável. Este exemplo mostra as múltiplas formas de especificar valores booleanos.

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

Passos seguintes

Antes de enviar Feeds de preços, certifique-se de que o ficheiro de feed de propriedades está atualizado. Para atualizar os ficheiros de feed, contacte a sua TAM. Depois de a TAM importar os dados para o Bing, pode começar a enviar Feeds de preços. Os feeds de preços enviados antes da importação dos dados falharão.

Valide o feed Price antes de o enviar para o Bing. Para obter informações, consulte Validar o feed Price.

Para obter informações sobre como enviar o Feed de preços do Bing, veja Pushing Price feeds to Bing or Having Bing Pull Price feeds (Enviar Feeds de preços push para o Bing) ou Having Bing Pull Price feeds (Enviar Feeds de preços para o Bing) ou Having Bing Pull Price feeds (Enviar Feeds de preços pull do Bing).

Para obter informações sobre como utilizar os metadados nos seus itinerários, consulte Utilizar Pacotes de Salas.