文档

QQ小程序

连接年轻用户的新方式，覆盖8亿新生代活跃网民。轻便快捷的开发模式，还能在QQ内被轻松获取和传播。

亮点

  • 开放：快速进驻和多场景应用曝光，助力小程序/小游戏进入亿级流量通道。
  • 多样：打通即时通讯(QQ)与异步社交(Qzone) ，最大化地进行社交流量传播。
  • 赋能：围绕广告、支付等商业化模式提供解决方案，让开发者更专注于业务。
  • 兼容：支持多种小程序框架，兼容现有小程序语法，降低接入门槛。

接入流程

1. 阅读文档

为了更高效的进驻到QQ小程序平台，建议先阅读下列文档后再启动进驻工作：

2. 注册开发者平台

请在QQ小程序开发者平台首页 https://q.qq.com 点击右上角的「立即注册」按钮。注册流程中需要完成下列事项：

  • 填写基础信息：账号、密码、管理员QQ、主体信息（目前仅支持个人、企业的自助注册）
  • 验证激活账号：激活注册邮箱、确认管理端QQ

建议：注册后建议开发者主动提交主体认证，以便拥有更多高级接口能力使用。

3. 创建小程序

完成注册后，请在QQ小程序开发者平台首页https://q.qq.com 的登录入口直接登录，点击「完善小程序信息」以补齐下列信息：

  • 小程序名称：小程序名称唯一，建议控制在10个字符（5个汉字）以内；
  • 图标：小程序头像要求唯一；
  • 描述：建议长度28个字符（14个汉字）以内。

注: 所有QQ小程序必须遵守《QQ小程序运营规范》 ，开发者可参考相关文档了解详细审核标准。

（1）开发设置

  • 基础库最低版本：建议设置为 1.0.15/1.0.0
  • 服务器配置

（2）成员管理 路径：权限管理——成员管理 （3）选择服务类目 所选类目需与小程序本身服务相关，并按提示提供相关的资质； 每个小程序最多可以选择5个类目。 路径：设置——基本设置——服务类目

4. 编码开发小程序

为了帮助QQ小程序开发者简单和高效地进行编码工作，我们在提供集成调试、编码能力的开发工具。 下载地址：开发者工具

5. 提交发布

5.1提交审核

登录QQ小程序开发者平台首页 并进入开发管理，该页面将展示已上传的代码，管理员可提交审核或是删除代码。提交审核完成后，开发管理页中审核版本模块展示审核进度

tips: 提交代码审核前需完成小程序信息补全、主体审核

5.2 小程序发布

代码审核通过，需要开发者手动点击发布，小程序才会发布到线上提供服务，至此用户将能通过搜索、分享、推荐等场景体验到该小程序。

开放能力

高级接口

小程序需要进行相应的认证之后才能拥有更多接口能力，高级接口包括支付、广告、账号互通、社交分享等能力，后续新增接口内测也将会优先提供给已认证主体小程序。

开发能力

QQ小程序开发者平台提供了丰富的API和组件，具体的能力可以参照如下小程序示例：

支付能力

已认证主体的小程序可申请支付能力，为了降低开发者的门槛QQ小程序平台提供两套解决方案：

1. QQ钱包

QQ钱包与微信支付同属于腾讯集团旗下为用户提供互联网支付与金融服务的综合平台，QQ钱包在年轻用户中迅速普及，覆盖了QQ内手机充值、信用卡还款、理财通、微粒贷、Q币充值、证券、演出赛事票、购物、竞彩、酒店预订、城市一卡通、汽车票、生活缴费、城市服务、腾讯公益等产品消费场景，使得数亿QQ用户生活更加便利。原QQ钱包商户无需重新申请、只需修改配置，即可把支付能力拓展到QQ小程序当中。

2. 腾讯计费

