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

1.2 相关文档

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	string		否	需要跳转到的指定页面路径，如果需要传入参数，可以拼在路径之后，此参数需要进行url encode

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

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的通知渠道，我们为开发者提供了可以高效触达用户的消息能力，以便实现服务的闭环并提供更佳的体验。

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

模板消息：无需用户感知，即可获取消息下发权限。下发权限有时限，适合需要对用户行为进行及时反馈的场景。 【注意】 原模板消息接口已全部停用，开发者管理端入口已下线，模板消息相关接口调用失败，请改为使用一次性订阅消息进行消息通知。

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

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

最终效果

模板消息

使用简介

【注意】 原模板消息接口已全部停用，开发者管理端入口已下线，模板消息相关接口调用失败，请改为使用一次性订阅消息进行消息通知。

功能简介：QQ每日推送符合条件的用户信息（7天内登陆过游戏且没收到过服务消息的用户），小游戏/小程序开发商可针对这部分用户推送消息卡片，卡片模板由平台提供，开发商只需更换icon及文案。
价值：可推送小游戏/小程序内最新活动/版本信息/回流活动等，有效触达用户，获取更多小程序、小游戏曝光。
模板消息下发条件：当用户有使用QQ小程序/小游戏时，平台后台将会为当前用户在当前小程序生成一个下发消息的凭证，即formid，并通过开发者提供的回调地址，将formid返回给开发者。同个appid下，单个用户7天内最多触发1个formid，即，同个appid 7天内，给1个用户最多下发1条消息。
数据统计：可通过场景值 = 1014，计算订阅消息来源用户数据。

使用说明

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

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

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

小程序

详见 sendTemplateMessage

小游戏

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

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

当有用户使用QQ小游戏时，小游戏服务后台可接收1次QQ服务器通知的formid。同个appid下，单个用户7天内最多触发1个formid。
通过formid，调用sendTemplateMessage验证模板消息可以成功下发后，再进行全量推广。

下发条件说明

支付当用户在小程序内完成过支付行为，可允许开发者向用户在7天内推送有限条数的模板消息（1次支付可下发1条，多次支付下发条数独立，互相不影响）
提交表单当用户在小程序内发生过提交表单行为且该表单声明为要发模板消息的，开发者需要向用户提供服务时，可允许开发者向用户在7天内推送有限条数的模板消息（1次提交表单可下发1条，多次提交下发条数独立，相互不影响）

审核说明

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

温馨提示

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

优秀案例——《欢乐水杯》

推送策略（1）体力召回推送时间：用户体力满时面向用户：新用户（2）版本更新、福利发放等推送时间：晚上6点（经测试，该时间推送效果最好）面向用户：新用户
推送时间游戏测试了早上9点、中午12点、晚上6点三个推送时间段，发现晚上6点推送效果最好。
数据表现游戏将新用户分为两组：一组在用户登录当天发送模板消息，另一组不发送。经试验，接收到模板消息的新用户比未接收到的新用户次留高2%。
文案示例（1）内容更新：水杯更新猫猫皮肤啦！多款萌猫水杯等你来撸！（2）玩法提示：只要墨水够，画线可以分开画噢！（3）福利预告: 猫咪老师杯会在第143关出现噢！（4）关卡预告：第173关有不用提示就过关的高手吗？

订阅消息

功能介绍

功能简介：开发者在小游戏/小程序内向用户发起订阅小游戏/小程序消息的授权弹窗，用户点击“允许”后，小游戏/小程序开发者每天可以给用户发送一条订阅消息。
价值：与模板消息不同，订阅消息一旦开通长期有效。开发商可以通过该能力实现老用户召回、活动通知等能力，进行长线的用户关系维护，从而提高用户活跃和留存。
订阅消息下发条件：用户自主订阅。订阅后，一位用户1天内最多收到1次订阅消息。
数据统计：可通过场景值 = 2085，计算订阅消息来源用户数据。（备注：授权文案不可修改，授权时机可自行决定）

【注意】

长期订阅消息，调整为内测开放。满足内测资格，即可在开发者管理端看到开通入口【消息模板-订阅消息-长期订阅】
对于已经停用的长期订阅模板，管理端已经进行了标红提示，请从模板库中重新选择合适的模板使用。

使用说明

步骤一：填写服务器配置

登录小程序后台后，在「设置」-「开发设置」-「消息推送」中，填写服务器地址（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. 注册开发者平台

# 3. 创建小程序

# 4. 编码开发小程序

# 5. 提交发布

# 5.1提交审核

# 5.2 小程序发布

# 开放能力

# 高级接口

# 开发能力

# 支付能力

# 1. QQ钱包

# 2. 腾讯计费

# 广告能力

# 1. 流量主

# 1.1 准入条件

# 1.2 相关文档

# 2. 广告主

# QQ互联

# 社交分享

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

# 1.1 qq.showShareMenu

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

# 2. 快速分享能力

# 2.1 快速分享面板

# 2.2 直接分享到原会话

# 3. 一键发空间说说

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

# 外部分享

# 1. 从外部App分享

# 2. 通过二维码打开

# 3. 外部APP打开小程序

# 消息触达

# 最终效果

# 模板消息

# 使用简介

# 使用说明

# 下发条件说明

# 审核说明

# 温馨提示

# 优秀案例——《欢乐水杯》

# 订阅消息

# 功能介绍

# 使用说明

# 授权弹窗展示

# 审核说明

# 温馨提示

# 私域流量运营

# 加好友能力

# 加群能力

# 公众号能力

QQ小程序

亮点

接入流程

1. 阅读文档

2. 注册开发者平台

3. 创建小程序

4. 编码开发小程序

5. 提交发布

5.1提交审核

5.2 小程序发布

开放能力

高级接口

开发能力

支付能力

1. QQ钱包

2. 腾讯计费

广告能力

1. 流量主

1.1 准入条件

1.2 相关文档

2. 广告主

QQ互联

社交分享

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

1.1 qq.showShareMenu

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

2. 快速分享能力

2.1 快速分享面板

2.2 直接分享到原会话

3. 一键发空间说说

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

外部分享

1. 从外部App分享

2. 通过二维码打开

3. 外部APP打开小程序

消息触达

最终效果

模板消息

使用简介

使用说明

下发条件说明

审核说明

温馨提示

优秀案例——《欢乐水杯》

订阅消息

功能介绍

使用说明

授权弹窗展示

审核说明

温馨提示

私域流量运营

加好友能力

加群能力

公众号能力