Перейти к содержимому
Блог

Сколько поставщиков API отелей вам нужно? Считайте маппинг

Редакция Tekravel
Написано с помощью ИИ

Поиск отелей запустили в прошлом квартале на одном поставщике, и какое-то время жалоб не было. Потом отдел продаж пересылает скриншот. Клиент планирует Стамбул, нашёл в телефоне четырёхзвёздочный отель и спрашивает, почему на вашем сайте его вообще нет. Не дороже — просто нет. Следующее сообщение адресовано уже вам: может, подключим ещё одного поставщика?

Скорее всего, да. Но вопрос сколько поставщиков API отелей вам нужно — это не вопрос покрытия с ответом в виде цифры покрытия. Каждый новый поставщик расширяет инвентарь и одновременно присылает отели, которые у вас уже есть: под другим названием, с другим кодом и немного другими координатами. Вторая интеграция — это в основном код. Всё, что после неё, — в основном дедупликация, и именно эту стоимость забывают, когда считают поставщиков.

Каждый поставщик — это два потока

Поставщик отелей отдаёт вам две совершенно разные вещи, и привычка считать их одной — корень большинства ранних ошибок.

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

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

Почему один отель приходит трижды

Подключите трёх поставщиков в одном городе и выполните поиск. Увидите примерно такое: у одного он называется Grand Plaza Hotel Taksim, у второго — Grand Plaza Taksim, у третьего — GRAND PLAZA HTL - ISTANBUL. Три внутренних кода. Три набора координат в нескольких шагах друг от друга. Три набора фото, один из них — ещё до ремонта. Для путешественника это выглядит как сломанный сайт.

Решение — слой маппинга, и поле, по которому идёт дедупликация, — не название. Это ваш собственный канонический ID объекта. Код отеля каждого поставщика ссылается на него через таблицу соответствий: поставщик, код отеля у поставщика, канонический ID. Код поставщика никогда не становится первичным ключом вашего каталога: как только появляется второй поставщик, отменить это решение становится очень дорого.

Решить, что два кода — один отель, — задача сопоставления, и чистой она бывает редко:

  • Общий внешний код маппинга, если поставщики его передают, — самый сильный сигнал. Передают не все и не для каждого объекта.
  • Координаты в небольшом радиусе плюс нормализованное название (без слова «отель», города, пунктуации и регистра) ловят большую часть остального.
  • Адрес и телефон решают пограничные случаи. Два отеля одной сети на одной улице — ровно тот случай, когда название и расстояние совпадают, а отели разные.
  • Остаток уходит в очередь ручной проверки. На догадке он в продакшн не попадает.

Номера сложнее отелей

Даже когда объект сопоставлен, номера расходятся. «Deluxe King», «Superior Room, 1 King Bed» и «Double Room - City View» могут оказаться одним номером, а могут тремя разными. Большинство команд сравнивают предложения на уровне отеля — по типу питания, условиям отмены и цене, — а не пытаются сопоставить каждое название номера между поставщиками. Это разумный выбор. Просто делайте его осознанно и показывайте путешественнику достаточно из описания поставщика, чтобы он понимал, что бронирует.

Один поставщик, несколько или агрегатор

Три пути, и честное сравнение — о том, кто несёт маппинг и риск ценового паритета, а не о заявленном покрытии.

 ПокрытиеРиск ценового паритетаОбъём интеграцииКто занимается маппингом
Один поставщик напрямуюСильное там, где силён поставщик, слабое в остальномВысокий: если его цена мимо, второго предложения нетОдна интеграция, оба потокаНикто; один код на отель
Несколько поставщиков напрямуюСамое широкое из того, что вы контролируетеНиже: выбираете лучшее предложение на каждое проживаниеПо одной на поставщика, плюс слой маппинга и его поддержкаВы, постоянно
АгрегаторШирокое, его определяют источники агрегатораСмешанный: вы видите ту цену, которую он решил передатьОдна интеграцияАгрегатор, а вы решаете, что делать с проскочившим

Со средней строкой можно спорить, и многие команды спорят: владеть маппингом — значит владеть качеством своей выдачи, и кто-то никогда это не отдаст. Суть в том, что это решение о людях не меньше, чем о технике. Таблица соответствий — не проект с датой окончания.

Как определить число

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

Каждое добавление должно закрывать пробел, который можно записать списком. Если списка нет, новый поставщик будет в основном присылать дубли отелей, которые вы уже продаёте. Мы отдельно писали о том, как оценивать travel API по критериям, а не по буклетам; эта рамка применима к каждому кандидату.

Не интегрировать всё самому

Есть четвёртый путь: один раз интегрироваться с платформой, у которой подключения поставщиков уже есть. На этой платформе контент поставщиков распределяется через группы поставщиков, а не через договоры один на один, и тенант видит тех поставщиков, которых ему открывают его группы. Для разработчика это переносит вопрос «какие поставщики стоят за моим поиском отелей» из кода в конфигурацию: вы пишете под один API отелей, а набор поставщиков становится коммерческой договорённостью, а не новым спринтом интеграции.

Вопросов из этой статьи это не снимает. Спросите, как решается маппинг для поставщиков, которых вам откроют, и проверьте его в городах, которые вы продаёте, а не в демо-городе. Доступ к API авиабилетов и отелей начинается с разговора, а не с self-service ключа, — самый подходящий момент задать именно этот вопрос.

Во что обходится недоинтеграция

Отсутствующий отель на скриншоте — это не одно потерянное бронирование. Это клиент, который теперь сначала смотрит в телефон, а потом пишет вам, а ещё через пару раз — вместо того чтобы писать вам. Агентство не ошиблось в сервисе. Его поиск просто не знал, что такой отель существует.

Переинтеграция обходится иначе: три строки одного отеля в выдаче, три политики отмены, которые придётся объяснять клиенту, три договора и три набора учётных данных для ротации. Ни одна из этих проблем не видна в числе поставщиков. Обе видны в том, что путешественник видит на странице результатов.

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

Редакция Tekravel

Отдел travel-технологий

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