El modo de entrega determina cómo envías las actualizaciones de precios a Google para las combinaciones de hoteles e itinerarios. Tú y tu administrador técnico de cuentas (TAM) trabajan juntos durante la configuración inicial para establecer tu modo de entrega.
Descripción general de los modos de entrega
De forma predeterminada, se puede consultar la disponibilidad de un hotel con hasta 330 días de anticipación y hasta 30 noches de estadía, pero puedes determinar la cantidad máxima de itinerarios (combinación de fecha de entrada y duración de la estadía).
Cuantos más itinerarios admitas, en más subastas participarás. Sin embargo, cuantos más itinerarios admitas, más datos deberás enviar a Google para mantener la precisión de los datos de precios.
Los métodos típicos para actualizar los precios usan mensajes de Transaction de una de las siguientes maneras:
ARI (Push): Es un feed de entrega de precios que utiliza planes de tarifas, disponibilidad y metadatos de hoteles para establecer estrategias de precios predefinidas para tus propiedades. A diferencia de las solicitudes de precios a terceros y los precios modificados, los feeds de ARI no consultan precios ni itinerarios específicos. En cambio, envías mensajes que contienen un subconjunto de información que representa un modelo de precios para tus propiedades en función de diversos detalles de tarifas, restricciones y disponibilidad. Los feeds del ARI usan la especificación XML de la OTA (
OTA_HotelRateAmountNotifRQyOTA_HotelAvailNotifRQ) para definir la disponibilidad y los precios. Comunícate con tu administrador de cuentas para obtener más información sobre el modo de entrega de ARI y determinar si este tipo de feed es el más adecuado para tu cuenta. Para obtener más información, consulta Usa la ARI.Extracción: Google consulta tu servicio de forma periódica para actualizar su caché de datos de precios y disponibilidad. En este modelo, Google envía una solicitud a tu servidor, y este responde con datos actualizados. Este modelo es el más adecuado si no sabes con exactitud cuándo cambia la información de precios o si esta cambia de forma irregular a lo largo del día. Los precios permanecen en la caché hasta que los algoritmos de Google determinan que se volvieron obsoletos, según el historial de cambios de precios anteriores específicos de cada socio. Para obtener más información, consulta Cómo usar el modo de entrega Pull.
Precios modificados (anteriormente, “solicitud de precios a terceros con sugerencias”): Similar a la extracción, excepto que Google solo solicita datos para un subconjunto de propiedades, no para todas. Este modo puede reducir significativamente la cantidad de tráfico de red cuando actualizas los precios y la disponibilidad de tus propiedades. Los precios permanecen en la caché de forma indefinida hasta que se actualizan. Para obtener más información, consulta Cómo usar los precios modificados.
Además de actualizar los precios, puedes usar los mensajes de transacción para quitar propiedades de tu inventario. Para obtener más información, consulta Cómo quitar inventario.
Para obtener más información sobre cómo proporcionar actualizaciones de precios, incluidos ejemplos de mensajes de transacción, consulta Actualización de precios.
Consultas de precios en tiempo real
Google también puede solicitar algunas actualizaciones de precios en el momento de la subasta con las consultas de precios en tiempo real. Las consultas de precios en tiempo real son solicitudes de precios de Google para una subasta actual. Si respondes dentro del plazo especificado, tu anuncio debería aparecer en la subasta.
Google almacena la respuesta a una búsqueda de precios en tiempo real de la misma manera que lo hace con cualquier otro mensaje de transacción. Como resultado, Google puede publicar el precio desde su caché en lugar de enviar otra solicitud de precios en tiempo real en el futuro.
Para obtener más información, consulta Consultas de precios en tiempo real.
Contexto
Por lo general, las búsquedas de precios de tipo Pull y Changed no especifican información sobre el usuario, ya que Google usa tus respuestas para completar una caché que se podría usar para publicar contenido para una variedad de usuarios diferentes.
Dado que podría ser costoso para ti devolver precios correspondientes a un conjunto completo de contextos del usuario posibles, se está probando una función en la que los contextos del usuario populares se especifican como parte de la búsqueda. Los contextos del usuario se basan en las solicitudes de los usuarios en las que tuviste la oportunidad de mostrar un precio y se calculan para abarcar la gran mayoría de las solicitudes de los usuarios. Es posible que veas una gran cantidad de contextos del usuario para propiedades o itinerarios muy populares, pero la cantidad promedio de contextos del usuario debería ser inferior a 10. Puedes devolver precios adicionales o ignorar los contextos del usuario especificados. Tú decides qué precios devolver para una búsqueda determinada. Sin embargo, ignorar un contexto del usuario sugerido podría generar menos tráfico.
Modo de entrega de extracción de ARI
Con el modo de entrega ARI Push, envías actualizaciones incrementales a Google cada vez que cambian las tarifas por noche, la disponibilidad, los recuentos de inventario o cualquier otra restricción. A diferencia de la solicitud de precios a terceros o los precios modificados, la actualización externa de precios de ARI te permite usar un modelo de precios diferente para actualizar de manera eficiente varios componentes de la información de precios en Google.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta para el modo de entrega de ARI Push:
Paso 1: Envía mensajes push de ARI a Google
Para actualizar tus datos con ARI Push, envía un mensaje de solicitud de ARI cada vez que cambien tus datos. El modo de entrega Push de la ARI admite varios tipos de mensajes y estrategias de precios. Para obtener información detallada sobre el envío de mensajes, consulta Usa ARI.
Google debe publicar tus precios, y los usuarios deben poder verlos entre 15 y 20 minutos después de que se reciba un mensaje.
Paso 2: Confirma que Google almacenó los datos en caché correctamente
Para cada mensaje de ARI Push que recibe, Google responde con el estado de la conexión HTTP y los resultados del procesamiento de ARI. Google responde con un HTTP 200 OK si la conexión al servidor se realiza correctamente. También incluye un cuerpo con un mensaje de respuesta que indica si las actualizaciones se aplicaron correctamente o si se encontraron advertencias o errores del modo de entrega.
Cómo agregar direcciones IP a la lista de entidades permitidas
Para incluir en la lista de entidades permitidas las direcciones IP que usas para enviar mensajes de ARI a Google, usa la página de configuración de precios de ARI de Hotel Center. Obtén más información para actualizar la configuración de precios en Hotel Center.
Actualiza los metadatos de la habitación y el paquete con ARI Push
Usa el tipo de mensaje Transaction (datos de la propiedad) para definir los tipos de habitación y los planes de tarifas (paquetes) activos para cada propiedad.
Debes enviar actualizaciones cada vez que se agreguen, quiten o modifiquen tipos de habitación o planes de tarifas. En este caso, envías un mensaje XML con la información nueva en los elementos <RoomData> y <PackageData>. Estos elementos son secundarios del elemento <PropertyDataSet>.
Errores de conexión o contenido
Si recibes un error de modo de entrega debido a que el archivo XML está mal formado o es incorrecto, busca la resolución recomendada en Mensajes de error de estado del feed.
Si recibes un error de conexión HTTP cuando envías un mensaje de ARI a Google, vuelve a intentar la solicitud en intervalos de 1, 5 y 20 minutos. Si el problema persiste después de 3 reintentos, deja de enviar mensajes y comunícate con el equipo de asistencia al cliente de Google.
Modo de entrega de extracción
Con el modo de entrega Pull, Google envía periódicamente mensajes de Query a tu servidor para solicitar actualizaciones de precios. Tu servidor responde a esos mensajes con mensajes de transacción que contienen datos actualizados de precios y disponibilidad.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta de Pull:
Después de recibir las actualizaciones de precios, Google suele procesar los nuevos datos de precios y disponibilidad en aproximadamente 5 minutos.
En las siguientes secciones, se describe cada uno de estos pasos con más detalle.
Paso 1: Mensaje de consulta
De forma predeterminada, Google envía mensajes de Query para todas las propiedades definidas en tu Lista de hoteles. Esto podría significar que deberías recibir varios mensajes de Query durante los procesos de cambio de precio.
Los mensajes de consulta de precios que Google envía a tu servidor tienen las siguientes características:
- El elemento raíz es
<Query>. - Se envía al extremo definido durante la configuración inicial. Para obtener más información, comunícate con tu administrador técnico de cuentas (TAM).
- Usa el método HTTP
POST. (Si usas HTTPS, debes obtener la firma del dominio de una autoridad certificadora oficial). - El encabezado
Content-Typese establece enapplication/xml. - Cada mensaje incluye hasta 100 propiedades para las que Google solicita datos de precios y disponibilidad.
- El encabezado
User-Agentse establece enGoogle-HotelAdsPrices.
Paso 2: Mensaje de transacción
Cuando tu servidor recibe un mensaje de Query, debe responder con un mensaje de Transaction que contenga información sobre los precios de los itinerarios solicitados.
El elemento raíz de un mensaje de Transaction es <Transaction>. Para obtener más información, consulta Mensajes de transacción y Actualización de precios.
Actualiza los metadatos de la sala y el paquete
Además de actualizar los datos de precios con Pull, también puedes usar mensajes de Transaction para actualizar los metadatos de tus habitaciones y paquetes. Para obtener más información, consulta Cómo definir metadatos de habitación y paquete.
Modo de entrega de precios modificados
Los precios modificados ayudan a reducir el tamaño y la cantidad de mensajes de Query y Transaction para las actualizaciones de precios. Cuando usas los precios modificados, le envías a Google una lista de las propiedades que tienen precios actualizados. Google responde con un mensaje de Query que solo solicita los precios de esas propiedades.
Para configurar el extremo al que Google envía mensajes de Hint Request, consulta a tu administrador técnico de cuentas (TAM). Deberías haber configurado esto durante la configuración inicial.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta para los precios modificados:
En las siguientes secciones, se describe cada uno de los pasos de este flujo.
Paso 1: Mensaje de solicitud de sugerencia
Los mensajes de solicitud de sugerencia que Google envía a tu servidor tienen las siguientes características:
- El elemento raíz es
<HintRequest>. - Se envía al extremo definido durante la configuración inicial. Para obtener más información, comunícate con tu administrador técnico de cuentas (TAM).
- Usa el método HTTP
POST. (Si usas HTTPS, deberás obtener la firma del dominio de una autoridad certificadora oficial). - El encabezado
Content-Typese establece enapplication/xml. - Con una frecuencia especificada, Google envía una marca de tiempo a tu servidor que define la última vez que respondiste a un mensaje de Hint Request.
- El encabezado
User-Agentse establece enGoogle-HotelAdsPrices.
Te recomendamos que establezcas la frecuencia en 5 minutos. Para establecer o modificar la frecuencia de los mensajes de solicitud de sugerencias, comunícate con nosotros.
Cuando recibes un mensaje de Hint Request de Google, respondes con todos los precios que se actualizaron desde esa marca de tiempo. Para obtener más información, consulta Mensajes de solicitud de sugerencia.
Paso 2: Mensaje de respuesta con sugerencias
Tu servidor responde a un mensaje de Hint Request con un mensaje de Hint Response. Este mensaje incluye los IDs de hoteles y los itinerarios de las propiedades cuyos precios cambiaron desde la última vez que recibiste y respondiste un mensaje de Hint Request.
El elemento raíz de un mensaje de respuesta con sugerencias es <Hint>. Para obtener más información, consulta Mensajes de respuesta de sugerencias.
Paso 3: Mensaje de consulta
Google recibe el mensaje de Hint Response y responde con un mensaje de Query, al igual que con el modo Pull estándar. La diferencia es que el mensaje de Query ahora solo contiene los IDs de hoteles y los itinerarios de las propiedades que especificaste en el mensaje de Hint Response. El elemento raíz de un mensaje de Query es <Query>.
Cuando determina para qué IDs de hotel solicitar precios con Precios modificados, Google ignora el contenido de tu feed de lista de hoteles. Esto reduce en gran medida el tamaño del mensaje Query que recibes de Google y el tamaño del mensaje Transaction de tu respuesta.
Paso 4: Mensaje de transacción
Envías un mensaje de transacción con una actualización de precios como respuesta a los mensajes de consulta de Google. El elemento raíz de un mensaje de Transaction es <Transaction>. Para obtener más información, consulta el modo de entrega por extracción.