腾讯计费孵化于支撑腾讯内部业务千亿级营收的互联网计费平台(米大师，具备十余年计费经验，现面向各行业伙伴全面开放虚拟支付能力，在QQ小程序、小游戏中集成QQ支付、微信支付等能力，并提供账户管理、精准营销、安全风控、稽核分账、计费分析等多维度服务。QQ小程序、小游戏开发者登录QQ小程序开发者平台后即可自助申请、开通使用。

tips: 小游戏暂未支持接入QQ钱包，若有支付需求请使用腾讯计费。 小程序支持使用QQ钱包和腾讯计费；后者在小程序场景灰度中，将会逐步提供广大开发者使用。

广告能力

腾讯社交广告资源丰富既包括微信、QQ等强势社交产品，也包括用户移动生活所必须的各类应用，贯穿用户每日24小时真实生活。

1. 流量主

依托腾讯大数据精准的人群分析能力和海量的优质广告素材，通过丰富的广告形态为广大流量主提供优质的商业化解决方案。

接入过程仅需复制广告代码，并将其嵌入小程序、小游戏代码中，就可通过Banner、激励视频等广告形态获得变现收益。数据精准透明，可按天查看广告流水，按月结算分成收入。

1.1 准入条件

2019年7月23日起，未出现严重违规的小程序、小游戏均可接入广告。 详见开发者管理端广告接入页面。

1.2 相关文档

2. 广告主

广告技术赋能商业，腾讯社交广告平台每天有超过8亿用户使用QQ、Qzone等众多腾讯产品及第三方应用。我们为您提供了众多广告定向条件，您可以从中选择适合达成您商业目标的条件锁定人群、建立联系，将优质商业信息推送给真正需要的人。

QQ互联

小程序绑定QQ互联帐号后，可通过UnionID机制打通多个App、网站、小程序。

  • 已进驻QQ互联的开发者
  1. 申请unionID能力 在QQ互联中，将同一个开发者账号下的多个应用可以申请 unionID 打通。

请注意:

1)打通后请换用 unionID 作为识别用户标识。

2)unionID 打通后，不会对 openID 造成任何影响。

3)应用开发者转移不对应用数据造成任何影响。

具体操作步骤如下： 第一步：在QQ小程序平台打开「开发设置」页面获取AppID(小程序唯一ID)和AppSecret(小程序密钥)； 第二步：登录QQ互联平台，切换到小程序Tab页后，点击「关联小程序」并输入前述获取的AppID(小程序唯一ID)和AppSecret(小程序密钥)； 第三步：绑定成功后，切换到「应用接口」页面即可自助开通unionID权限； 2 . 申请存量openID转换 对于已上线应用有存量 openID 需要转换 unionID 的，可以申请 openID+appID 转 unionID 接口，申请链接。

请注意: 此接口处理速度 2000/S，处理速度极快，支持多线程，仅限使用 2 个月处理 所有存量数据。

  1. 开发者需要先登录QQ互联注册账号；
  2. 在使用小程序的AppID、AppSecret在QQ互联-管理应用页面中添加绑定小程序；
  3. 选中需要创建的应用（App、小程序等）创建unionID。

至此即可用.getUserInfo以获取unionID。

社交分享

为满足开发者对社交传播的诉求，我们提供了分享小程序到QQ好友、QQ群聊和QQ空间的能力。

同时，为了进一步提升分享效率，平台也提供了特定场景下快速分享的能力。

  • 分享面板&最近联系人列表
  • 快速分享能力
  • 设置多种分享消息模板

1. 分享面板&最近联系人列表

在分享面板中，可以分享给QQ好友、QQ空间，同时会显示用户的最近联系人列表，方便用户快速传播。

有以下两种调用方式：

  • qq.showShareMenu
  • 小程序/小游戏内调用分享组件
1.1 qq.showShareMenu

开发者只需对API showShareMenu进行简单设置即可使用。

小程序&小游戏调用方式相同。

qq.showShareMenu

1.2 小程序/小游戏内调用分享组件

1.2.1 小程序

通过设置button组件的share属性，可以在小程序内调用上述分享面板，且开发者可以自由组合分享渠道，进一步提升分享效率。

分享面板内显示内容设置，具体见button文档。

1.2.2 小游戏

可以通过qq.shareAppMessage，调用分享面板。

案例：

小程序内调用分享组件

2. 快速分享能力

2.1 快速分享面板

在多人参与的场景中，有时用户不满足于仅分享到单个QQ会话。在当前能力下，用户操作路径较长，点击分享到QQ--选择好友--发送--返回再点击按钮。

QQ提供了一次调用、多次发送的快速分享面板，可大大降低用户操作成本，助力优秀内容的快速传播。

快速分享能力

2.1.1 小程序

button组件的 share-mode 需要设置元素值'recentContacts'（>=基础库1.10.1）

2.1.2 小游戏

qq.shareAppMessage，设置shareAppType=qqFastShareList

2.2 直接分享到原会话

当用户从某会话中打开小程序，我们预期用户有一定可能性会把小程序分享回原聊天会话。

平台提供了直接分享到原会话能力，帮助开发者减轻用户分享心理门槛。

直接分享到原会话

2.2.1 生效场景

2.2.2 小程序

button组件的 share-mode 需要设置元素值'quickToDialog'（>=基础库1.10.1）

2.2.3 小游戏

qq.shareAppMessage，设置shareAppType=qqFastShare

