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

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