能力爆料箱 | 解开抖音小程序的能力密码

833 阅读12分钟

基础能力篇

NO.1 小程序担保支付

有交易行为的小程序需接入担保支付,支持微信、支付宝、抖音支付等多种支付方式。

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:是

能力介绍

为了保障用户的权益和体验,抖音开放平台为抖音小程序提供的支付产品为「担保模式」,即用户购买商品或服务时的款项在微信/支付宝/抖音支付等支付渠道的担保账户内,商户无法对担保账户进行任何操作;

待用户到店核销或确认收货等节点时,商户需将订单状态告知开放平台并发起结算请求,此时资金会到商户在支付渠道的可提现账户内,可随时将可提现账户的资金转到银行卡账户或支付公司余额账户内。

  1. 信息流

抖音开放平台向下接入了各支付渠道,向上为开发者和服务商提供了支付解决方案,因此开发者和服务商只需与开放平台系统产生信息交互,不直接与支付渠道交互。

  1. 资金流

正向资金流:

  • 用户支付成功:用户支付成功后,资金实际到了支付渠道的担保账户内,为了让商户有较强感知,平台通过「在途账户」展示这部分资金,「在途账户」里的资金表示用户已支付成功,商户待履约;
  • 商户履约成功:在用户支付完成后,商户进行履约,对于到店类订单,商户需要将订单信息同步给抖音开放平台。
  • 商户履约后发起结算:当商户履约后发起结算请求,抖音开放平台验证通过后扣除平台收取的技术服务费,将剩余资金转到商户的可提现账户;在该环节,商户如有分账诉求(需要分给其合作方),则可通过接口传入分账列表,平台按照指令将资金分到商户合作方的可提现账户内;
  • 商户及合作方提现:可以对可提现账户内的资金随时发起提现,提现后的资金将转入到商户绑定的银行账户或支付公司的余额账户。

逆向资金流:

  • 商户未履约退款:如商户未履约,用户支付的款项还在商户的在途账户内,此时退款则直接从商户在途账户退款,平台不收取技术服务费;

  • 商户履约且已完成结算后退款:如商户履约且已完成结算,用户支付的款项已到商户的可提现账户内,此时退款则从商户的可提现账户内退款,平台收取的技术服务费不退还。

  • 商户履约且已完成结算后退分账:如商户履约且已完成结算及分账,则用户支付的款项已到商户及合作方的可提现账户内,此时退分账则从合作方的可提现账户退到商户的可提现账户,平台收取的技术服务费不退还。

使用场景

用户在小程序内的支付链路如下:

用户交互流程说明:

  1. 进入收银台:用户在某抖音小程序内的提单页发起支付请求时,商户调用抖音开放平台预下单接口获取打开收银台的参数,然后通过 tt.pay 打开收银台;
  2. 选择支付方式并确认付款;用户在收银台上选择某支付方式并点击立即付款按键,收银台可唤起对应支付渠道 APP 并进入对应的支付页面;
  3. 支付成功后跳回抖音小程序:用户支付成功后,在支付渠道的支付成功页点击「完成」按键,tt.pay 将支付结果回调给商户,此时商户可选择进入相关页面。

NO.2 获取手机号

获取用户在抖音绑定的手机号,适用于注册登录、账户绑定、用户触达等场景

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:是

能力介绍

获取用户在抖音绑定的手机号,可用于注册登录、账号绑定、用户触达、业务办理等场景,该能力适用于小程序、移动应用、网站应用,其中小程序支持开发者自行申请及使用能力,也支持服务商代申请及使用能力;移动应用和网站应用仅支持开发者自行操作。

扫码体验在小程序内获取用户手机号,移动应用和网站应用的交互体验类似:

使用场景

可在注册登录、账号绑定、用户触达、票务预订、业务办理、信息查询等需要获取用户手机号的场景下使用,以某二手车小程序为例:该小程序主要用于查看二手车价格等信息,在用户提交购车或询价申请时可获取用户手机号。大致步骤如下:

  1. 打开小程序,选择要咨询的商品;
  2. 点击**「立即询底价」**,引导用户同意授权手机号;
  3. 在授权弹窗中点击「同意」后,授权并进入下一步;如果用户点击不同意,则获取不到用户手机号。

NO.3 订阅消息

基于抖音通知渠道,为开发者提供了可高效触达用户的订阅消息能力,以便实现服务闭环。

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:否

能力介绍

该能力分为一次性订阅消息和长期性订阅消息,适用于抖音和头条宿主。

一次性订阅消息用于解决用户使用小程序后,后续服务环节的通知问题。用户自主订阅后,开发者可不限时间地下发一条对应的服务消息;每条消息可单独订阅或退订。

一次性订阅消息可满足小程序的大部分服务场景需求,但线下公共服务领域存在一次性订阅无法满足的场景,如航班延误,需根据航班实时动态来多次发送消息提醒。为便于服务,我们提供了长期性订阅消息,用户订阅一次后,开发者可长期下发多条消息。

目前长期性订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务类小程序开放,后期将逐步支持到其他线下公共服务业务。

使用场景

该能力需要获取用户授权后才能发送消息,内容对应的消息模板需提前申请才可使用,用户点击消息直接进入小程序对应页面。

1. 用户授权页面如下

2. 用户查看消息的入口及样式如下

  • 在抖音APP的「消息tab」中查看,小程序通过“第三方服务通知”发送,抖音侧暂不支持 push。

  • 在「我的-消息私信」中查看,头条支持气泡和push通知

    • 气泡:只针对已关注小程序的授权用户生效,单日不超过 3 次;
    • push:只针对已关注小程序的授权用户生效,单日不超过 3 次。

