微信小游戏统计SDK接入指南

1.1 申请阿拉丁小游戏统计app_key

1.进入https://www.aldwx.com
2.注册/登录
3.申请app_key点击创建应用,选择微信小游戏,如下图所示。

1.2配置SDK


下载SDK,将解压得到的文件ald-game.jsald-game-conf.js拷贝到您项目的utils文件夹中

使用编辑器打开 ald-game-conf.js 文件,填写在阿拉丁申请的 app_key(可在统计后台的管理页面获取到)

//ald-game-conf.js
  exports.app_key = ""; //请在引号中填写从阿拉丁后台获取的appkey
  exports.getLocation = false; //默认不获取用户坐标位置

在游戏game.js中引入SDK,将下段代码放到game.js顶部

// game.js
require('utils/ald-game.js')

1.3添加微信request合法域名

管理员或开发者身份在微信小程序后台→设置→开发者设置中添加 request合法域名https://glog.aldwx.com

1.4检查是否集成成功

在小程序开发编辑器中,查看控制台中的Network是否有信息上报,且status状态为200。

SDK未提交到线上的小游戏,需要”切换到后台“才会显示实时数据。

1.5 接入完成

请注意:
1.二维码和分享的相关数据需要在已部署阿拉丁 SDK 的小游戏正式发布以后才可 以查看到。
2.分享传播模块的数据,需要修改小游戏相关代码才可监控,否则数据为空。点击这里查看修改方式.

高级功能

2.1事件功能

在开发的过程中,不同游戏引擎对微信API的适配方式不同。阿拉丁小游戏SDK是将,自定义类事件挂载到了wx对象上,可通过wx.来访问阿拉丁小游戏SDK的事件功能

2.2自定义事件埋点

参数 类型 描述
事件名称 string 描述用户的动作名称,不超过255个字符,支持特殊字符
参数 string 动作的参数,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)
参数值 string 动作的参数值,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)

格式件如下

  // 示例

  wx.aldSendEvent('事件名称',{'参数key' : '参数value'})
  // 案例1
  wx.aldSendEvent("玩家角色死亡",{
    "关卡" : "56关",
    "耗时" : startTime -  Date.now()
  })
  // 案例2
    wx.aldSendEvent("点击商城")

2.3分享统计自定义事件

阿拉丁小游戏SDK提供了对分享事件能力。wx.aldOnShareAppMessagewx.aldShareAppMessage方法,分别对应这wx.onShareAppMessagewx.shareAppMessage方法

wx.aldOnShareAppMessage

将微信的wx.OnShareAppMessage替换成wx.aldOnShareAppMessage

  //分享,监听用户点击右上角菜单的“转发”按钮时触发的事件
  wx.aldOnShareAppMessage(function(){
    return {
      imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com', //转发显示图片的链接
      title    : '分享title', //转发标题
      query    : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。
    }
  })

wx.aldShareAppMessage

将微信的wx.shareAppMessage替换成wx.aldShareAppMessage

  // 分享,主动拉起转发,进入选择通讯录界面
  wx.aldShareAppMessage({
    imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com',//转发标题
    title    : '分享title',//转发标题
    query    : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。
  })
© aldwx.com 北京阿拉丁未来科技有限责任公司 all right reserved,powered by Gitbook修订时间: 2018-12-14 20:13:20

results matching ""

    No results matching ""