抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 解决方案场景化拆分公告
  • 餐饮行业
  • 酒旅行业
  • 航司saas对接解决方案
  • 酒店行业解决方案
  • 可定检查分析洞察流程
  • 酒店新预售券解决方案
  • 酒店日历房解决方案
  • 景区行业解决方案
  • 度假旅行社行业解决方案
  • 综合行业
  • 历史版本文档(不推荐)
  • 可定检查(相关文档)成功与否,影响C端交互体验(用户下单失败)的同时,也影响着商家成交量与GMV,所以,无论从商家、用户、平台角度,都要对可定检查成功率有足够的重视。所以,平台侧开发了可定检查工具,给开发者使用,用来定位具体问题,提升可定检查率。
    注:本文展示数据都为假数据,仅为展示教学使用

    整体说明

    可订检查调用失败是影响酒店日历房/预售券下单失败的主要原因,为了让开发者能了解自己的可订检查情况与问题原因,所以,开发了定位平台,具体地址如下:
    服务商地址:质量中心-数据监控
    自研商家地址:质量中心-数据监控
    然后点击控制台:
    选择要查看的应用:
    注意,一定是酒店相关的,否则看不到,然后点击质量中心下面的数据监控:
    进入后,会看到如下页面:
    接下来点击业务指标中的可定检查核心指标,看到如下页面:
    想要定位分析失败问题,需要点第二个『可定检查失败问题洞察』页面

    详细使用说明

    筛选部分

    解决方案:有日历房与预售券两种,根据开发者接入情况而定
    商家:这个只有服务商,也就是partner平台才有,自研商家无此选项,根据筛选,会只展示选中商家相关的数据
    时间范围:需要想关注的可定时间范围,注:由于数据是n+1的,所以无当天数据

    可定检查核心指标分析详解

    这里主要是展示整体的情况,

    可定整体趋势

    第一个模块就是时间范围内整体的情况与走势,可以看到不同的日期的可订检查成功情况

    可定请求量

    这里可以看到,不同的日期,整体请求情况

    可定异常量

    可定异常错误明细

    此处展示了,主要的错误分类情况,以及具体的走势

    可定检查失败问题洞察

    此处主要是用来帮助开发者定位问题,找到问题发生的具体原因

    可定检查分错误码失败调用数占比

    此处展示总量的同时,会展示出每种错误比例,让开发者重点关注到核心重点问题。

    可定检查分商家失败调用数占比

    此处让开发者关注,是个别商家问题,还是每个商家问题,重点需要关注哪些商家

    可定检查分商品失败调用数占比

    此处是展示出了,出问题的商品分布,可以让开发者直观看出,是不是由于某个商品导致的问题,针对商品问题去解决

    可定检查异常明细

    如果通过上面的信息,还定位不了问题,那就需要通过明细数据来具体定位,查看问题情况了,这里就要重点说一下异常明细部分
    这里可以根据想要定位的错误码,进行筛选,以及具体的商家、商品、poi,来查看需要直接关注的问题的明细
    列表中有以下字段:
    错误码名
    错误码
    poi_id
    商家_id
    商品_id
    rec_request_time_ms(请求时间)
    check_in_date(入住日期)
    check_out_date(离开日期)
    订的房间数
    金额
    log_id
    操作
    调用第三方超时
    500021
    1234
    1234
    2344
    2025-10-21 12:39:34
    2025-10-21
    2025-10-23
    1
    100.00
    20251021234556667
    查看价量态同步明细
    此处是这个可订检查请求时的具体数据明细,但由于价量态,很多问题都是由于价量态导致的,而价量态是否一致,并不是本次请求来决定的,所以,后面特意加了一个操作,查看这个请求最近的价量态拉取或者、推送的情况,来帮助开发者明确,是最近的哪次推送或者拉取不准确,导致的价量态不一致,具体如下:
    涉及字段如下:
    操作类型
    time_ms(时间)
    poi_id
    商家_id
    商品_id
    拉取/推送开始日期
    拉取/推送完成日期
    价格
    库存
    log_id
    拉取价格、库存、状态
    推送价格、库存、状态
    500021
    1234
    1234
    2344
    2025-10-21
    2025-10-23
    1
    100.00
    20251021234556667

    常见问题&解决方案

    价量态不一致问题

    此类问题是大量开发者的共性问题,非常大的比率,是由于价量态问题不一致,导致的可定检查的失败。解决这个问题的有效办法是接入拉取接口,很多开发者都觉得已经第一时间推送了,没有必要接拉取了,但其实并不是的,主要以下几个方面:
      推送链路可能会出问题,如果有拉取,可以避免推送问题导致的异常
      拉取是由C端访问的时候触发的,比推送更加及时
    很多开发者接完,上升特别明显,有的甚至达到了100%
    相关文档:价量态拉取接口

    调用超时

    接口超时是除价量态以外最常见的问题,字节侧调用超时时间是3s,超过3s就会自动断开连接,认为本次调用失败,如果这类问题比较高,就需要优化这个接口的性能,减少调用时长,来保证成功率。

    其它问题

    有很多是比较个性化的问题,但也可以参考,比如:
      https证书失效
      测试数据导致失败
      营销规则配置错误
      超值券没有判断等
    很多问题,没有办法一一枚举,希望开发者也能加上可订报警,及时关注,一起及时解决相关问题,来避免由于可订检查,导致用户下单失败,给商家带来损失。