微信小游戏
本文包含微信小游戏统计分析SDK的接入方法、设定自定义事件、SDK配置项及注意事项等内容。按以下步骤成功集成微信小游戏SDK后,即可查看友盟+为您微信小游戏采集的数据,除此之外,您还可以使用友盟+提供的基于小游戏收入、关卡、等级、道具等分析的接口。
适用范围
该文档适用于微信小游戏统计SDK 2.3.2 及以上版本
一、微信小游戏统计SDK快速集成

1. 注册友盟+账号
登录友盟+官网,按照引导注册友盟+账号
特别提醒:我们建议开发者在注册账号时使用企业邮箱,避免使用个人邮箱注册,防止由于个人离职带来的问题,建议使用的账号形式 :umeng@企业域名、apps@企业域名、dev@企业域名
2. Appkey申请

3. 创建微信小游戏并接入SDK
3.1 下载SDK
SDK下载地址文档 https://developer.umeng.com/docs/147615/detail/184228推荐首次集成使用稳定版。
3.2 集成SDK
下载的文件放在微信小游戏项目里,比如 utils 目录下。下面会假设 SDK 文件放在 utils 目录下。
在微信小游戏项目根目录的启动文件 game.js 文件的顶部添加以下JS代码
import uma from './utils/umtrack-wxgame/uma.min.js';
uma.init({
appKey:'xxxx',
useOpenid:true,// default true
autoGetOpenid:true,
debug:true,
uploadUserInfo:true// 上传用户信息,上传后可以看到有用户头像和昵称的分享信息
});
// 主程序其他模块可通过 wx.uma 来引用
3.3 使用 OpenID
//设置useOpenid为True
useOpenid:true// default true方法一:开发者需要额外添加代码上传openid,否则数据不会上报
//开启后必须额外添加代码上传OpenID,否则数据不会上报
wx.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
}
})3.4 设置分享参数
设置分享参数时,才可以统计到小游戏的相关分享及分享回流、分享新增数据。
方法一:使用以下方法来设置分享回调
uma.onShareAppMessage()替代wx.onShareAppMessageuma.shareAppMessage()替代wx.shareAppMessage
方法二:在 wx.shareAppMessage 的回调中自行调用 uma.trackShare 上报分享事件不想使用 uma.shareAppMessage 来调用分享?那么你可以在wx.shareAppMessage 的回调中自行调用 uma.trackShare 上报分享事件,该方法传入分享参数,返回对象中会添加分享追踪相关的query示范代码 wx.shareAppMessage
var data = wx.uma.trackShare({query:"foo=bar",title:'调trackShare'});
wx.shareAppMessage(data);示范代码 wx.onShareAppMessage
wx.onShareAppMessage(function(){
var share ={
title:'代码调用分享',
imageUrl:'',// 图片 URL
query:'key1=val1&key2=val2'
};
let data = wx.uma.trackShare(share);
return data;
})3.5. 自定义事件
友盟+为小游戏提供了基于收入、关卡、等级、道具等分析的接口,请查看文档小游戏高级自定义事件上报及使用文档
有更多自定义事件的需求,也可以参考以下自定义事件及属性的上报。
参考: 小程序自定义事件文档
3.6 增加友盟+数据服务域名
在微信开发者后台添加request合法域名:https://umini.shujupie.com操作步骤:登录微信公众平台,进入小程序的 设置->开发->开发设置->服务器域名,把 https://umini.shujupie.com 加入 request合法域名,如图: