Способы доставки

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

Обзор способов доставки

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

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

Типичные методы обновления цен используют сообщения о транзакциях одним из следующих способов:

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

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

• Измененные цены (ранее — Pull с подсказками): аналогично запросу, за исключением того, что Google запрашивает данные только для подмножества свойств, а не для всех свойств. Этот режим может значительно сократить объем сетевого трафика при обновлении цен и доступности ваших объектов. Цены остаются в кеше на неопределенный срок до обновления. Дополнительную информацию см. в разделе «Использование измененных цен» .

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

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

Живые ценовые запросы

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

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

Дополнительную информацию см. в разделе Запросы цен в реальном времени .

Контекст

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

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

Совет. Если вы заинтересованы в получении контекста популярных пользователей в запросах, отправляемых Google, обратитесь к своему техническому менеджеру по работе с клиентами (TAM) (TAM). Они подтвердят, что вы готовы получать такие сообщения, а затем внесут изменения в конфигурацию, чтобы начать отправлять вам контексты пользователей в запросах.

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

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

На следующей схеме показан поток запросов и ответов для режима доставки ARI Push:

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

Чтобы обновить данные с помощью ARI Push, отправляйте сообщение с запросом ARI при каждом изменении данных. Режим доставки ARI 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 .

Режим доставки по запросу

В режиме доставки по запросу 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). Вы должны были установить это во время первоначальной настройки .

Ключевой момент: если вы не реализуете сообщения-подсказки-ответы, сообщения-запросы Google запрашивают данные для all объектов, указанных в вашем списке отелей.

На следующей диаграмме показан поток запросов и ответов для измененных цен:

В следующих разделах описываются все этапы этого процесса.

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

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

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

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

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

Шаг 2: Ответное сообщение с подсказкой

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

Корневым элементом сообщения Hint Response является <Hint> . Дополнительную информацию см. в разделе Ответные сообщения с подсказками .

Шаг 3. Запрос сообщения

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

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

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

Вы отправляете сообщение о транзакции с обновленной ценой в ответ на сообщения-запросы Google. Корневым элементом сообщения транзакции является <Transaction> . Дополнительную информацию см. в разделе Режим доставки по запросу .