QQ 小程序

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

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

请在 QQ 小程序开发者平台首页 https://q.qq.com 点击右上角的「注册」按钮。

tips: 1、查看个人和公司的区别 2、个体户务必注意：请谨慎选择您的主体类型。如果您的银行开户名跟营业执照名称不一致，则请直接选择为个人。（目前后台个体户的银行开户名默认是营业执照名称，而如果您的银行开户名称是法人个人名字，会导致 step3 认证失败）。更多请戳接入指引里的常见问题 Q&A。

2.2.1 填写邮箱和密码

请填写未注册过邮箱，并登录邮箱，查收激活邮件，点击激活链接。

tips: 如果没收到激活邮件怎么办，请戳接入指引里的常见问题 Q&A

2.2.2 企业主体认证

企业账号需要上传营业执照图片、主体名称、号码类型、证件号码，请填写清晰无误；

2.2.3 管理员信息登记

登记相应管理员信息，姓名，身份证，以及绑定手机号码进行短信验证；

温馨提示：此环节需在光线充足条件下，进行人脸识别

2.3.1 开发者资质审核主流程：QQ 小程序企业主体资质认证包括工商信息、银行打款 2 个环节。

tips： 务必第一时间完成此环节，此环节无法催审且通过后才能发提审流程

2.3.2 注册主要流程和问题

tips:： 1、若系统没有对应的【开户银行】，请通过邮箱反馈： [email protected] ；问题反馈格式：缺少开户银行+APPID+小程序名+开户银行全名； 2、系统没有对应【银行所在地的区】，可选择同市其他区； 注意：不支持银行信息的修改，请谨慎填写，以防影响开发者资质审核；

tips:： 1、验证金额哪里拿：填写的银行账户会收到来自腾讯的打款，回填 1 元以下随机金额进行验证 2、打款帐号主体：深圳市腾讯计算机系统有限公司 3、打款银行帐号：755901658210820

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

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

3.1.1 开发设置

3.1.2 成员管理

3.1.3 选择服务类目

tips: 1、后续上线支持修改名称 2、此步骤不意味着抢占名字，最终以审核上线为准

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

tips: 开发文档会不断更新 API 及相关能力，请随时保持关注

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

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

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

需注意是否已完成以下操作：小程序常见问题指引

tips: 如遇到社交/文娱视频/文娱 FM 电台等类目，第一次代码提审时会额外有个 7 个自然日的二审周期，不支持催审，请务必预留充足提审时间

开发者在后台完成发布后，24 小时以内，小程序会发布到线上提供服务，用户将能通过搜索、分享等场景体验到该小程序

在开发者点击发布并且小程序经过内部审核后，24 小时内即可上架应用商店供 QQ 用户搜索。平台会提供算法资源给到小程序，综合数据优质的 QQ 小程序，会获得可观的算法流量。

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

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

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

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

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

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

后台管理端会自动根据小程序选择的类目，展示接入 QQ 钱包、微信支付或米大师的页面。如有错误，请联系 [email protected] 邮箱沟通修改。

具体界定说明文档：服务类目对应的支付类型说明

路径：管理端首页-小程序信息编辑-服务类目

虚拟支付即米大师解决方案（目前支持 Q 币、QQ 钱包、微信支付）

接入说明：目前平台虚拟支付的米大师支付方案（支持 QQ 钱包+微信支付）正在内测阶段；

(1) QQ 钱包（目前支持钱包余额、银行卡支付）

(2)微信支付

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

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

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

2019 年 7 月 23 日起，未出现严重违规的企业主体小程序、小游戏均可接入广告；过去 7 天日均独立访问用户（UV）不低于 100 且已上线的个人开发者小程序均可接入广告； 详见开发者管理端 广告接入页面。

在管理端后台申请，填写资料后，2 小时内审核通过生效

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

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

请注意:

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

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

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

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

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

有以下两种调用方式：

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

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

1.2.1 小程序

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

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

1.2.2 小游戏

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

案例：

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

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

2.1.1 小程序

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

2.1.2 小游戏

qq.shareAppMessage ，设置 shareAppType=qqFastShareList

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

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

2.2.1 生效场景

2.2.2 小程序

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

2.2.3 小游戏

qq.shareAppMessage ，设置 shareAppType=qqFastShare

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

调用方式：

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

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

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

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

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

TIP

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

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

url 规则： https://m.q.qq.com/a/p/{appid}?s={encodeURIComponent(path)}

参数

示例：

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

https://m.q.qq.com/a/p/1108291530?s=a%3D1%26b%3D2

warning 注意

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

