QQ小程序

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

亮点

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

接入流程

1. 阅读文档

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

2. 注册开发者平台

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

2.1选择注册的帐号类型

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

2.2账号注册

2.2.1 填写邮箱和密码

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

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

2.2.2 企业主体认证

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

2.2.3 管理员信息登记

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

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

2.3资质审核

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

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

2.3.2 注册主要流程和问题

审核中-资料审核：注册完成即自动进入工商信息审核。此步骤无需开发者操作，但请随时关注状态。
审核中-待打款：填写银行信息（路径：管理端首页-开发者资质状态-查看详情）

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

审核中-打款中：3天内腾讯公司将会对填写的银行账户进行小额打款。
审核中-输入验证码：收到打款后，请在规定时间内于开发者管理端回填1元以下随机金额进行验证。

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

3. 创建小程序

3.1完成小程序资料

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

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

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

3.1.1 开发设置

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

3.1.2 成员管理

路径：权限管理——成员管理

3.1.3 选择服务类目

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

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

4. 编码开发小程序

4.1编码开发小程序

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

下载地址：开发者工具
开发文档：https://q.qq.com/wiki/develop/miniprogram/frame/

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

4.2提交审核

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

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

4.3小程序发布

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

5. 审核发布

5.1提审前

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

5.2代码提审

审核时效：审核一般为1-3个工作日。不支持催审，请耐心等候审核验收结果
审核结果：请自行在后台查收，如审核不通过，则按照要求修正后
审核申诉：如对审核结果有异议，请直接在后台的站内信中有个申诉入口，进行申诉即可

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

6. 发布

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

7. 上线运营

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

开放能力

高级接口

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

开发能力

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

支付能力

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

1. QQ钱包

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

2. 腾讯计费

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

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

3.支付接入指引

3.1如何界定实体支付还是虚拟支付（实体支付和虚拟支付仅支持1个，不可同时接入1个小程序内）

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

具体界定说明文档：服务类目对应的支付类型说明
路径：管理端首页-小程序信息编辑-服务类目

3.2虚拟支付

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

3.3实体支付

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

接入文档：《QQ钱包接入文档》
费率说明：《QQ钱包费率说明》

(2)微信支付

接入文档：《微信支付接入文档》
费率说明：《微信支付费率说明》

广告能力

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

1. 流量主

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

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

1.1 准入条件

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

1.2 申请办法

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

1.3 相关文档

2. 广告主

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

广告买量指引路径：管理端-我要推广。蓝色箭头为指引文档。中间的投放展示，是支持落地小程序/小游戏的资源位置。

QQ互联

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

已进驻QQ互联的开发者

申请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互联的开发者

开发者需要先登录QQ互联注册账号；
在使用小程序的AppID、AppSecret在QQ互联-管理应用页面中添加绑定小程序；
选中需要创建的应用（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.15.0）

2.1.2 小游戏

qq.shareAppMessage，设置shareAppType=qqFastShareList

2.2 直接分享到原会话

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

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

直接分享到原会话

2.2.1 生效场景

2.2.2 小程序

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

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={encodeURIComponent(path)}

参数

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

示例：

打开小程序，appid为1108291530，path为pages/game-list/game-list，参数为mode=wanba，url如下：

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

打开小游戏，appid为1108291530，（小游戏不涉及path），参数为a=1&b=2，url如下：

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

warning 注意

s参数必须进行encode

QQ低版本的场景会展示为默认页，不需要额外做兼容逻辑

url 生效版本如下：

Android QQ Version ≥ 8.05

iOS QQ Version ≥ 8.03

3. 外部APP打开小程序

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

互联SDK下载地址：Android、iOS

消息触达

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

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