3. 一键发空间说说

用户可通过小程序内的按钮，快速发表说说到自己的QQ空间。（图片/文字/视频等，暂不支持纯文字）

调用方式：

小程序，调用qq.openQzonePublish接口即可。

4. 设置多种分享消息模板

在不同分享场景，分享消息内的内容&格式，都会不同。QQ提供不同分享消息模板，方便开发商在不同情况下使用。

后续会有更多模板持续上线，可在开发者管理端-分享模板中持续关注。

外部分享

1. 从外部App分享

已有App的开发者可以通过接入QQ互联SDK，让用户可以将App分享文字、图片、视频、网页、小程序等内容分享给QQ好友、QQ群聊和QQ空间，开发者仅需在QQ互联中将已有的App和小程序关联后即可实现。

互联sdk小程序分享文档：IOS、Android

TIP

在下列场景接收小程序类型分享，将按照开发者设定的分享参数转成网页类型分享：

  • Mobile QQ ≥ 8.1.0
  • PC QQ
  • macOS QQ
  • iPad
  • AndroidPad

2. 通过二维码打开

为满足开发者通过二维码扫描打开指定小程序，并且跳转到指定页面的诉求，我们提供了 url 跳转小程序的能力，开发者按照下述规则生成 url ，再生成 url 对应的二维码即可使用。

url规则：
https://m.q.qq.com/a/p/{APPID}

参数

属性 类型 默认值 必填 说明
s string 否 需要跳转到的指定页面路径，如果需要传入参数，可以拼在路径之后，此参数需要进行url encode

示例：
https://m.q.qq.com/a/p/1108291530?s=pages%2Fgame-list%2Fgame-list%3Fmode%3Dwanba

warning 注意

  1. s参数必须进行encode
  1. QQ低版本的场景会展示为默认页，不需要额外做兼容逻辑
  1. url 生效版本如下：
  • Android QQ Version ≥ 8.05
  • iOS QQ Version ≥ 8.03

3. 外部APP打开小程序

已有App的开发者可以通过接入QQ互联SDK，在相同主体前提下，通过APP打开QQ小程序。

互联SDK下载地址：Android、iOS

消息触达

基于QQ的通知渠道，我们为开发者提供了可以高效触达用户的消息能力，以便实现服务的闭环并提供更佳的体验。

为满足不同场景下的消息触达，平台提供了两种下发消息的能力，模板消息 & 订阅消息。

模板消息：无需用户感知，即可获取消息下发权限。下发权限有时限，适合需要对用户行为进行及时反馈的场景。

订阅消息：需用户主动订阅后，才可获取消息下发权限。下发权限长期有效，适合中长期运营。

模板消息

使用简介
  • 模板推送位置：小程序通知
  • 模板下发条件：用户本人在QQ体系内与小程序页面有交互行为后触发，详见下述下发条件说明
  • 模板跳转能力：点击查看详情，仅能跳转下发模板的该帐号的各个页面
  • 数据统计：可通过场景值 = 1014，计算模板消息来源用户数据
使用说明

步骤一：从开发者管理端，获取模板 ID

步骤二：页面的 form 组件，属性 report-submit 为 true 时，可以声明为需要发送模板消息，此时点击按钮提交表单可以获取 formId，用于发送模板消息。或者当用户完成 支付行为，可以获取 prepay_id 用于发送模板消息。

步骤三：调用接口下发模板消息

小程序

详见 sendTemplateMessage

小游戏

在小游戏里，由于没有类似小程序的表单组件，因此采用一套新方案来实现类似模板消息能力。

简单来说，当用户有使用QQ小游戏时，平台后台将会为当前用户在当前小程序生成一个下发消息的凭证，即formid，并通过开发者提供的回调地址，将formid返回给开发者。

同个appid下，单个用户7天内最多触发1个formid，即，同个appid 7天内，给1个用户最多下发1条消息。具体流程如下。

  1. 在开发者管理端，配置回调地址（填写的URL需要正确响应QQ发送的Token验证，填写说明请阅读 消息推送服务器配置指南）

  1. 当有用户使用QQ小游戏时，小游戏服务后台可接收1次QQ服务器通知的formid。同个appid下，单个用户7天内最多触发1个formid。

  2. 通过formid，可以调用sendTemplateMessage发送模板消息

最终效果

下发条件说明
  1. 支付 当用户在小程序内完成过支付行为，可允许开发者向用户在7天内推送有限条数的模板消息（1次支付可下发1条，多次支付下发条数独立，互相不影响）
  2. 提交表单 当用户在小程序内发生过提交表单行为且该表单声明为要发模板消息的，开发者需要向用户提供服务时，可允许开发者向用户在7天内推送有限条数的模板消息（1次提交表单可下发1条，多次提交下发条数独立，相互不影响）
