Обзор ARI

ARI (доступность, цены и ассортимент) – это режим передачи цен, который позволяет управлять ценами за ночь, доступностью и ассортиментом, а также задавать ограничения на их сочетания. Кроме того, в ARI можно указывать налоги, сборы и промоакции.

В отличие от режимов передачи цен на основе маршрутов (запрос и измененные цены), фиды ARI не запрашиваются для определенных цен или маршрутов. Вместо этого вы отправляете сообщения, когда в вашей модели ценообразования появляются новые или измененные данные, например изменения в сведениях о тарифах, ограничениях и доступности.

Преимущества

ARI предлагает следующие преимущества:

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

  • Точность цен. Повышается за счет использования модели push-on-change, которая позволяет обновлять цены в реальном времени.

  • Более широкий охват цен. Вы сможете охватить больше цен (количество маршрутов с ценами), используя подробные данные, которые объединяются в различные маршруты.

  • Гибкость. Вы можете предлагать пользователям различные промоакции и пакеты.

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

Типы сообщений с запросом

Сообщения ARI, отправляемые в Google, называются сообщениями-запросами ARI. Затем Google возвращает сообщения с ответом, указывающие на успех или неудачу.

Для некоторых основных типов сообщений, определяющих доступность и инвентарь, ARI использует стандартные протоколы OpenTravel Alliance (OTA).

В ARI используются следующие сообщения запросов:

  • Transaction (Данные ресурса). Определяет тип номера и информацию о пакете (тарифном плане).

  • OTA_HotelRateAmountNotifRQ. Определяет стоимость проживания в зависимости от даты или продолжительности пребывания для каждого продукта (комбинации типа номера и тарифного плана) в определенные диапазоны дат.

  • OTA_HotelAvailNotifRQ. Определяет доступность и ограничения на основе типа номера и тарифных планов. С помощью этого сообщения также можно обновлять инвентарь, но лучше использовать OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ. Определяет физический инвентарь номеров или количество номеров, доступных для продажи.

  • TaxFeeInfo. Необязательный атрибут, который позволяет указать налоги и сборы для каждого объекта. Это сообщение не требуется, если в сообщении OTA_HotelRateAmountNotifRQ указано AmountAfterTax.

  • Promotions. Необязательный элемент. Позволяет задавать специальные цены для определенных бронирований, проживаний и пользователей.

  • RateModifications. (Необязательно.) Определяет правила изменения цен для определенных бронирований, проживаний и пользователей.

  • ExtraGuestCharges. (Необязательно.) Определяет, как должны быть настроены тарифы для детей и дополнительных взрослых.

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

Дополнительную информацию об ARI можно найти в справочнике по XML.

Push-сообщения

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

При отправке сообщений следуйте приведенным ниже рекомендациям.

  • Чтобы добавить или обновить IP-адреса в нашей системе, воспользуйтесь инструментом самообслуживания на странице Настройки цен в Hotel Center.

  • Используйте следующий базовый путь для конечной точки:

    • https://www.google.com или Host: www.google.com Port: 443
  • Отправьте сообщения с помощью метода HTTP POST.

  • Задайте для заголовка Content-Type значение application/xml.

  • Максимальная частота обновления на уровне аккаунта составляет 400 сообщений в секунду. Если вы превысите это ограничение, будет возвращен код ошибки 6032.

  • В зависимости от того, какие данные вы хотите обновить, выберите один из следующих путей:

    • Transaction (данные ресурса): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif.
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif.
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif.
    • TaxFeeInfo: /travel/hotels/uploads/taxes.
    • Promotions: /travel/hotels/uploads/promotions.
    • RateModifications: /travel/hotels/uploads/rate_modifications.
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

На каждое полученное сообщение с запросом Google будет отвечать кодом HTTP 200 OK, если подключение к серверу было установлено. В теле ответа будет содержаться сообщение о том, были ли обновления применены успешно или возникли предупреждения или ошибки. Если Google возвращает код ошибки HTTP, отправьте сообщение повторно. Если в теле HTTP-ответа есть предупреждения или ошибки, их необходимо устранить, прежде чем повторно отправлять сообщение. Вы также можете посмотреть проблемы, возникшие с определенными сообщениями, на странице "Статус фида" в Hotel Center.

Показ в Google

Программа "Показ в Google" позволяет показывать ваши гостиницы на сайтах Google. Поскольку значение LoG по умолчанию для гостиницы – true, все новые гостиницы будут автоматически показываться в Google.

С помощью LoG вы можете включать и отключать показ объявлений и бесплатных ссылок для бронирования в аккаунте Hotel Center независимо от статуса Google Рекламы и наличия цен на Google.

Задать ценность LoG для гостиницы можно двумя способами: с помощью Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Подробную информацию о списке целей можно найти в Справочном центре Hotel Center.

Использование Travel Partner API, you can do the following:

  • Посмотреть статус объектов можно в Hotel Center или с помощью конечной точки hotelViews.list.

  • Получите список всех своих гостиниц, которые показываются в Google, используя параметр filter со значением liveOnGoogle = TRUE в конечной точке hotelViews.list.

  • Получить сводку по ресурсам для определенного аккаунта, включая количество ресурсов, опубликованных в Google, с помощью hotelViews.summary.

Дополнительную информацию о том, как задать ограничение на показ рекламы с помощью API, можно найти в hotelViews.list статье и документации по API.