一次性订阅：一次授权下发一条，可推送小程序/小游戏内最新活动/版本信息/回流活动等。（进行长线的用户关系维护，从而提高用户活跃和留存）
长期订阅：小程序/小游戏累计用户数达到20w后自动开通该能力，用户授权同意后，小程序/小游戏每天可向用户下发一条社交互动类消息。
系统订阅：一次授权，当有用户成功触发互动行为（排行超越、赠送礼物）时由平台下发消息

推送位置：

一次性订阅&系统订阅消息：QQ提醒

长期订阅消息：QQ主界面下拉-右上角信封-小程序通知（如果存在订阅消息的未读通知，小程序/小游戏icon和信封会有红点显示）

数据统计：

一次性订阅&系统订阅消息：场景值=2102，场景名称为“QQ提醒”
长期订阅消息：场景值=2085，场景名称为“长期订阅消息”

【注意】

原模板消息接口已全部停用，开发者管理端入口已下线，模板消息相关接口调用失败，请改为使用上述订阅消息进行消息通知
长期订阅仅用于社交互动类消息下发，如果是版本/活动等信息推送请使用一次性订阅下发；对于已经停用的长期订阅模板，管理端已经进行了标红提示，请从模板库中重新选择合适的模板使用。
长期订阅消息授权开关的有效期为一周，如果用户一周未登陆小程序/小游戏则授权自动关闭，小程序/小游戏无法再向用户下发消息（错误码：46006），需要引导用户进入小程序/小游戏设置页面重新打开授权开关后才可继续下发消息

使用说明

步骤一：填写服务器配置

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

步骤二：获取模板 ID

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

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

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

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

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

授权弹窗展示

审核说明

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

温馨提示

用户主动订阅路径第一次进入小游戏/小程序时若选择“暂不接受”订阅消息，后续仍可通过“浮点-关于-设置-小程序订阅消息“开启该功能。
增加“订阅”图标为了提升该能力的利用率，开发商可以在小游戏/小程序界面中添加”订阅“的图标，并且为订阅的用户提供一定的小游戏/小程序奖励，激励用户主动添加该功能。（下图为《一起打桌球》游戏界面）

用户分层我们建议小游戏/小程序在发送通知时进行用户分层，针对不同的用户群体推送不同内容的信息，如对流失用户推出回流礼包，对新注册用户推出新手礼包，对老用户进行版本和活动通知等。
推送内容建议为提升用户体验，推送文案可以设计得诙谐有趣。

私域流量运营

加好友能力

为鼓励用户在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接口。

公众号能力

支持从小程序关注公众号，同时支持公众号与小程序绑定，建立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小程序

# 亮点

# 接入流程

# 1. 阅读文档

# 2. 注册开发者平台

# 2.1选择注册的帐号类型

# 2.2账号注册

# 2.3资质审核

# 3. 创建小程序

# 3.1完成小程序资料

# 4. 编码开发小程序

# 4.1编码开发小程序

# 4.2提交审核

# 4.3小程序发布

# 5. 审核发布

# 5.1提审前

# 5.2代码提审

# 6. 发布

# 7. 上线运营

# 开放能力

# 高级接口

# 开发能力

# 支付能力

# 1. QQ钱包

# 2. 腾讯计费

# 3.支付接入指引

# 3.1如何界定实体支付还是虚拟支付（实体支付和虚拟支付仅支持1个，不可同时接入1个小程序内）

# 3.2虚拟支付

# 3.3实体支付

# 广告能力

# 1. 流量主

# 1.1 准入条件

# 1.2 申请办法

# 1.3 相关文档

# 2. 广告主

# QQ互联

# 社交分享

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

# 1.1 qq.showShareMenu

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

# 2. 快速分享能力

# 2.1 快速分享面板

# 2.2 直接分享到原会话

# 3. 一键发空间说说

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

# 外部分享

# 1. 从外部App分享

# 2. 通过二维码打开

# 3. 外部APP打开小程序

# 消息触达

# 使用说明

# 授权弹窗展示

# 审核说明

# 温馨提示

# 私域流量运营

# 加好友能力

# 加群能力

# 公众号能力