El modo de entrega determina la manera en que envías las actualizaciones de precios a Google para las combinaciones de itinerarios y hoteles. Tú y tu administrador técnico de cuentas (TAM) trabajan juntos durante la configuración inicial para establecer el modo de entrega.
Descripción general de los modos de entrega
De forma predeterminada, un hotel se puede buscar hasta 330 días antes de la disponibilidad de la habitación y hasta 30 noches de estadía, pero puedes determinar la cantidad máxima de itinerarios (combinación de la fecha de entrada y la duración de la estadía).
Cuantos más itinerarios admitas, 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 precios usan mensajes Transaction de una de las siguientes maneras:
ARI (push): Un feed de entrega de precios que usa planes de tarifas, disponibilidad y metadatos de hoteles para establecer estrategias de precios predefinidas para tus propiedades. A diferencia de la solicitud de precios a terceros y los precios modificados, los feeds de ARI no consultan precios ni itinerarios específicos. En su lugar, envías mensajes que contienen un subconjunto de información que representa un modelo de precios para tus propiedades según varios detalles de tarifas, restricciones y disponibilidad. Los feeds de ARI usan la especificación XML 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 publicación de ARI y determinar si este tipo de feed sería el más adecuado para tu cuenta. Para obtener más información, consulta Usa ARI.De 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 mejor si no sabes exactamente cuándo cambia la información de precios o si esta información cambia de manera irregular durante el día. Los precios permanecen en la caché hasta que los algoritmos de Google determinan que los precios están inactivos, según el historial de cambios de precios anterior específico del socio. Para obtener más información, consulta Usa el modo de entrega de extracción.
Precios modificados (anteriormente, Solicitud de precios a terceros con sugerencias): Es similar a la extracción, excepto que Google solo solicita datos para un subconjunto de propiedades, no para todas las propiedades. Este modo puede reducir significativamente la cantidad de tráfico de red cuando se actualizan los precios y la disponibilidad de tus propiedades. Los precios permanecerán en la caché de forma indefinida hasta que se actualicen. Para obtener más información, consulta Usa precios modificados.
Además de actualizar los precios, puedes usar mensajes de transacción para quitar propiedades de tu inventario. Para obtener más información, consulta Quita inventario.
Si quieres obtener más información para proporcionar actualizaciones de precios, incluidos ejemplos de mensajes de transacción, consulta Actualiza los precios.
Consultas de precios en tiempo real
Google también puede solicitar algunas actualizaciones de precios durante 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 período especificado, tu anuncio debería aparecer en la subasta.
Google almacena la respuesta a una consulta de precios en tiempo real del mismo modo que lo hace con cualquier otro mensaje de transacción. Como resultado, Google puede entregar el precio desde su caché en lugar de enviar otra consulta de precios en tiempo real en el futuro.
Para obtener más información, revisa Consultas de precios en tiempo real.
Contexto
Por lo general, las consultas de solicitud de precios a terceros y precios modificados no especifican información sobre el usuario, ya que Google usa tus respuestas para completar una caché que podría usarse con el objetivo de entregar a distintos usuarios.
Dado que puede ser costoso mostrar precios correspondientes a un conjunto completo de contextos del usuario posibles, se está probando una función en la que se especifican contextos de usuarios populares como parte de la consulta. 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 usuarios. Es posible que veas una gran cantidad de contextos de usuario para propiedades o itinerarios muy populares, pero la cantidad promedio de contextos de usuario debería ser inferior a 10. Puedes mostrar precios adicionales o ignorar los contextos de usuario especificados. Depende de ti decidir qué precios mostrar en una búsqueda determinada. Sin embargo, ignorar un contexto de usuario sugerido podría reducir el tráfico.
Modo de entrega de envío de ARI
Con el modo de entrega de envío de ARI, puedes enviar actualizaciones incrementales a Google cada vez que cambien las tarifas nocturnas, la disponibilidad, los recuentos de inventario o cualquier otra restricción. A diferencia de la solicitud de precios a terceros o los precios modificados, ARI Push te permite usar un modelo de precios diferente para actualizar de manera eficiente varios componentes de la información de precios a Google.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta para el modo de entrega de envío de ARI:
Paso 1: Envía mensajes de envío 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 de envío de 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 entregar los precios, y los usuarios deben verlos en un plazo de 15 a 20 minutos después de que se recibe un mensaje.
Paso 2: Confirma que Google haya almacenado correctamente en caché los datos
Por cada mensaje push de ARI que recibe, Google responde con el estado de la conexión HTTP y los resultados de 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 de forma correcta o si se encontraron advertencias o errores del modo de entrega.
Direcciones IP en 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 salas de reuniones y paquetes con ARI Push
Usa el tipo de mensaje Transacción (datos de propiedad) para definir los tipos de habitaciones y los planes de tarifas (paquetes) activos de cada propiedad.
Debes enviar actualizaciones cada vez que se agreguen, quiten o modifiquen tipos de habitaciones o planes de tarifas. En este caso, envías un mensaje en formato 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 XML tiene un formato incorrecto o es incorrecto, busca la solució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 realizar 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 Atención al cliente de Google.
Modo de entrega de extracción
Con el modo de entrega de extracción, Google envía de forma periódica mensajes de consulta a tu servidor para solicitar actualizaciones de precios. Tu servidor responde a esos mensajes con mensajes de transacción que contienen datos de precios y disponibilidad actualizados.
En el siguiente diagrama, se muestra el flujo de solicitud/respuesta de Extracción:
Después de recibir las actualizaciones de precios, Google suele procesar los nuevos datos de precios y disponibilidad en unos 5 minutos.
En las siguientes secciones, se describe cada uno de estos pasos con más detalle.
Paso 1: Consulta el mensaje
De forma predeterminada, Google envía mensajes de consulta para todas las propiedades definidas en tu Lista de hoteles. Esto podría significar que deberías recibir varios mensajes de consulta durante los procesos de revisión de precios.
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 el dominio firmado por una autoridad certificadora oficial). - El encabezado
Content-Typese estableció enapplication/xml. - Cada mensaje incluye hasta 100 propiedades para las que Google solicita datos de precios y disponibilidad.
- El encabezado
User-Agentse estableció enGoogle-HotelAdsPrices.
Paso 2: Mensaje de transacción
Cuando el servidor recibe un mensaje de consulta, debe responder con un mensaje de transacción que contenga información de precios para los itinerarios solicitados.
El elemento raíz de un mensaje de transacción es <Transaction>. Para obtener más información, consulta Mensajes de transacción y Cómo actualizar precios.
Actualiza los metadatos de habitaciones y paquetes
Además de actualizar los datos de precios con la solicitud de precios a terceros, también puedes usar mensajes de transacción para actualizar los metadatos de las habitaciones y paquetes. Para obtener más información, consulta Define metadatos de habitaciones y paquetes.
Modo de entrega de Precios modificados
El cambio de precios ayuda a reducir el tamaño y la cantidad de los mensajes de consulta y transacción para las actualizaciones de precios. Cuando usas los precios modificados, envías a Google una lista de las propiedades que tienen precios actualizados. Google responde con un mensaje de consulta que pregunta solo los precios de esas propiedades.
Para configurar el extremo al que Google envía los mensajes de solicitud de sugerencia, consulta a tu administrador técnico de cuentas (TAM). Deberías haber hecho esto durante la configuración inicial.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta a 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 el dominio firmado por una autoridad certificadora oficial). - El encabezado
Content-Typese estableció enapplication/xml. - Con una frecuencia específica, Google envía una marca de tiempo a tu servidor que define la última vez que respondiste a un mensaje de solicitud de sugerencia.
- El encabezado
User-Agentse estableció enGoogle-HotelAdsPrices.
Te recomendamos que establezcas una frecuencia en 5 minutos. Si quieres configurar o modificar la frecuencia de los mensajes de solicitud de sugerencias, comunícate con nosotros.
Cuando recibes un mensaje de solicitud de sugerencia 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 sugerencias.
Paso 2: Mensaje de respuesta de pista
El servidor responde a un mensaje de solicitud de sugerencia con un mensaje de respuesta de sugerencia. En este mensaje, se incluyen los itinerarios y los ID de hoteles de las propiedades cuyos precios cambiaron desde la última vez que recibiste y respondiste un mensaje de solicitud de sugerencia.
El elemento raíz de un mensaje de respuesta de sugerencia es <Hint>. Para obtener más información, consulta Mensajes de respuesta de sugerencias.
Paso 3: Consulta el mensaje
Google recibe el mensaje de respuesta de sugerencia y responde con un mensaje de consulta, al igual que con el modo de extracción estándar. La diferencia es que el mensaje de consulta ahora contiene solo los ID de hoteles y los itinerarios de las propiedades que especificaste en el mensaje de respuesta de sugerencia. El elemento raíz de un mensaje de consulta es <Query>.
Cuando determina para qué IDs de hoteles se deben 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 de consulta que recibes de Google y el tamaño del mensaje de transacción 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 transacción es <Transaction>. Para obtener más información, consulta Modo de entrega de extracción.