能力介绍
线下商户可不需更换线下二维码,在完成相关配置后,即可在用户通过抖音APP扫描普通链接二维码时打开小程序,继而引导用户在小程序内完成相关操作。对于普通链接二维码,目前支持使用抖音“扫一扫”或抖音内打开图片识别二维码跳转小程序。
使用场景
一般用于线下推广场景,引导用户通过抖音APP扫描线下普通二维码后即进入小程序完成相关交易或行为;
也可将该能力与引导关注抖音号能力联合使用,进入小程序后引导关注抖音号,继而为抖音号引流。
准入条件
暂无准入条件,任一小程序均可使用。
接入流程
自研开发者可在抖音开放平台页面或接口两种方式配置二维码信息,代开发服务商仅可通过接口管理普通二维码(详见接口列表),自研开发者页面操作流程如下。
步骤 | 说明 |
添加二维码 | 进入小程序详情页,选择「设置」>「关联设置」>「普通二维码绑定」中添加二维码。 |
配置信息 | 配置规则: 抖音客户端扫码将按以下匹配规则控制跳转: - 二维码链接的协议、域名与已配置的二维码规则一致。
- 二维码链接属于后台配置的二维码规则的子路径(如需支持子路径匹配,请确认后台配置的二维码规则以/结尾)。
- 如果二维码规则包含参数,链接?后为参数部分,参数要求前缀匹配。
需配置的信息说明: 1. 二维码链接: 2. 校验文件: - 下载随机校验文件,并将文件上传至服务器指定位置的目录下,方可通过所属权校验;
- 验证文件放置规则: 放置于 URL 中声明的最后一级子目录下,若无子目录,则放置于 host 所属服务器的顶层目录下。请根据页面提示将验证文件放置在指定的目录下。
3. 小程序功能页面:扫描后进入的小程序落地页,如:pages/index/index。 4. 前缀占用规则: - 开发者可选择是否占用符合二维码匹配规则的所有子规则。如选择占用,则其他帐号不可申请使用满足该前缀匹配规则的其他子规则;
- 如:若开发者 A 配置二维码规则:https://open.dy.com/mp?id=123,并选择「占用所有子规则」,其他开发者将不可以配置满足前缀匹配的子规则如https://open.dy.com/mp?id=1234。
5. 测试范围:选择测试范围:建议先测试再调整成全网生效。测试版:配置只对开发者生效;线上版:配置对线上用户生效。 |
测试后全网生效 | - 测试仅对指定的测试链接和测试范围内的抖音用户生效,其他用户扫码后依然跳转到原页面,不影响全网用户正常使用;
- 测试无误后,可选择发布二维码,发布后开发者仍然可以选择在指定版本(测试版/线上版本)下测试,请注意扫码用户要打开开发版必须提交过代码。
|
接口列表
API名称 | API类型 | API描述 | 接口文档 |
新增绑定二维码 | OpenAPI | 自研开发者及代开发服务商可通过该接口新增绑定二维码,绑定后可扫该二维码打开关联小程序 | 查看文档 |
更新绑定的二维码链接 | OpenAPI | 自研开发者及代开发服务商可通过该接口更新绑定二维码链接 | 查看文档 |
更新绑定的二维码状态 | OpenAPI | 自研开发者及代开发服务商可通过该接口更新绑定二维码状态,可调整为下线状态 | 查看文档 |
删除绑定的二维码链接 | OpenAPI | 自研开发者及代开发服务商可通过该接口删除绑定二维码链接 | 查看文档 |
查询普通二维码绑定列表 | OpenAPI | 自研开发者及代开发服务商可通过该接口查询普通二维码绑定列表 | 查看文档 |