小程序绑定普通二维码

扫描普通二维码即可跳转到抖音小程序,兼容线下已有二维码的情况下推广小程序
支持的应用类型:小程序
能力类型:其他
支持的调用方:自研、服务商代开发
是否可用于沙盒环境:

能力介绍

线下商户可不需更换线下二维码,在完成相关配置后,即可在用户通过抖音APP扫描普通链接二维码时打开小程序,继而引导用户在小程序内完成相关操作。对于普通链接二维码,目前支持使用抖音“扫一扫”或抖音内打开图片识别二维码跳转小程序。

使用场景

一般用于线下推广场景,引导用户通过抖音APP扫描线下普通二维码后即进入小程序完成相关交易或行为;

也可将该能力与引导关注抖音号能力联合使用,进入小程序后引导关注抖音号,继而为抖音号引流。

准入条件

暂无准入条件,任一小程序均可使用。

接入流程

自研开发者可在抖音开放平台页面或接口两种方式配置二维码信息,代开发服务商仅可通过接口管理普通二维码(详见接口列表),自研开发者页面操作流程如下。

步骤

说明

添加二维码

进入小程序详情页,选择「设置」>「关联设置」>「普通二维码绑定」中添加二维码。

配置信息

配置规则:

抖音客户端扫码将按以下匹配规则控制跳转:

  1. 二维码链接的协议、域名与已配置的二维码规则一致。
  2. 二维码链接属于后台配置的二维码规则的子路径(如需支持子路径匹配,请确认后台配置的二维码规则以/结尾)。
  3. 如果二维码规则包含参数,链接?后为参数部分,参数要求前缀匹配。

需配置的信息说明:

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

自研开发者及代开发服务商可通过该接口查询普通二维码绑定列表

查看文档

该文档是否对你的开发有所帮助?
有帮助
没帮助