Режимы передачи цен

Режим передачи определяет, как вы отправляете в Google обновления цен для комбинаций гостиниц и маршрутов. Вы и ваш технический менеджер аккаунта (TAM) вместе работаете над первоначальной конфигурацией, чтобы настроить режим доставки.

Обзор режимов доставки

По умолчанию в запросе можно указать дату заезда в течение 330 дней и длительность пребывания до 30 ночей. Однако вы можете задать максимальное количество маршрутов (комбинаций даты заезда и длительности пребывания).

Чем больше маршрутов вы поддерживаете, тем в большем количестве аукционов вы будете участвовать. Однако чем больше маршрутов вы поддерживаете, тем больше данных вам нужно отправлять в Google, чтобы поддерживать точность данных о ценах.

Обычно цены обновляются с помощью сообщений-транзакций (Transaction) одним из следующих способов:

  • ARI (Push). Фид цен, в котором используются тарифные планы, данные о наличии мест и метаданные гостиниц, чтобы задать предопределенные стратегии ценообразования для ваших объектов. В отличие от извлекаемых и измененных цен, фиды ARI не запрашивают конкретные цены или маршруты. Вместо этого вы отправляете сообщения, содержащие подмножество информации, которая представляет модель ценообразования для ваших объектов на основе различных сведений о тарифах, ограничениях и доступности. Фиды ARI используют спецификацию OTA XML (OTA_HotelRateAmountNotifRQ и OTA_HotelAvailNotifRQ) для определения наличия и цен. Чтобы узнать больше о режиме передачи ARI и определить, подходит ли этот тип фида для вашего аккаунта, обратитесь к менеджеру аккаунта. Подробнее об использовании ARI…

  • Запрос. Google регулярно запрашивает у вашего сервиса данные о ценах и наличии мест, чтобы обновить кеш. В этой модели Google отправляет запрос на ваш сервер, а сервер отвечает обновленными данными. Эта модель лучше всего подходит, если вы не знаете точно, когда меняется информация о ценах, или если она меняется нерегулярно в течение дня. Цены хранятся в кеше до тех пор, пока алгоритмы Google не определят, что они устарели. Это делается на основе истории изменения цен у конкретного партнера. Подробнее о режиме доставки по запросу…

  • Измененные цены (ранее – "Запрос с подсказками"). Этот способ похож на предыдущий, но Google запрашивает данные только для некоторых объектов, а не для всех. Этот режим позволяет значительно снизить объем сетевого трафика при обновлении цен и данных о наличии мест. Цены хранятся в кеше до тех пор, пока не будут обновлены. Подробнее об использовании измененных цен…

Помимо обновления цен, сообщения-транзакции можно использовать для удаления объектов из инвентаря. Подробнее об удалении инвентаря…

Подробную информацию о том, как обновлять цены, и примеры сообщений-транзакций вы найдете в статье Обновление цен.

Запросы цен в режиме реального времени

Google также может запрашивать обновление цен во время аукциона с помощью запросов цен в режиме реального времени. Запросы цен в режиме реального времени – это запросы цен от Google для текущего аукциона. Если вы ответите в течение указанного периода времени, ваше объявление должно появиться на аукционе.

Google сохраняет ответ на запрос цен в режиме реального времени так же, как и любое другое сообщение-транзакцию. В результате Google сможет показывать цену из кеша, а не отправлять запрос цен в режиме реального времени.

Подробнее о запросах цен в режиме реального времени…

Контекст

Запросы с измененными ценами и запросы на получение данных обычно не содержат информацию о пользователе, поскольку Google использует ваши ответы для заполнения кеша, который может использоваться для показа рекламы разным пользователям.

