Crear una fuente de precios (anteriormente Mensaje de transacción)
Para proporcionar a Bing los datos de precios y disponibilidad del hotel, cree un documento XML que contenga una fuente de precios. La fuente Precio contiene una lista de fechas de registro, duración de la estancia y precios.
Las fuentes de precios pueden contener hasta 180 días de reserva previa, y cada reserva puede especificar hasta 14 noches de estancia. La fecha de registro de entrada y la duración de la estancia se conocen como itinerario. Si especifica el número máximo de itinerarios, el mensaje contendrá 2520 itinerarios.
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.
Una fuente de precios solo debe contener itinerarios que esté agregando o actualizando; no incluya itinerarios 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).
Elemento Transaction de nivel superior
Las fuentes de precios contienen 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 itinerarios 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 itinerarios en el 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 la lista de itinerarios
El Transaction elemento contiene una lista de elementos Result , uno para cada itinerario que define. El mensaje solo debe incluir itinerarios nuevos o aquellos que han cambiado.
A continuación se muestra un Result elemento que especifica los elementos secundarios necesarios.
<Result>
<Property>13579</Property>
<Checkin>2017-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
</Result>
El Property identificador debe coincidir con el identificador de una propiedad en el archivo de fuente de propiedades. La Checkin fecha debe estar dentro del período de reserva anticipada de 90 días y Nights debe estar en el intervalo de 1 a 14.
Baserate especifica el costo de toda la duración de la estancia y no la tarifa de habitación por noche.
Si permite reservaciones con cinco días de anticipación y estancias de hasta tres noches, el mensaje contendrá 15 Result elementos. En el ejemplo siguiente se muestran los itinerarios de un día.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
Después de definir los 15 itinerarios, cada mensaje posterior incluiría solo los itinerarios que cambiaron. Por ejemplo, cambios de precios o disponibilidad.
Eliminación de itinerarios
Para quitar un itinerario, establezca sus Baserateelementos , Taxy OtherFees en -1.00. Bing elimina automáticamente los itinerarios con fechas de registro pasadas.
Uso de los elementos Result opcionales
A continuación se muestra un Result elemento que incluye los elementos secundarios opcionales.
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<ExpirationTimestamp>2017-05-28T09:00:34Z</ExpirationTimestamp>
<ChargeCurrency>deposit</ChargeCurrency>
<Custom1>summer2017</Custom1>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
Use ExpirationTimestamp para especificar una fecha de expiración para el itinerario. Por ejemplo, en el caso 1, se sirve el itinerario.
Caso 1:
Hoy = 16/3/2018
CheckInDate = 1/4/2018
ExpirationTimestamp = 20/3/2018
Pero en el caso 2, no se sirve el itinerario.
Caso 2:
Hoy = 21/03/2018
CheckInDate = 1/4/2018
ExpirationTime = 20/3/2018
Utilice el ChargeCurrency elemento para especificar cuándo se cobra al usuario por la reserva. De forma predeterminada, el usuario paga cuando reserva (esta es la opción web). En este ejemplo se usa Deposit, que pide al usuario que pague una parte en la reserva y el resto más adelante (por ejemplo, cuando se desproteger).
Use uno o varios de los cinco Custom elementos para proporcionar valores de sustitución para los parámetros dinámicos en una dirección URL de punto de venta (POS). Por ejemplo, si la dirección URL del PDV es https://www.partnerdomain.com?promo=(CUSTOM1) y Custom1 está establecida en summer2017, la dirección URL de PDV que usa Bing es https://www.partnerdomain.com?promo=summer2017. Para obtener más información, consulte Uso de parámetros de consulta dinámica.
La suma de todos los valores Custom[1-5] se limita a un máximo de 1000 caracteres, pero tenga en cuenta que el límite práctico puede ser menor dada la longitud máxima de una dirección URL.
Use el AllowablePointsOfSale elemento para especificar direcciones URL de PDV específicas que el usuario puede usar para reservar. De forma predeterminada, el usuario puede usar cualquier PDV en el archivo de fuente de páginas de aterrizaje del asociado. El id atributo debe coincidir con un POS en el archivo de fuente.
Pasos siguientes
Antes de enviar fuentes de precios, asegúrese de que el archivo de fuente de propiedades y el archivo de páginas de aterrizaje están actualizados. Para actualizar estos archivos, 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 cómo agregar paquetes de salas a los itinerarios, consulte Creación de una fuente de precios de metadatos y Uso de paquetes de salas.