# 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数据起算，DAU峰值>500，且未出现严重违规。 详见开发者管理端广告接入页面。

# 1.2 相关文档

• QQ小程序广告接入指引
• QQ小程序广告组件应用规范&优化建议

# 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 个月处理 所有存量数据。

• 未进驻QQ互联的开发者

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

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

# 社交流量

# 1. 分享到QQ和Qzone

为满足开发者对社交传播的诉求，我们提供了分享小程序到QQ好友、QQ群聊和QQ空间的能力，开发者只需对API showShareMenu 进行简单设置即可使用。

# 2. 从外部App分享

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

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

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

• Mobile QQ ≤ 8.0.0
• PC QQ
• macOS QQ
• iPad
• AndroidPad

# 3. 通过二维码打开

为满足开发者通过二维码扫描打开指定小程序，并且跳转到指定页面的诉求，我们提供了 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