抖音开放平台Logo
开发者文档
控制台
  • 能力概览
  • 抖音开放能力SDK
  • 抖音授权
  • 授权SDK介绍
  • 授权自定义备注能力
  • 联合授权获取用户标识
  • 抖音投稿
  • 抖音分享
  • 抖音名片SDK
  • 互动管理
  • 数据开放服务
  • 抖音 SDK 能力
  • 生活服务开放能力
  • 联合授权获取用户标识

    收藏
    我的收藏
    平台支持不同开发者账号下应用产生经营关系并需要识别同一用户的场景,提供用户 OpenAPI 映射查询能力。

    能力介绍

    越来越多开发者入驻开平后,包含头部KA、服务商等类型开发者在用户营销、私域方面产生了诸多实践,通过调研我们发现开发者和商家侧存在多端经营但无法跨应用互通用户信息的共性需求未被满足,具体表现为:
    经营者同时使用小程序和移动网站应用提供服务,通常使用小程序作为给抖音C端用户提供服务的载体,使用第三方移动/网站应用作为经营者自己使用的服务管理后台。
    但由于同一抖音用户在不同开发者账号下的应用中的 OpenAPI 不同,且目前平台没有提供映射查询能力,因此开发者无法识别到第三方服务管理后台和小程序中的同一用户,服务能力受到阻断。
    为了更好地满足以上场景的需求,平台支持不同开发者账号下应用产生经营关系并需要识别同一用户的场景,在开发者建立应用绑定关系以及用户授权确认后,平台提供用户 OpenAPI 映射查询能力。

    使用场景

    用户访问“懂车帝”小程序并授权主动私信能力,接收获取一手报价。小程序关联的汽车中介可在提供私信管理能力的第三方移动网站应用中,向该用户发送私信消息主动触达。

    准入条件

    适用范围

    该能力支持小程序、移动应用、网站应用进行申请使用。
    小程序申请能力的准入条件如下:
      1.小程序已上线。
      2.信用分不低于 60 分。
    移动应用、网站应用无额外要求。

    接入流程

    目前联合授权获取用户标识能力处于内测阶段,开发者可进入「控制台-能力-能力实验室」进行申请,申请通过后,即可在「设置」-「关联设置」中看到「联合授权管理」能力入口。
    目前仅支持C侧应用主动向B侧应用发起联合授权申请,B侧应用仅支持接收并处理联合授权申请。
    C侧应用定义:抖音用户直接使用的应用,应用类型支持小程序、移动应用、网站应用。
    B侧应用定义:抖音用户不会直接使用的应用,一般为经营者使用的经营管理后台,和C侧应用有实际业务关联,应用类型支持移动应用、网站应用。

    第一步:C侧应用发起联合授权申请

      在控制台申请
      a.小程序或移动网站应用开发者登录抖音开放平台,在右上角单击控制台。
      b.选择【设置】-【关联设置】-【联合授权管理】。
    小程序-控制台申请联合授权绑定
    移动网站应用-控制台申请联合授权绑定
      c.点击页面上的【发起联合授权】。
      d.选择联合授权能力输入应用ID并点击识别,勾选“已阅读并同意协议《联合授权应用使用协议》”。
      e.点击确定即可发起联合授权。

    第二步:B侧应用接收并处理联合授权申请

      在控制台接收并处理
      a.移动网站应用开发者登录抖音开放平台,在右上角单击控制台。
      b.选择【设置】-【关联设置】-【联合授权管理】中查看待处理的联合授权。
      c.选择“同意”后即可建立联合授权绑定关系。

    第三步:用户进行联合授权确认

    客户端:27.9.0及以上版本支持。
      用户在使用C侧应用时,同意联合授权弹窗。
      a.小程序的联合授权弹窗复用手机号和头像昵称授权弹窗。
      b.移动网站应用的授权弹窗复用登录授权。

    第四步:开发者通过Webhook或OpenAPI查询用户openid映射关系

      Webhook
      a.新增联合授权获取用户信息webhook事件,当开发者订阅该事件并启用后,服务端基于用户在C端场景满足指定条件后自动推送webhook事件。
      OpenAPI
      a.C侧应用:新增用户维度鉴权api,支持C侧应用开发者入参用户在当前应用下的openid+目标B侧应用clientkey,出参为该用户在目标clientkey下的open_id。
      b.B侧应用:新增应用维度鉴权api,开发者入参关联的C侧应用clientkey/appid+用户在C侧应用下的openid,对应出参同一用户在当前B侧应用clientkey下的openid。

    接口列表

    名称
    类型
    描述
    OpenAPI
    通过用户在C侧应用(小程序)下的openid获取在联合授权绑定的B侧应用下的openid
    OpenAPI
    通过用户在C侧应用(移动网站应用)下的openid获取在联合授权绑定的B侧应用下的openid
    OpenAPI
    通过用户在C侧应用(小程序或移动网站应用)下的openid获取在联合授权绑定的B侧应用下的openid

    常见问题

    Q1:联合授权获取用户标识能力是什么?
    联合授权获取用户标识能力是指平台支持不同开发者账号下应用需要识别同一用户的场景,在开发者建立应用绑定关系以及用户授权确认后,平台提供用户openid映射查询能力。
    Q2:联合授权获取用户标识能力如何接入?
    目前联合授权获取用户标识能力处于内测阶段,开发者可进入「控制台-能力-能力实验室」进行申请,申请通过后,即可在「设置」-「关联设置」中看到「联合授权管理」能力入口。
    Q3:联合授权获取用户标识能力的发起与接受规则?
      目前仅支持C侧应用主动向B侧应用发起联合授权申请,B侧应用仅支持接收并处理联合授权申请
    Q4:C侧应用和B侧应用的定义是什么?
    C侧应用定义:抖音用户直接使用的应用,应用类型支持小程序、移动应用、网站应用
    B侧应用定义:抖音用户不会直接使用的应用,一般为经营者使用的经营管理后台,和C侧应用有实际业务关联且跨应用识别用户为该等应用提供服务做必须,应用类型支持移动应用、网站应用
    Q5:联合授权绑定数量与应用类型限制?
      对于联合授权获取用户标识能力,一个C侧应用只能绑定一个B侧应用
      对于联合授权获取用户标识能力,一个B侧应用可以绑定多个C侧应用
      C侧应用和B侧应用必须为不同的应用类型
      C侧应用和B侧应用的开发者超管账号必须不同