NO.4 获取高精度定位

  • 支持的调用方:自研
  • 是否可用于沙盒环境:是

在经过用户授权后,开发者可获取用户实时精准位置,一般适用于打车、外卖等需要频繁请求获取地理位置的行业,获取地理位置的方法有如下几种:

使用场景

适用于需要获取高精度定位详细的使用场景,如打车小程序,在接客时需要频繁获取客户的所在位置,此时就可以使用该能力。

  1. 打开小程序,提示用户授权获取高精度定位;
  2. 用户点击「同意」后,授权并显示小程序首页;如果用户点击「不同意」,则需手动选择地址。

数据能力篇

NO.1 视频数据

在经过用户授权的情况下可查询视频相关数据,包括视频基本信息(标题、封面、是否置顶、创建时间等)及视频的点赞、播放、分享、评论等官方数据。

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:否

使用场景

可与发布内容至抖音能力联合使用,在发布视频时调起授权弹窗,引导用户授权;待用户发布视频后可获取视频相关信息用于展示在相关页面上或数据分析。

视频数据主要分为两类:

NO.2 用户数据

在用户授权的情况下,通过OpenApi的方式获取用户账号数据包含视频聚合信息、粉丝数、点赞数、评论数、分享数、主页访问数。

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:否

使用场景

该能力仅可在需展示抖音用户信息的场景,不可用于开发者搭建对外售卖的【数据服务类型】应用或进行平台统计分析,非预期范围内使用方式经平台发现封禁该能力。

用户首次授权应用后,需要第二天才会产生全部的数据,可获取的数据主要分为两类:

  1. 用户自身产生的数据:
  • 粉丝总数

  • 一段时间每日新增粉丝数

  • 一段时间内每日个人主页访问人数

  1. 用户发布作品产生的数据
  • 近一段时间发布作品总数
  • 近一段时间每日发布作品说
  • 近一段时间每日新增的播放数
  • 近一段时间每日新增点赞数
  • 近一段时间每日新增评论数
  • 近一段时间每日新增分享数

NO.3 抖音热门视频榜单

按照排名获取抖音端内的视频榜单数据,榜单中的视频数据包括发布人昵称、封面图、点赞、播放、评论等相关数据。

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:否

使用场景

获取的数据可用于展示在相关页面上或进行数据分析,该统计数据为离线数据,统计最近24小时,每天10点前产出最新数据。榜单中的视频数据包括:

  • 榜单排名
  • 视频发布者昵称
  • 视频封面图
  • 点赞数
  • 播放数
  • 评论数
  • 视频热词
  • 热度指数
  • 视频播放页链接
  • 视频标题

NO.4 抖音音乐榜单

获取抖音端内的音乐榜单数据,包括热歌榜、飙升榜、原创榜。每类榜单都能获取榜单对应的音乐基础信息。

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:否

使用场景

获取的数据可用于展示在相关页面上或进行数据分析,该统计数据为离线数据,统计最近24小时,每天10点前产出最新数据。每类榜单中的数据包括:

  • 榜单排名
  • 歌曲标题
  • 音乐封面
  • 时长
  • 作者昵称
  • 使用量
  • 音乐分享链接

NO.5 抖音达人榜单

获取抖音端内达人各类主题的榜单数据,主题包括搞笑、游戏、美食、体育、娱乐明星、剧情、汽车、旅游、二次元。

  • 支持的调用方:自研、服务商代开发
  • 是否可用于沙盒环境:否

使用场景

获取的数据可用于展示在相关页面上或进行数据分析,该统计数据为离线数据,统计最近24小时,每天10点前产出最新数据。每类榜单中的数据包括:

搞笑: 获取抖音端内的搞笑榜单数据,包括当前搞笑榜单及新势力榜单等数据,每类榜单都能获取榜单对应的视频基础信息。

游戏: 获取抖音端内的游戏榜单数据,包括单机主机榜及游戏咨询榜,每类榜单都能获取榜单对应的视频基础信息。

美食: 获取抖音端内的美食榜单数据,包括美食总榜、美食新势力榜、美食教程榜及美食探店榜,每类榜单都能获取榜单对应的视频基础信息。

体育: 获取抖音端内的体育榜单数据,包括体育总榜、篮球榜、足球榜、综合体育榜、运动健身榜等榜单数据。

娱乐明星: 获取抖音端内的娱乐明星榜单数据,每类榜单都能获取榜单对应的视频基础信息。

剧情: 获取抖音端内的剧情榜单数据,每类榜单都能获取榜单对应的视频基础信息。

汽车: 获取抖音端内的汽车榜单数据,包括汽车总榜、评车榜、玩车榜、用车榜、驾考榜等类型榜单数据,每类榜单都能获取榜单对应的视频基础信息。

旅游:获取抖音端内的旅游榜单数据,包括旅游总榜单及旅游新势力榜,每类榜单都能获取榜单对应的视频基础信息。

二次元: 获取抖音端内的二次元榜单数据,包括二次元总榜、轻漫榜、出境拍摄榜、绘画榜、声控榜、脑洞榜、二次元新势力榜,每类榜单都能获取榜单对应的视频基础信息。

以上就是本次抖音小程序介绍的全部内容啦~ 欢迎各位开发者前往抖音开放平台,注册小程序体验👏