联合授权获取用户标识能力

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

能力介绍

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

使用场景

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

准入条件

适用范围

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

接入流程

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

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

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

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

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

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

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

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

    Webhook:新增联合授权获取用户信息 Webhook 事件,当开发者订阅该事件并启用后,服务端基于用户在 C 端场景满足指定条件后自动推送 Webhook 事件。
    OpenAPI:
    C 侧应用:新增用户维度鉴权 API,支持 C 侧应用开发者入参用户在当前应用下的 openid + 目标 B 侧应用 clientkey,出参为该用户在目标 clientkey 下的 open_id
    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 侧应用的开发者超管账号必须不同。