Поскольку возвращать цены для всех возможных контекстов пользователя может быть слишком дорого, мы тестируем функцию, которая позволяет указывать в запросе популярные контексты. Контексты пользователей основаны на запросах, при которых у вас была возможность показать цену, и рассчитаны так, чтобы охватить подавляющее большинство запросов пользователей. Для очень популярных объектов или маршрутов может быть много пользовательских контекстов, но в среднем их должно быть меньше 10. Вы можете возвращать дополнительные цены или игнорировать указанные пользовательские контексты – вы сами решаете, какие цены возвращать для данного запроса. Однако если вы проигнорируете предложенный контекст, трафик может снизиться.

Режим push-доставки ARI

В режиме ARI Push вы отправляете в Google дополнительные обновления, когда меняются цены за ночь, доступность, количество номеров или другие ограничения. В отличие от извлекаемых и измененных цен, ARI Push позволяет использовать другую модель ценообразования, чтобы эффективно обновлять различные компоненты информации о ценах в Google.

На схеме ниже показан поток запросов и ответов для режима ARI Push.

fig1

Шаг 1. Отправьте в Google push-сообщения ARI

Чтобы обновить данные с помощью ARI Push, отправляйте запрос ARI каждый раз, когда меняются данные. Режим передачи ARI Push поддерживает различные типы сообщений и стратегии ценообразования. Подробную информацию о push-сообщениях можно найти в статье Использование ARI.

Ваши цены должны показываться пользователям в Google в течение 15–20 минут после получения сообщения.

Шаг 2. Убедитесь, что данные успешно кешируются Google

В ответ на каждое сообщение ARI Push Google отправляет статус HTTP-подключения и результаты обработки ARI. Если подключение к серверу установлено, Google возвращает код HTTP 200 OK. В теле ответа содержится сообщение о том, были ли изменения применены успешно или возникли предупреждения или ошибки, связанные с режимом доставки.

Белый список IP-адресов

Чтобы добавить в белый список IP-адреса, которые вы используете для отправки сообщений ARI в Google, перейдите на страницу Настройки цен ARI в Hotel Center. Подробнее о том, как изменить настройки цен в Hotel Center…

Как обновить метаданные номеров и пакетов с помощью ARI Push

Используйте сообщение о транзакции (данные об объекте размещения), чтобы указать доступные типы номеров и тарифные планы (пакеты) для каждого объекта. Обновления следует отправлять каждый раз, когда добавляются, удаляются или изменяются типы номеров или тарифные планы. В этом случае вы отправляете XML-сообщение с новой информацией в элементах <RoomData> и <PackageData>. Эти элементы являются дочерними по отношению к элементу <PropertyDataSet>.

Ошибки подключения или контента

Если вы получили сообщение об ошибке режима доставки из-за неправильного формата XML, ознакомьтесь с рекомендациями в статье Сообщения об ошибках в статусе фида.

Если при отправке ARI-сообщения в Google вы получаете сообщение об ошибке HTTP-подключения, повторите запрос через 1, 5 и 20 минут. Если проблема не исчезнет после трех попыток, прекратите отправку сообщений и обратитесь в службу поддержки Google.

Режим доставки Pull

При использовании модели Pull Google периодически отправляет на ваш сервер сообщения-запросы, чтобы получить актуальные цены. Ваш сервер отвечает на эти сообщения сообщениями-транзакциями, которые содержат обновленные данные о ценах и наличии.

На следующей схеме показан поток запросов и ответов при использовании модели Pull:

fig2

После получения обновленных цен Google обычно обрабатывает новые данные о ценах и наличии в течение примерно 5 минут.

Ниже каждый из этих шагов описан подробнее.

Шаг 1. Сообщение-запрос

По умолчанию Google отправляет сообщения-запросы для всех объектов, указанных в списке гостиниц. Это означает, что во время перерасчета цен вы можете получить несколько сообщений-запросов.