互联 SDK 下载地址：Android 、iOS

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

为满足不同场景下的消息触达，平台提供一次性订阅&长期订阅&系统订阅消息能力。（备注：授权文案不可修改，授权时机可自行决定）

推送位置：

数据统计：

【注意】

步骤一：填写服务器配置

登录小程序后台 后，在「设置」-「开发设置」-「消息推送」中，填写服务器地址（URL）、令牌（Token） 等信息。详细请查阅相关文档

步骤二：获取模板 ID

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

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

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

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

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

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

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

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

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

参数填入为 setting.addFriend

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

步骤二：加好友按钮

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

使用qq.createAddFriendButton 接口。

支持从小程序加群，帮助开发商维护私域流量。

小程序调用方式示例：使用button 组件，并填入对应参数 open-type="openGroupProfile"。

小游戏调用方式示例：使用qq.openGroupProfile 接口。

支持从小程序加频道，升级开发商私域流量管理能力。

小程序调用方式示例：使用button 组件，并填入对应参数 open-type="openGuildProfile"。

支持从小程序关注公众号，同时支持公众号与小程序绑定，建立 QQ 内生态闭环。

小程序调用方式示例：使用button 组件，并填入对应参数 open-type="openPublicProfile"。

小游戏调用方式示例：使用qq.openPublicProfile 接口。

1）QQ 公众号绑定小程序

a、操作地址： https://mp.qq.com/vpage/login

b、小程序管理--添加--通过 appid or 小程序名称搜索并绑定

2）公众号菜单设置跳转小程序

a、完成小程序绑定

b、自定义菜单--跳转到小程序

3）公众号解绑小程序

a、通过公众号平台操作 https://mp.qq.com/vpage/login

b、通过小程序平台操作 https://q.qq.com

4）公众号绑定小程序规则

a、公众号最多可以绑定 3 个小程序

b、解绑后，30 天内不能重复绑定同一个小程序

c、小程序可以被无限公众号绑定；且默认无需确认即可被绑定

d、小程序可以在小程序管理端，设置被公众号绑定规则：不能被绑定、可以被绑定，但需要小程序管理员确认、可以被绑定，且不需要小程序管理员确认（默认状态）

5）小程序模板&订阅消息，通过绑定公众号下发

在调用对应接口下发小程序模板消息或订阅消息同时，设定 oac_appid 为绑定的公众号 appid，此时消息将通过指定公众号下发。

需关注，若因该用户未关注公众号等情况导致消息无法触达用户，需要开发者自行处理闭环逻辑。

涉及接口为小程序模板消息 和小程序订阅消息 。小程序和小游戏皆可通用。

应用子频道为 QQ 频道的子频道类型之一，以 QQ 小程序为主要载体，是频道提供给第三方应用的开放能力之一。频道用户将借助小程序探索更多丰富多样的玩法，而频道则为小程序开发商提供更多流量和用户。

用户体验示例图：小程序开发者入驻频道且获全量推荐后，频道主可自行添加使用小程序。

主要包括三个环节：

小程序开发者在 QQ 小程序开发平台-频道接入 ，上传频道素材，小程序 UI 等根据 QQ 频道场景值（5002）进行改造和适配。

注：开发者工具适配频道场景在开发中，前期调试可在测试频道中进行

【频道接入】入口

开发者通过【频道接入】入口提供外显信息，频道列表支持展示 3 类信息。

点击应用子频道标题、应用子频道外显内容（最多 5 行），可以打开不同的小程序页面。

子频道标题、外显信息在【频道接入】中提交，示例：pages/index/index。无需单独做 url 编码。

配置外显信息代码介绍请参考外显信息推送

小程序作为应用子频道的一种类型，希望给频道用户一致的交互和 UI 体验，对齐其他类型子频道样式，给用户更沉浸式的频道体验。因此交互和 UI 上需要开发者做一定的适配。

如下图所示，左侧为原生 titleBar，右侧为频道 titleBar

需注意：从子频道列表点击应用子频道标题打开小程序时，频道后台会在跳转链接中带上子频道名称，需要小程序开发者将应用子频道名称填入落地页 titleBar 的 title 部分。进入小程序子频道后，点击跳转其他子页面，title 同现有小程序设置 title 流程。

频道进入没有全屏小程序，全部为频道样式导航栏。如果原来是全屏小程序，需要小程序开发者自行适配 。

平台将选取 UI 适配、玩法新颖、内容丰富的小程序在应用子频道添加面板中分享，如下图的“腾讯投票”。

针对希望被推荐和分发的小程序，平台供开发者自查规范如下：