Режим доставки определяет, как вы отправляете обновления цен в Google для комбинаций отелей и маршрутов. Вы и ваш технический менеджер по работе с клиентами (TAM) работаете вместе на этапе первоначальной настройки, чтобы настроить режим доставки.
Обзор способов доставки
По умолчанию запрос о наличии номеров в отеле можно сделать не позднее, чем за 330 дней до заезда, и на срок до 30 ночей проживания, но вы можете определить максимальное количество маршрутов (комбинацию даты заезда и продолжительности пребывания).
Чем больше маршрутов вы поддерживаете, тем в большем количестве аукционов вы будете участвовать. Однако чем больше маршрутов вы поддерживаете, тем больше данных вам необходимо отправлять в Google, чтобы ваши данные о ценах оставались точными.
Типичные методы обновления цен используют транзакционные сообщения одним из следующих способов:
ARI (Push) : лента доставки цен, которая использует тарифные планы, доступность и метаданные отелей для установки предопределенных стратегий ценообразования для ваших объектов. В отличие от Pull и Changed Pricing, ленты ARI не запрашивают конкретные цены или маршруты. Вместо этого вы отправляете push-сообщения, содержащие подмножество информации, представляющей модель ценообразования для ваших объектов на основе различных данных о тарифах, ограничений и доступности. Ленты ARI используют спецификацию OTA XML (
OTA_HotelRateAmountNotifRQиOTA_HotelAvailNotifRQ) для определения доступности и цен. Обратитесь к своему менеджеру по работе с клиентами, чтобы узнать больше о режиме доставки ARI и определить, подходит ли этот тип ленты для вашей учетной записи. Подробнее см. в разделе Использование ARI .Pull : Google регулярно запрашивает информацию о ценах и наличии товаров в вашем сервисе, чтобы обновить кэш данных о ценах и наличии товаров. В этой модели Google отправляет запрос на ваш сервер, а ваш сервер отвечает обновлёнными данными. Эта модель лучше всего подходит, если вы не знаете точно, когда меняется информация о ценах, или если она меняется нерегулярно в течение дня. Цены сохраняются в кэше до тех пор, пока алгоритмы Google не определят, что цены устарели, основываясь на истории изменений цен у конкретного партнёра. Подробнее см. в разделе «Использование режима Pull Delivery» .
Изменение цен (ранее «Pull with Hints»): аналогично «Pull», за исключением того, что Google запрашивает данные только по подмножеству объектов, а не по всем. Этот режим может значительно сократить сетевой трафик при обновлении цен и доступности ваших объектов. Цены сохраняются в кэше неограниченное время до обновления. Подробнее см. в разделе «Использование изменения цен» .
Помимо обновления цен, вы можете использовать сообщения о транзакциях для удаления объектов недвижимости из вашего инвентаря. Подробнее см. в разделе «Удаление инвентаря» .
Дополнительную информацию об обновлении цен, включая примеры сообщений о транзакциях, см. в разделе Обновление цен .
Запросы цен в режиме реального времени
Google также может запрашивать обновления цен во время аукциона с помощью запросов на обновление цен в режиме реального времени. Запросы на обновление цен в режиме реального времени — это запросы Google на обновление цен для текущего аукциона. Если вы ответите в течение указанного срока, ваше объявление будет показано на аукционе.
Google хранит ответ на запрос цены в режиме реального времени так же, как и на любое другое сообщение о транзакции. Благодаря этому Google может предоставить цену из своего кэша, а не отправлять новый запрос цены в режиме реального времени в будущем.
Более подробную информацию можно найти в разделе «Запросы цен в режиме реального времени» .
Контекст
Запросы Pull и Changed Pricing обычно не содержат информации о пользователе, поскольку Google использует ваши ответы для заполнения кэша, который может использоваться для обслуживания множества разных пользователей.
Поскольку возврат цен, соответствующих полному набору возможных пользовательских контекстов, может быть затратным для вас, мы тестируем функцию, в которой популярные пользовательские контексты указываются как часть запроса. Пользовательские контексты основаны на пользовательских запросах, в которых у вас была возможность показать цену, и рассчитываются таким образом, чтобы охватить подавляющее большинство пользовательских запросов. Вы можете увидеть большое количество пользовательских контекстов для очень популярных объектов размещения или маршрутов, но среднее количество пользовательских контекстов должно быть меньше 10. Вы можете возвращать дополнительные цены или игнорировать указанные пользовательские контексты — вы сами решаете, какие цены возвращать для данного запроса. Однако игнорирование предлагаемого пользовательского контекста может привести к снижению трафика.
Режим доставки ARI Push
Используя режим доставки ARI Push, вы отправляете в Google инкрементные обновления при изменении ночных цен, доступности, количества товаров на складе или других ограничений. В отличие от Pull или Changed Pricing, ARI Push позволяет использовать другую модель ценообразования для эффективного обновления различных компонентов ценовой информации в Google.
На следующей диаграмме показан поток запросов и ответов для режима доставки ARI Push:
Шаг 1: Отправка push-сообщений ARI в Google
Чтобы обновить данные с помощью 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
В режиме доставки по запросу Google периодически отправляет на ваш сервер запросы на обновление цен. Ваш сервер отвечает на эти запросы сообщениями о транзакциях , содержащими обновлённые данные о ценах и наличии товара.
На следующей диаграмме показан поток запросов/ответов Pull:
После получения обновлений цен Google обычно обрабатывает новые данные о ценах и наличии в течение примерно 5 минут.
В следующих разделах каждый из этих шагов описывается более подробно.
Шаг 1: Запрос сообщения
По умолчанию Google отправляет запросы для всех объектов, указанных в вашем списке отелей . Это может означать, что вы будете получать несколько запросов во время процесса переоценки.
Сообщения о запросах цен, которые Google отправляет на ваш сервер, имеют следующие характеристики:
- Корневым элементом является
<Query>. - Отправлено на конечную точку, указанную при первоначальной настройке. Для получения дополнительной информации обратитесь к своему техническому менеджеру по работе с клиентами (TAM).
- Использует метод HTTP
POST. (Если вы используете HTTPS, вам необходимо получить подпись домена в официальном центре сертификации.) - Заголовок
Content-Typeимеет значениеapplication/xml. - Каждое сообщение включает до 100 объектов недвижимости, для которых Google запрашивает данные о ценах и наличии.
- Заголовок
User-Agentустановлен наGoogle-HotelAdsPrices.
Шаг 2: Сообщение о транзакции
Когда ваш сервер получает сообщение «Запрос», он должен ответить сообщением «Транзакция», содержащим информацию о ценах для запрошенных маршрутов.
Корневым элементом сообщения о транзакции является <Transaction> . Подробнее см. в разделах Сообщения о транзакциях и Обновление цен .
Обновление метаданных комнат и пакетов
Помимо обновления данных о ценах с помощью функции Pull, вы также можете использовать сообщения транзакций для обновления метаданных номеров и пакетов. Подробнее см. в разделе Определение метаданных номеров и пакетов .
Изменённый способ доставки цен
Функция «Изменение цен» помогает сократить размер и количество запросов и сообщений о транзакциях, связанных с обновлением цен. Используя функцию «Изменение цен», вы отправляете Google список объектов недвижимости с изменившимися ценами. Google отвечает запросом, в котором запрашиваются только цены для этих объектов.
Чтобы настроить конечную точку, на которую Google отправляет сообщения с запросами подсказок, обратитесь к своему техническому менеджеру по работе с клиентами (TAM). Вы могли бы настроить её во время первоначальной настройки .
На следующей диаграмме показан поток запросов и ответов для измененных цен:
В следующих разделах описывается каждый из этапов этого процесса.
Шаг 1: Сообщение с запросом подсказки
Сообщения с запросами подсказок, которые Google отправляет на ваш сервер, имеют следующие характеристики:
- Корневой элемент —
<HintRequest>. - Отправлено на конечную точку, указанную при первоначальной настройке . Для получения дополнительной информации обратитесь к своему техническому менеджеру по работе с клиентами (TAM).
- Используйте метод HTTP
POST. (Если вы используете HTTPS, вам потребуется подписать домен в официальном центре сертификации.) - Заголовок
Content-Typeимеет значениеapplication/xml. - С заданной частотой Google отправляет на ваш сервер временную метку, которая определяет время последнего ответа на сообщение с запросом подсказки.
- Заголовок
User-Agentустановлен наGoogle-HotelAdsPrices.
Рекомендуем установить частоту 5 минут. Чтобы настроить или изменить частоту отправки сообщений с запросом подсказки, свяжитесь с нами .
Когда вы получаете сообщение с запросом подсказки от Google, вы отвечаете всеми ценами, обновленными с момента указанной временной метки. Подробнее см. в разделе «Сообщения с запросом подсказки» .
Шаг 2: Подсказка в ответном сообщении
Ваш сервер отвечает на запрос подсказки сообщением «Ответ на подсказку». Это сообщение содержит идентификаторы отелей и маршруты для объектов, цены на которые изменились с момента вашего последнего получения запроса подсказки и ответа на него.
Корневым элементом сообщения-ответа с подсказкой является <Hint> . Подробнее см. в разделе Сообщения -ответы с подсказкой .
Шаг 3: Запрос сообщения
Google получает сообщение Hint Response и отвечает сообщением Query, как и в стандартном режиме Pull. Разница заключается в том, что сообщение Query теперь содержит только идентификаторы отелей и маршруты для объектов, указанных в сообщении Hint Response. Корневым элементом сообщения Query является <Query> .
При определении идентификаторов отелей, для которых следует запрашивать цены с функцией «Изменённые цены», Google игнорирует содержимое вашего фида «Список отелей». Это значительно сокращает размер сообщения «Запрос», получаемого от Google, и размер сообщения «Транзакция» в вашем ответе.
Шаг 4: Сообщение о транзакции
Вы отправляете сообщение о транзакции с обновлением цен в ответ на запросы Google. Корневым элементом сообщения о транзакции является <Transaction> . Подробнее см. в разделе «Режим доставки по запросу» .