审核说明
  1. 标题 标题不能存在相同 标题意思不能存在过度相似 标题必须以“提醒”或“通知”结尾 标题不能带特殊符号、个性化字词等没有行业通用性的内容 标题必须能体现具体服务场景 标题不能涉及营销相关内容，包括不限于：消费优惠类、购物返利类、商品更新类、优惠券类、代金券类、红包类、会员卡类、积分类、活动类等营销倾向通知
  2. 关键词 同一标题下，关键词不能存在相同 同一标题下，关键词不能存在过度相似 关键词不能带特殊符号、个性化字词等没有行业通用性的内容 关键词内容示例必须与关键词对应匹配 关键词不能太过宽泛，需要具有限制性，例如：“内容”这个就太宽泛，不能审核通过
  3. 违规说明 除不能违反运营规范外，还不能违反以下规则，包括但不限于： 不允许恶意诱导用户进行触发操作，以达到可向用户下发模板目的 不允许恶意骚扰，下发对用户造成骚扰的模板 不允许恶意营销，下发营销目的模板
  4. 处罚说明 根据违规情况给予相应梯度的处罚，一般处罚规则如下： 第一次违规，删除违规模板以示警告， 第二次违规，封禁接口7天， 第三次违规，封禁接口30天， 第四次违规，永久封禁接口 处罚结果及原因以站内信形式告知

订阅消息

功能介绍

我们为开发者提供了订阅消息能力，用户一次订阅、长期有效，在中长期范围内实现服务的闭环和更优的体验。

  • 订阅消息推送位置：小程序通知
  • 订阅消息下发条件：用户自主订阅。订阅后，1天最多收到1次订阅消息
  • 订阅消息卡片跳转能力：点击查看详情可跳转至该小程序的页面
  • 数据统计：可通过场景值 = 2085，计算订阅消息来源用户数据
使用说明

步骤一：获取模板 ID

在开发者管理端，手动配置获取模板 ID：

步骤二：引导用户授权下发订阅消息

向用户发起主动订阅小程序授权请求。调用后会立刻弹窗询问用户是否同意主动订阅小程序。

如果用户之前已经同意授权，则不会出现弹窗，直接返回成功。（授权体系详见相关文档）

  1. 小程序端授权接口
  2. 小游戏端授权接口

步骤三：调用消息下发接口

  1. 小程序端消息订阅接口
  2. 小游戏端消息订阅接口
最终效果

审核说明
  1. 标题 标题意思不能存在过度相似 标题不能带特殊符号、个性化字词等没有行业通用性的内容 标题必须能体现具体服务场景 标题不能涉及营销相关内容，包括不限于：消费优惠类、购物返利类、商品更新类、优惠券类、代金券类、红包类、会员卡类、积分类、活动类等营销倾向通知
  2. 关键词 同一标题下，关键词不能存在相同 同一标题下，关键词不能存在过度相似 关键词不能带特殊符号、个性化字词等没有行业通用性的内容 关键词内容示例必须与关键词对应匹配 关键词不能太过宽泛，需要具有限制性，例如：“内容”这个就太宽泛，不能审核通过
  3. 违规说明 除不能违反运营规范外，还不能违反以下规则，包括但不限于： 不允许恶意诱导用户进行触发操作，以达到可向用户下发模板目的 不允许恶意骚扰，下发对用户造成骚扰的模板 不允许恶意营销，下发营销目的模板
  4. 处罚说明 根据违规情况给予相应梯度的处罚，一般处罚规则如下： 第一次违规，删除违规模板以示警告， 第二次违规，封禁接口7天， 第三次违规，封禁接口30天， 第四次违规，永久封禁接口 处罚结果及原因以站内信形式告知

关系链强化

加好友能力

为鼓励用户在QQ内沉淀关系链，加强未来在QQ内的传播，平台支持在小程序/小游戏内用户加QQ好友的能力。

步骤一：引导用户授权被加好友权限

为避免骚扰，需要用户先授权在当前appid允许被加好友后，才能进行被加好友操作。

使用qq.authorize，引导用户完成授权。

参数填入为 setting.addFriend

TIPS：开发者可以调用 qq.openSetting 打开设置界面，引导用户开启授权。

步骤二：加好友按钮

  1. 小程序调用方式示例

使用button组件，并填入对应参数 open-type="addFriend" open-id="对方openid" bindaddfriend="addfriend"

  1. 小游戏调用方式示例

qq.createAddFriendButton