本文包括友盟+QQ小游戏统计分析SDK的接入方法、集成测试以及说明事项。 创建QQ小游戏并按照以下步骤成功集成SDK后，您可以查看友盟+为您的QQ小游戏收集的数据。 、props等分析socket。
适用范围
本文档适用于QQ小游戏统计SDK 2.3.2及以上版本
1.快速集成QQ小游戏统计SDK 1.注册友盟+账号
登录友盟+官网，按照引导注册友盟+账号
特别提醒：建议开发者在注册账号时使用企业邮箱，避免使用个人邮箱注册，防止因个人辞职而引发问题。 推荐帐号方式为：umeng@企业域名、apps@企业域名、dev@企业域名
2.Appkey申请
进入小程序统计后台创建Appkey，按要求填写小程序名称和类型：
您还可以通过OpenAPI批量申请Appkey。 具体文件请参考：
行业分类请参考：创建申请数量超过300个，请联系在线客服
3.创建QQ游戏并连接SDK3.1 下载SDK
SDK下载地址文档建议首次集成使用稳定版本。
3.2 集成SDK
下载后的文件放在QQ小游戏工程的utils目录下。 下面假设SDK文件放在utils目录下。
在QQ小游戏项目根目录下的启动文件game.js文件底部添加以下JS代码
import uma from './utils/umtrack-qqgame/uma.min.js';
uma.init({
appKey:'xxxx',
useOpenid:false,// default true
autoGetOpenid:false,
debug:true,
uploadUserInfo:true// 是否上传用户信息
});
// 主程序其他模块可以通过qq.uma引用第三步：使用OpenID（可选）
//设置useOpenid为True
useOpenid:true// default true方法一：开发者需要额外添加代码上传openid，否则数据不会上报
//开启后必须额外添加代码上传OpenID，否则数据不会上报
qq.uma.setOpenid(openid)方法二：在友盟后台设置有效的appId和secret信息，并开启autoGetOpenid: true
App({
umengConfig:{
appKey:'YOUR_UMENG_APPKEY',//由友盟分配的APP_KEY
useOpenid:true,//default true
// 授权友盟+通过后台自动获取openid，可防止数据统计过程中因未采集到OpenID而造成
// 数据丢失的情况。开启后请到友盟+小程序应用设置中添加appId及secret信息
autoGetOpenid:true,
uploadUserInfo:true// 是否上传用户信息
}
})第四步：设置共享参数。 只有设置了分享参数qq小程序免费游戏源码，才能统计小游戏的相关分享、分享回流、分享新数据。方法一：使用如下方法设置分享跳出
方法二：在qq.shareAppMessage的反弹中，调用qq.uma.trackShare上报共享干扰。 不想使用qq.uma.shareAppMessage来调用分享？ 然后您可以在qq.shareAppMessage的反弹中调用qq.uma.trackShare报告共享干扰。 该方法传入分享参数，返回的对象 qq.shareAppMessage 中会添加分享追踪相关的查询演示代码
var data = qq.uma.trackShare({query:"foo=bar",title:'调trackShare'});
qq.shareAppMessage(data);演示代码wx.onShareAppMessage
qq.onShareAppMessage(function(){
var share ={
title:'代码调用分享',
imageUrl:'',// 图片 URL
query:'key1=val1&key2=val2'
};
let data = qq.uma.trackShare(share);
return data;
})3.4 QQ小游戏减少友盟域名+数据服务
QQ开发者后台添加请求合法域名： 操作步骤：登录QQ小程序开放平台，进入小程序的设置->开发设置->服务器域名，添加请求合法域名，如图图中：
3.5 SDK配置项汇总及注意事项
参数配置项
类型/值
首先使用默认值
防范措施
参数函数
使用Openid
真假
真的
如果设置为true，但未设置友盟+openid或未上报openid，则不会发送用户数据
统计用户标记为openid
自动获取Openid
真假
真的
设置完成后，需要在后台“设置”功能中填写小程序的appid和appsecret，否则无法获取openid； 注意，当该配置项为true时，请务必将useOpenid配置项设置为true
sdk发出请求获取openid； 授权友盟+通过后台手动获取openid，可避免数据统计过程中因采集不到OpenID而导致数据丢失
上传用户信息
真假
错误的
还没
获取用户信息和头像，您可以在“分享分析”功能中根据头像查看用户的分享排名
调试
真假
真的
还没
是否开启调试模式； 建议开启，可以帮助小程序端数据上报的调试
2. 高级功能
如需使用其他API，需要添加以下代码：
import uma from './utils/umtrack-wxgame/uma.min.js';
uma.init({
appKey:'xxxx',
useOpenid:false,// default true
autoGetOpenid:false,
debug:true,
uploadUserInfo:true// 是否上传用户信息
});
// 主程序1. 设置Unionid
开发者自行设置用户的unionid
qq.uma.setUnionid(id)范围：
返回值：
2. 自定义事件
友萌+提供基于收入、等级、等级、道具等的带有socket的小游戏，请查看文档
更多自定义事件需求，您还可以参考以下自定义事件和属性上报。
参考：Applet自定义事件文档
3. 设置应用程序用户ID
当用户在您的小程序上注册时qq小程序免费游戏源码，您的应用程序服务器将在用户数据库中添加一条记录并分配一个用户ID。 您可以通过setUserid接口设置用户ID以供后续数据连接使用，也可以根据应用程序用户ID设置。 估计时使用。
qq.uma.setUserid(userId, provider)范围：
返回值： 无 示例：
qq.uma.setUserid('custom_userid');4.上传用户信息
开发者可以通过在配置中添加 uploadUserInfo: true 选项，让友盟手动上报用户信息。 将 uploadUserInfo 设置为 false 可取消上传用户信息。 上传的用户信息为小程序平台公开的用户基本信息，如昵称、头像、性别、地区、语言等。该信息将用于U-小程序产品中用户相关功能的统计。 例子：
import uma from './utils/umtrack-wxgame/uma.min.js';
App({
umengConfig:{
appKey:'YOUR_UMENG_APPKEY',//由友盟分配的APP_KEY
useOpenid:false,// 是否使用openid进行统计，此项为false时将使用友盟+随机ID进行用户统计。使用openid来统计微信小程序的用户，会使统计的指标更为准确，对系统准确性要求高的应用推荐使用OpenID。
autoGetOpenid:false,// 是否需要通过友盟后台获取openid，如若需要，请到友盟后台设置appId及secret
debug:true,//是否打开调试模式
uploadUserInfo:true// 自动上传用户信息，设为false取消上传，默认为false
}
});3. SDK成功接入验证方法
该方案仅提供验证集成是否成功的方法。 由于开发环境中数据可能不完整，请在小程序发布后验证数据的正确性。
按照上述说明导入SDK；
进入IDE，打开调试工具中的控制台选项。 如果看到提示“[umeng]—SDK集成成功”，则说明SDK集成成功。
4、注意事项
小心调用 qq.clearStorage() 和 qq.clearStorageSync() 接口！ SDK会将用户相关的操作数据缓存在客户端数据存储模块中，并在特定时间启动发送策略。 调用该socket可能会导致数据统计不准确；
如果用户在使用小程序时强行关闭陌陌，可能会导致统计数据丢失。
