Introducción a los mensajes de transacción
Nota:
Esta versión beta de Hotel Price Ads solo está disponible para seleccionar participantes. Para obtener información sobre cómo participar en el programa de versión beta, póngase en contacto con el administrador de cuentas o inscríbase aquí.
Si crea campañas de anuncios de hotel en Microsoft Advertising, use mensajes de transacción para actualizar los datos del itinerario (precios y disponibilidad).
Para poder enviar mensajes de transacción de Microsoft, debe ponerse en contacto con el administrador de cuentas para registrarse.
Diferentes modos para enviar a Microsoft los datos del itinerario
Microsoft admite los siguientes modos que puede usar para proporcionar los datos del itinerario.
- Modo de inserción
- Modo de extracción
- Modo de extracción con sugerencias
Con el modo de inserción, envía a Microsoft las actualizaciones no solicitadas a los intervalos que elija. Para usar este modo, debe proporcionar las direcciones IPv4 (o intervalos de direcciones en formato CIDR) de todos los servidores que usará para enviar mensajes de transacción. Para obtener información, consulte Inserción de mensajes de transacción en Microsoft.
Con las opciones del modo de extracción , Microsoft le envía mensajes de consulta que especifican los datos del itinerario de hotel que debe devolver. La diferencia entre los dos modos de extracción es la cantidad de datos que se envían a Microsoft. Con el modo de extracción, se devuelven datos para todos los itinerarios y todos los hoteles. Pero con la extracción con sugerencias, indica a Microsoft qué datos han cambiado y solo solicita esos datos. Para obtener información, consulte Tener mensajes de transacción de extracción de Microsoft.
¿Qué es un mensaje de transacción?
Un mensaje de transacción es un documento XML que contiene datos de precios y disponibilidad para una o varias propiedades de hotel. Para cada propiedad del hotel, especifique un Result elemento para cada Checkin y Nights combinación (también conocido como itinerario) en su ventana de reserva avanzada. 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">100.00</Baserate>
<Tax currency="USD">10.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">8.00</OtherFees>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">300.00</Baserate>
<Tax currency="USD">30.00</Tax>
<OtherFees currency="USD">12.00</OtherFees>
</Result>
</Transaction>
Puede especificar hasta 180 días de reserva previa con estancias de hasta 14 noches. Por ejemplo, si el del mensaje timestamp es 2017-06-10, la última Checkin fecha que puede especificar el mensaje es 2017-09-08.
El documento debe usar la codificación UTF-8.
Validar el mensaje antes de enviarlo
Antes de enviar a Microsoft el mensaje de transacción, use transaction XSD para validar el mensaje. Esto ahorra tiempo y recorridos de ida y vuelta mediante la captura de errores y restricciones de sintaxis de documento impuestos por xsd.
En el ejemplo siguiente se muestra el uso de xmllint para validar el mensaje contenido en SampleTransaction.xml.
xmllint.exe --schema transaction.xsd SampleTransaction.xml
Nota:
Hay restricciones no definidas por xsd que pueden generar errores en el momento en que Microsoft procesa el mensaje. Asegúrese de que el mensaje cumple todas las restricciones definidas en este documento.