El modo de entrega determina cómo envías las actualizaciones de precios a Google para las combinaciones de hoteles y de itinerarios. Tú y tu administrador técnico de cuentas (TAM) trabajan juntos durante la configuración inicial para configurar el modo de publicación.
Descripción general de los modos de entrega
De forma predeterminada, se puede consultar un hotel con hasta 330 días de anticipación para conocer la disponibilidad de habitaciones 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, cuanto más itinerarios admitas, más datos deberás enviar a Google para que tus datos de precios sean precisos.
Los métodos típicos para actualizar los precios usan mensajes de transacción de una de las siguientes maneras:
ARI (Push): Es un feed de publicación de precios que utiliza planes de tarifas, disponibilidad y metadatos del hotel para establecer estrategias de precios predefinidas para tus propiedades. A diferencia de los feeds de precios modificados y de solicitud de precios a terceros, 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 de 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 Cómo usar ARI.Extracción: Google consulta tu servicio con frecuencia 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 los 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 están desactualizados, según el historial de cambios de precios anterior específico del socio. Para obtener más información, consulta Cómo usar el modo de entrega de extracción.
Precios modificados (anteriormente, “solicitud de precios a terceros con sugerencias”): Es similar a la solicitud de precios a terceros, 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 se actualizan 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 el inventario.
Para obtener más información sobre cómo proporcionar actualizaciones de precios, incluidos ejemplos de mensajes de transacción, consulta Cómo actualizar 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 plazo especificado, tu anuncio debería aparecer en la subasta.
Google almacena la respuesta a una consulta 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 consulta de precios en tiempo real en el futuro.
Para obtener más información, consulta Consultas de precios en vivo.
Contexto
Por lo general, las consultas de precios modificados y de extracción 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 mostrar los precios correspondientes a un conjunto completo de contextos de usuario posibles, se está probando una función en la que se especifican los contextos de usuario populares como parte de la consulta. Los contextos de 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 de usuario para propiedades o itinerarios muy populares, pero la cantidad promedio de contextos de usuario debe ser inferior a 10. Puedes mostrar precios adicionales o ignorar contextos de usuario especificados. Depende de ti decidir qué precios mostrar para una búsqueda determinada. Sin embargo, ignorar un contexto de usuario sugerido podría generar menos tráfico.
Modo de entrega de ARI Push
Con el modo de publicación push de ARI, envías actualizaciones incrementales a Google cada vez que cambian las tarifas nocturnas, la disponibilidad, los recuentos de inventario y otras restricciones. 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 a Google.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta del modo de entrega push de ARI:
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 de ARI Push admite varios tipos de mensajes y estrategias de precios. Para obtener información detallada sobre el envío de mensajes, consulta Cómo usar ARI.
Google debe publicar tus precios y los usuarios deben poder verlos en un plazo de 15 a 20 minutos después de recibir un mensaje.
Paso 2: Confirma que Google almacene correctamente los datos en caché
Para cada mensaje de ARI Push que se 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 publicación.
Agrega 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 Room y Package con ARI Push
Usa el tipo de mensaje Transaction (Property Data) 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 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 publicación debido a que el archivo XML tiene un formato incorrecto 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 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 Atención al cliente de Google.
Modo de entrega de extracción
Con el modo de publicación de información de extracción, Google envía periódicamente 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 disponibilidad y precios actualizados.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta de Pull:
Por lo general, después de recibir las actualizaciones de precios, Google procesa los datos de precios y disponibilidad nuevos 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 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 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 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 transacciones y Actualiza los precios.
Actualiza los metadatos de habitaciones y paquetes
Además de actualizar los datos de precios con la actualización de información, también puedes usar los mensajes de transacción 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 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 solo solicita los precios de esas propiedades.
Para configurar el extremo al que Google envía los mensajes de solicitud de sugerencias, consulta a tu administrador técnico de cuentas (TAM). Lo habrías configurado durante la configuración inicial.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta de los precios modificados:
En las siguientes secciones, se describe cada uno de los pasos de este flujo.
Paso 1: Mensaje de solicitud de sugerencias
Los mensajes de solicitud de sugerencias 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
POSTde HTTP. (Si usas HTTPS, deberás obtener el dominio firmado por 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 solicitud de sugerencia.
- El encabezado
User-Agentse establece enGoogle-HotelAdsPrices.
Te recomendamos que configures 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 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 con sugerencias
Tu servidor responde a un mensaje de solicitud de sugerencia con un mensaje de respuesta de sugerencia. 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 solicitud de sugerencia.
El elemento raíz de un mensaje de respuesta con sugerencias es <Hint>. Para obtener más información, consulta Mensajes de respuesta a sugerencias.
Paso 3: Mensaje de consulta
Google recibe el mensaje de respuesta de la 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 solo contiene los IDs 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 los IDs de hoteles para los que 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 el modo de entrega de extracción.