El modo de entrega determina la forma 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, se puede consultar un hotel 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 (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 los datos de precios.
Los métodos típicos de actualización de precios usan los mensajes de 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 realizan consultas por itinerarios ni precios 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 entrega de ARI y determinar si este tipo de feed será más adecuado para tu cuenta. Para obtener más información, consulta Usa 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 la mejor opción si no sabes con exactitud cuándo cambia la información de precios o si la información de precios cambia de forma irregular durante el día. Los precios permanecen en la caché hasta que los algoritmos de Google determinen que se volvieron inactivos, según el historial de cambios de precios anterior específico de los socios. Para obtener más información, consulta Usa el modo de entrega de extracción.
Precios modificados (anteriormente, “Extracción 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 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 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 Actualiza los 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 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, ve a la página de 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.
Dado que puede ser costoso mostrar los precios que corresponden a un conjunto completo de contextos de usuarios posibles, se está probando una función en la que se especifican contextos de 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 cubrir la gran mayoría de las solicitudes. Es posible que veas una gran cantidad de contextos de usuarios para itinerarios o propiedades muy populares, pero la cantidad promedio de contextos de usuarios debe ser inferior a 10. Puedes mostrar precios adicionales o ignorar contextos del usuario especificados; tú decides 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 push de ARI
Con el modo de entrega push de ARI, envías actualizaciones incrementales a Google cada vez que cambian las tarifas, la disponibilidad, los recuentos de inventario o cualquier otra restricciones. 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 el envío de ARI, envía un mensaje de solicitud de 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 Usa ARI.
Google debe publicar los precios y ser visibles para los usuarios en un plazo de 15 a 20 minutos después de que se haya recibido un mensaje.
Paso 2: Confirma que Google haya almacenado correctamente los datos en caché
Por cada mensaje push de ARI que se recibe, Google responde con el estado de la conexión
HTTP y los resultados del procesamiento de ARI. Google responde con una HTTP 200 OK si la conexión al servidor se realiza de forma correcta. También incluye un cuerpo con un mensaje de respuesta que indica si las actualizaciones se aplicaron correctamente o si recibió advertencias o errores del modo de entrega.
Agregar direcciones IP a 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 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 de 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, debes enviar un mensaje XML con la nueva información en los elementos <RoomData> y <PackageData>. Esos 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 errores de formato 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 enviar la solicitud en intervalos de 1, 5 y 20 minutos. Si el problema persiste después de 3 intentos, deja de enviar mensajes y comunícate con la 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 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 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 sobre los precios de 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 Actualización de precios.
Actualiza los metadatos de Room y Package
Además de actualizar los datos de precios con la solicitud de extracción, también puedes usar los mensajes de transacción para actualizar los metadatos de las habitaciones y los paquetes. Para obtener más información, consulta Define metadatos de habitaciones y paquetes.
Modo de entrega de Precios modificados
Los precios modificados ayudan a reducir el tamaño y la cantidad de los mensajes de Consulta y Transacciones para las actualizaciones de precios. Cuando usas Precios modificados, envías a Google una lista de las 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 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 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 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 sugerencia.
Paso 2: Mensaje de respuesta de sugerencia
Tu servidor responde a un mensaje de solicitud de sugerencia con un mensaje de respuesta de sugerencias. 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 IDs de hoteles y los itinerarios de 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 los 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 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.