Creación de una fuente de precios de metadatos (anteriormente mensaje de transacción)

Si usa agrupaciones de salas, normalmente se crea una fuente de precios que contiene solo datos de espacio y paquete. El uso de un mensaje independiente para los metadatos es mejor que incluirlo en el mismo mensaje con datos de itinerario, ya que no cambia tan a menudo como los datos del itinerario y libera espacio para los datos del itinerario.

Las fuentes de precios están limitadas a 100 MB de datos sin comprimir o 10 MB de datos comprimidos (mediante compresión GZip). Para reducir el tráfico de red, debe enviar datos comprimidos.

La fuente precio solo debe contener los metadatos que va a agregar o actualizar, no incluir metadatos que no hayan cambiado desde la última vez que envió un mensaje.

El documento debe usar la codificación UTF-8 y debe ajustarse al XSD de transacción.

Importante

Debe leer y seguir todas las directivas de Hotel Price Ads. Para obtener la lista de directivas, consulte Directivas de programas piloto.

Nota:

Bing no admite todos los elementos XSD de transacción. Bing omite cualquier elemento o atributo del mensaje que no admite. La referencia de fuente de precios solo incluye los elementos y atributos que admite Bing.

Nota:

El mensaje debe especificar los elementos en el orden definido en transaction XSD (o como se muestra en la referencia).

Importante

Aunque puede especificar la habitación y el paquete en línea con un itinerario, no se recomienda porque es ineficaz, probablemente redundante y reduce la cantidad de espacio disponible para los itinerarios.

Elemento Transaction de nivel superior

Para proporcionar a Bing los datos de habitación y paquete, cree un documento XML que contenga una fuente de precios. El mensaje contiene un único elemento Transaction de nivel superior.

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

Debe especificar los timestamp atributos y id .

El timestamp atributo debe identificar la hora en que envía el mensaje. Bing usa la marca de tiempo para asegurarse de que procesa solo los metadatos más recientes. Por ejemplo, si Bing procesa un mensaje con una marca de tiempo de 14:10 y, a continuación, procesa un mensaje con una marca de tiempo de 14:09, Bing solo procesa los metadatos del mensaje 14:09 que no se incluyeron en el mensaje 14:10.

El id atributo es un identificador definido por el usuario que identifica de forma única el mensaje al anunciante. El anunciante usa el identificador para identificar el mensaje en la lista de informes de estado de fuente de propiedades.

Especificación de los metadatos

El Transaction elemento contiene una lista de elementos PropertyDataSet , uno para cada propiedad para la que se definen los metadatos. El mensaje debe incluir solo los metadatos nuevos o los que han cambiado.

A continuación se muestra un PropertyDataSet elemento para la propiedad 12345. El Property identificador debe coincidir con el identificador de una propiedad en el archivo de fuente de propiedades. Puede especificar cualquier número de RoomData y PackageData elemento.

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

Especifique un RoomData objeto para cada tipo de habitación y capacidad que esté disponible en la propiedad . En el ejemplo siguiente se muestran todos los elementos que puede especificar. Cuanto más información pueda proporcionar, mejor, pero los únicos elementos necesarios son RoomID y Name. Aunque es opcional, siempre debe incluir Capacity, también. En la mayoría de los casos, también se incluye Occupancy a menos que el paquete lo especifique (por ejemplo, un paquete de luna de miel que sea para dos).

  <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 un PackageData objeto para cada paquete de servicios que defina. Aunque puede especificar Capacity y Occupancy en el paquete, normalmente los incluye en RoomData. Sin embargo, incluiría Occupancy en PackageData si el paquete se basa en la ocupación, como un paquete de luna de miel que es para dos. El único servicio que se requiere es reembolsable. En este ejemplo se muestran las distintas formas en que puede 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>

Pasos siguientes

Antes de enviar fuentes de precios, asegúrese de que el archivo de fuente de propiedades está actualizado. Para actualizar los archivos de fuente, póngase en contacto con el TAM. Después de que el TAM importe los datos en Bing, puede empezar a enviar fuentes de precios. Se producirá un error en las fuentes de precios enviadas antes de importar los datos.

Valide la fuente de precios antes de enviarla a Bing. Para obtener información, consulte Validación de la fuente de precios.

Para obtener información sobre el envío de Bing a la fuente de precios, consulte Inserción de fuentes de precios a Bing o Tener fuentes de precios de extracción de Bing.

Para obtener información sobre el uso de los metadatos en los itinerarios, consulte Uso de paquetes de salas.