跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

微信小游戏

本文包含微信小游戏统计分析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

  1. 下载的文件放在微信小游戏项目里,比如 utils 目录下。下面会假设 SDK 文件放在 utils 目录下。

  2. 在微信小游戏项目根目录的启动文件 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.onShareAppMessage

  • uma.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合法域名,如图:image.png

友盟SDK接入推荐配置项设置

友盟SDK接入推荐配置项设置