到底需要几家酒店API供应商?先算清酒店映射

酒店搜索上个季度上线,只接了一家供应商,一段时间里没人抱怨。后来销售转来一张截图:一位客户在规划伊斯坦布尔行程,用手机找到一家四星酒店,问为什么你们网站上根本搜不到。不是价格贵,而是压根没有。下一条消息是发给你的:要不要再接一家供应商?
多半要接。但需要几家酒店API供应商,并不是一个用覆盖率数字就能回答的覆盖率问题。每多接一家,库存变大了,同时它也会把你已经有的酒店再送一遍——换个名字、换个ID、坐标也略有不同。第二次对接主要是写代码;之后的工作主要是去重。数供应商的人,恰恰漏算了这部分成本。
每家供应商都是两条数据流
酒店供应商给你的是两样截然不同的东西,把它们当成一样东西处理,是大多数早期错误的根源。
第一样是静态内容:酒店名称、地址、坐标、星级、图片、房型描述、设施。它变化很慢,批量拉取、本地存储,按以天为单位的周期刷新。第二样是实时价格:这些日期、这个入住人数下有什么房、什么价、什么取消政策。它在搜索和预订之间就可能变化,缓存最多几分钟,而且无论搜索结果怎么说,到prebook时都要重新校验。
两种缓存周期,两种出错方式。静态内容过期,展示的是错误的图片;价格过期,卖出的是供应商不会认的价格。每接一家供应商,两条流都要接,而真正的工作量藏在静态内容里,因为它必须和你手上已有的一切逐一核对。
为什么同一家酒店会出现三次
在同一个城市接入三家供应商,然后搜索一次,你会看到类似这样的结果:一家叫Grand Plaza Hotel Taksim,另一家叫Grand Plaza Taksim,第三家叫GRAND PLAZA HTL - ISTANBUL。三个内部代码,三组相隔几步路的坐标,三套图片,其中一套还是翻修之前拍的。在旅客眼里,这就是一个坏掉的网站。
解决办法是一层映射(mapping),而去重依据的字段不是酒店名称,而是你自己的标准酒店ID。每家供应商的酒店代码,通过一张映射表指向它:供应商、供应商酒店代码、标准ID。供应商代码永远不要做你目录的主键——一旦接入第二家,这个决定改起来代价极高。
判断两个代码是否是同一家酒店,是一个匹配问题,而且很少干净利落:
- 如果供应商带有共同的外部映射代码,这是最强的信号。但不是每家都带,也不是每家酒店都有。
- 小半径内的坐标,加上规范化后的名称(去掉“酒店”、城市名、标点和大小写),能抓住剩下的大部分。
- 地址和电话用来判定难分的情况。同一连锁品牌在同一条街上的两家店,恰恰是名称和距离都对得上、酒店却不同的情形。
- 剩下的进入人工审核队列,绝不凭猜测上线。
房型比酒店更难
酒店映射好了,房型依然对不上。“Deluxe King”“Superior Room, 1 King Bed”和“Double Room - City View”,可能是同一种房,也可能是三种。多数团队是在酒店层面比较房价报价——按餐食类型、取消条款和价格——而不是试图在供应商之间映射每一个房型名称。这个选择站得住脚,前提是你有意为之,并且给旅客看足够多的供应商原始房型描述,让他知道自己订的是什么。
一家供应商、多家,还是聚合商
三条路。诚实的比较看的是谁来承担映射和价格一致性(rate parity)风险,而不是宣传里的覆盖范围。
| 覆盖 | 价格一致性风险 | 对接工作量 | 谁负责映射 | |
|---|---|---|---|---|
| 直连一家供应商 | 它强的地方强,其他地方薄弱 | 高:它的价格失准时,你没有第二个报价 | 一次对接,两条流 | 不需要;每家酒店一个代码 |
| 直连多家供应商 | 你能掌控的最大覆盖 | 较低:每次入住可以挑更好的报价 | 每家一次对接,外加映射层及其维护 | 你自己,长期负责 |
| 聚合商 | 较广,取决于聚合商的来源 | 不确定:你看到的是它选择传给你的价格 | 一次对接 | 聚合商负责,漏网的由你判断 |
你可以不同意中间那一行,很多团队也确实不同意:拥有映射,就是拥有自己搜索结果的质量,有些团队绝不会交给别人。关键在于,这既是技术决策,也是人员编制决策。映射表不是一个有截止日期的项目。
怎么定数量
数市场,不数供应商。先从一家在你主力市场实力强的供应商开始。把返回为空或结果稀少的搜索、销售转来的截图都记下来。等你能说出第一家缺了哪些城市、哪些酒店时,再接第二家,并在签任何合同之前确认候选供应商真的覆盖了它们。
每次新增都应该填补一个你能列出来的缺口。列不出来,新供应商送来的多半是你已经在卖的酒店的重复数据。我们另文讲过如何按维度而不是按宣传册评估旅游API,那套框架同样适用于这里的每个候选者。
不必什么都自己对接
还有第四条路:与一个已经持有供应商连接的平台对接一次。在这个平台上,供应商内容通过供应商组共享,而不是一对一签约;每个租户看到的是其所属组授予它的供应商。对开发者来说,这把“我的酒店搜索背后是哪些供应商”这个问题从代码移到了配置:你只针对一个酒店API开发,供应商组合是一项商务安排,而不是又一个对接迭代。
但它并不会让本文的问题消失。问清楚你将被授予的那些供应商,映射是怎么处理的,并在你实际销售的城市测试,而不是在演示城市。机票和酒店API的接入从一次沟通开始,而不是自助申请密钥——这正是问这个问题的时机。
接得太少的代价
截图里缺失的那家酒店,不只是丢了一单。它意味着一位客户现在会先看手机再联系你,再多几次,就直接不联系你了。旅行社的服务没有做错什么,只是它的搜索不知道这家酒店存在。
接得太多则是另一种代价:结果里同一家酒店出现三行,要向客户解释三套取消政策,要维护三份合同、轮换三套凭证。这两种失败都不会体现在供应商数量上,却都会体现在旅客看到的结果页上。
把实时价格这一侧做成能扛住慢供应商的样子——我们在酒店房态API客户端设计中讲过。然后,让你能说出名字的缺口,来决定它背后站几家供应商。