Сообщения-запросы о ценах, которые Google отправляет на ваш сервер, имеют следующие характеристики:

  • Корневой элемент – <Query>.
  • Отправляется на конечную точку, заданную при первоначальной настройке. За дополнительной информацией обратитесь к техническому менеджеру аккаунта.
  • Использует метод HTTP POST. Если вы используете HTTPS, вам нужно получить подпись домена от официального центра сертификации.
  • Заголовок Content-Type имеет значение application/xml.
  • Каждое сообщение содержит до 100 объектов, для которых Google запрашивает данные о ценах и наличии мест.
  • Заголовок User-Agent имеет значение Google-HotelAdsPrices.

Шаг 2. Сообщение-транзакция

Получив сообщение-запрос, ваш сервер должен отправить в ответ сообщение-транзакцию с информацией о ценах для запрашиваемых маршрутов.

Корневой элемент сообщения-транзакции – <Transaction>. Подробную информацию вы найдете в статьях Сообщения-транзакции и Обновление цен.

Как обновить метаданные номеров и пакетов

Помимо обновления данных о ценах с помощью запросов, вы также можете использовать сообщения-транзакции для обновления метаданных о номерах и пакетах. Подробную информацию вы найдете в статье Как задать метаданные номеров и пакетов.

Режим передачи данных "Измененные цены"

Измененные цены позволяют уменьшить размер и количество сообщений-запросов и сообщений-транзакций, необходимых для обновления цен. При использовании режима измененных цен вы отправляете в Google список объектов, для которых изменились цены. Google отправляет сообщение-запрос, в котором запрашивает цены только для этих гостиниц.

Чтобы настроить конечную точку, в которую Google отправляет Hint Request messages, обратитесь к техническому менеджеру аккаунта. Вы должны были настроить его во время первоначальной настройки.

На схеме ниже показан поток запросов и ответов для измененных цен.

fig3

Ниже описан каждый шаг этого процесса.

Шаг 1. Hint Request message

Сообщения Hint Request, которые Google отправляет на ваш сервер, имеют следующие характеристики:

  • Корневой элемент – <HintRequest>.
  • Отправляется на конечную точку, заданную во время первоначальной настройки. За дополнительной информацией обратитесь к техническому менеджеру аккаунта.
  • Используйте метод HTTP POST. Если вы используете HTTPS, вам нужно будет получить подпись домена от официального центра сертификации.
  • Заголовок Content-Type имеет значение application/xml.
  • Google с определенной периодичностью отправляет на ваш сервер временную метку, которая указывает, когда вы в последний раз отвечали на Hint Request message.
  • Заголовок User-Agent имеет значение Google-HotelAdsPrices.

Рекомендуем установить частоту 5 минут. Чтобы задать или изменить частоту отправки запросов, свяжитесь с нами.

Когда вы получаете от Google сообщение Hint Request, вы отправляете в ответ все цены, которые были обновлены после указанной временной метки. Подробнее о Hint Request messages…

Шаг 2. Сообщение Hint Response

Ваш сервер отвечает на сообщение Hint Request сообщением Hint Response. В этом сообщении содержатся идентификаторы гостиниц и маршруты для объектов, цены на которые изменились с момента последнего получения и ответа на сообщение Hint Request.

Корневой элемент сообщения Hint Response – <Hint>. Дополнительную информацию можно найти в статье Сообщения Hint Response.

Шаг 3. Сообщение-запрос

Google получает сообщение Hint Response и отправляет в ответ сообщение-запрос, как и в стандартном режиме запросов. Разница в том, что теперь сообщение-запрос содержит только идентификаторы гостиниц и маршруты для объектов, указанных в сообщении Hint Response. Корневой элемент сообщения-запроса – <Query>.

При определении того, для каких идентификаторов отелей запрашивать цены с помощью измененных цен, Google игнорирует содержимое фида со списком отелей. Это значительно уменьшает размер сообщения-запроса, которое вы получаете от Google, и размер сообщения-транзакции в вашем ответе.

Шаг 4. Сообщение-транзакция

В ответ на сообщение-запрос от Google вы отправляете сообщение-транзакцию с обновленными ценами. Корневой элемент сообщения-транзакции – <Transaction>. Подробнее о режиме доставки Pull…