连接年轻用户的新方式,覆盖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、若系统没有对应的【开户银行】,请通过邮箱反馈: qq-miniprogram@tencent.com ;问题反馈格式:缺少开户银行+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钱包、微信支付或米大师的页面。如有错误,请联系 qq-miniprogram@tencent.com 邮箱沟通修改。
具体界定说明文档:服务类目对应的支付类型说明
路径:管理端首页-小程序信息编辑-服务类目
虚拟支付即米大师解决方案(目前支持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和小程序关联后即可实现。
TIP
在下列场景接收小程序类型分享,将按照开发者设定的分享参数转成网页类型分享:
- Mobile QQ ≥ 8.1.0
- PC QQ
- macOS QQ
- iPad
- AndroidPad
为满足开发者通过二维码扫描打开指定小程序,并且跳转到指定页面的诉求,我们提供了 url 跳转小程序的能力,开发者按照下述规则生成 url ,再生成 url 对应的二维码即可使用。
url规则:
https://m.q.qq.com/a/p/{appid}?s={encodeURIComponent(path)}
参数
属性 | 类型 | 默认值 | 必填 | 说明 | |
---|---|---|---|---|---|
s | string | 否 | 需要跳转到的指定页面路径,如果需要传入参数,可以拼在路径之后,此参数需要进行url encode |
示例:
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 注意
- s参数必须进行encode
- QQ低版本的场景会展示为默认页,不需要额外做兼容逻辑
- url 生效版本如下:
- Android QQ Version ≥ 8.05
- iOS QQ Version ≥ 8.03
已有App的开发者可以通过接入QQ互联SDK,在相同主体前提下,通过APP打开QQ小程序。
基于QQ的通知渠道,我们为开发者提供了可以高效触达用户的消息能力,以便实现服务的闭环并提供更佳的体验。
为满足不同场景下的消息触达,平台提供了两种下发消息的能力,模板消息 & 订阅消息。
模板消息:无需用户感知,即可获取消息下发权限。下发权限有时限,适合需要对用户行为进行及时反馈的场景。 【注意】 原模板消息接口已全部停用,开发者管理端入口已下线,模板消息相关接口调用失败,请改为使用一次性订阅消息进行消息通知。
订阅消息:需用户主动订阅后,才可获取消息下发权限。下发权限长期有效,适合中长期运营。
推送位置:QQ主界面下拉-右上角信封-小程序通知。(如果存在订阅消息/模板消息的未读通知,游戏icon和信封会有红点显示)
【注意】 原模板消息接口已全部停用,开发者管理端入口已下线,模板消息相关接口调用失败,请改为使用一次性订阅消息进行消息通知。
步骤一:从开发者管理端,获取模板 ID
步骤二:页面的 form 组件,属性 report-submit 为 true 时,可以声明为需要发送模板消息,此时点击按钮提交表单可以获取 formId,用于发送模板消息。或者当用户完成 支付行为,可以获取 prepay_id 用于发送模板消息。
步骤三:调用接口下发模板消息
小程序
小游戏
在小游戏里,由于没有类似小程序的表单组件,因此采用一套新方案来实现类似模板消息能力。
当有用户使用QQ小游戏时,小游戏服务后台可接收1次QQ服务器通知的formid。同个appid下,单个用户7天内最多触发1个formid。
通过formid,调用sendTemplateMessage验证模板消息可以成功下发后,再进行全量推广。
【注意】
步骤一:填写服务器配置
登录小程序后台后,在「设置」-「开发设置」-「消息推送」中,填写服务器地址(URL)、令牌(Token) 等信息。详细请查阅相关文档
步骤二:获取模板 ID
在开发者管理端,手动配置获取模板 ID:
步骤三:引导用户授权下发订阅消息
向用户发起主动订阅小程序授权请求。调用后会立刻弹窗询问用户是否同意主动订阅小程序。
如果用户之前已经同意授权,则不会出现弹窗,直接返回成功。(授权体系详见相关文档)
步骤四:调用消息下发接口
为鼓励用户在QQ内沉淀关系链,加强未来在QQ内的传播,平台支持在小程序/小游戏内用户加QQ好友的能力。
步骤一:引导用户授权被加好友权限
为避免骚扰,需要用户先授权在当前appid允许被加好友后,才能进行被加好友操作。
使用qq.authorize,引导用户完成授权。
参数填入为 setting.addFriend
TIPS:开发者可以调用 qq.openSetting 打开设置界面,引导用户开启授权。
步骤二:加好友按钮
使用button组件,并填入对应参数 open-type="addFriend" open-id="对方openid" bindaddfriend="addfriend"
支持从小程序加群,帮助开发商维护私域流量。
小程序调用方式示例:使用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,此时消息将通过指定公众号下发。
需关注,若因该用户未关注公众号等情况导致消息无法触达用户,需要开发者自行处理闭环逻辑。