El modo de entrega determina cómo 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 consultar hasta 330 días antes de la disponibilidad de las habitaciones y hasta 30 noches de estadía, pero puedes determinar la cantidad máxima de itinerarios (una 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 tus datos de precios.
Los métodos típicos para actualizar precios usan mensajes de Transaction de una de las siguientes maneras:
ARI (push): Es un feed de entrega de precios que usa planes de tarifas, la disponibilidad y los 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 buscan itinerarios ni precios específicos. En su lugar, envía mensajes que contienen un subconjunto de información que representa un modelo de precios para tus propiedades en función de varios detalles de tarifas, restricciones y disponibilidad. Los feeds de ARI usan la especificación XML inalámbrica (
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 más adecuado para tu cuenta. Para obtener más información, consulta Cómo usar 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, que responde con datos actualizados. Este modelo es la mejor opción si no sabes exactamente cuándo cambia la información de precios o si esta cambia de forma irregular durante el día. Los precios permanecen en la caché hasta que los algoritmos de Google determinen que los precios se volvieron obsoletos, 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, “Pull 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 Cómo quitar inventario.
Si quieres obtener más información para proporcionar actualizaciones de precios, incluidos ejemplos de mensajes de transacción, consulta la página sobre cómo actualizar 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 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, dirígete a 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 a fin de llenar una caché que podría usarse para entregar contenido a una variedad de usuarios diferentes.
Debido a que podría resultar costoso mostrar precios correspondientes a un conjunto completo de contextos de usuarios posibles, se está probando una función donde se especifican los contextos de los usuarios populares como parte de la consulta. Los contextos de los usuarios 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. 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 los 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 un tráfico más bajo.
Modo de entrega de envío de ARI
Con el modo de entrega de envío de ARI, envías actualizaciones incrementales a Google cada vez que cambian las tarifas, la disponibilidad, los recuentos de inventario o cualquier otra restricciones por la noche. 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 en 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 push de ARI a Google
Para actualizar tus datos con ARI Push, envía un mensaje de solicitud ARI cada vez que cambien los 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 Cómo usar ARI.
Google debería publicar los precios y ser visibles para los usuarios en un plazo de 15 a 20 minutos después de que se reciba un mensaje.
Paso 2: Confirma que Google haya almacenado correctamente los datos en caché
Para cada mensaje de envío de ARI recibido, 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.
Incluir direcciones IP en la lista de entidades permitidas
Si quieres 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 paquete con ARI Push
Usa el tipo de mensaje de transacción (datos de propiedad) para definir los tipos de habitaciones y los planes de tarifas activos (paquetes) de cada propiedad.
Debes enviar actualizaciones cada vez que se agreguen, quiten o modifiquen tipos de habitaciones o planes de tarifas. En este caso, debes enviar 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 archivo XML tiene errores de formato o es incorrecto, busca la resolución recomendada en Mensajes de error del 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 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 actualizados de precios y disponibilidad.
En el siguiente diagrama, se muestra el flujo de solicitud/respuesta de la extracción:
Después de recibir las actualizaciones de precios, Google suele procesar los datos nuevos de precios y disponibilidad en un plazo aproximado de 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 el proceso de revisión de precios.
Los mensajes de consulta de precios que envía Google 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 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 Actualiza precios.
Actualiza los metadatos de los paquetes y las habitaciones
Además de actualizar los datos de precios con la solicitud de extracción, también puedes usar mensajes de transacción para actualizar los metadatos de tu habitación y paquete. Para obtener más información, consulta Cómo definir metadatos de habitaciones y paquetes.
Modo de entrega de Precios modificados
La función de precios modificados ayuda a reducir el tamaño y la cantidad de los mensajes de consulta y transacción para las actualizaciones de precios. Cuando usas Precios modificados, le envías a Google una lista de propiedades que tienen precios actualizados. Google responde con un mensaje de consulta que solicita solo 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). Habías hecho esto durante la configuración inicial.
En el siguiente diagrama, se muestra el flujo de solicitud y respuesta de 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 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 HTTP
POST. (Si utilizas 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 configurar o modificar la frecuencia de los mensajes de solicitudes de sugerencias, comunícate con nosotros.
Cuando recibes un mensaje de solicitud de pista 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 sugerencia
Tu servidor responde a un mensaje de solicitud de sugerencia con un mensaje de respuesta a una sugerencia. Este mensaje incluye los itinerarios y los IDs de los 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: Mensaje de consulta
Google recibe el mensaje de respuesta de sugerencias 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 itinerarios y los ID de los hoteles para las propiedades que especificaste en el mensaje de respuesta de sugerencias. El elemento raíz de un mensaje de consulta es <Query>.
Cuando determina para qué IDs de hoteles se solicita solicitar precios con precios modificados, Google ignora el contenido de tu feed de lista de hoteles. Esto reduce mucho 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 precio 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.