帮助与文档

> >

本文档系AnalySDK云端版文档。请参考一下文档集成AnalySDK。

 一、获取AppKey,AppSecret

  1. 打开Mob官网,在官网选择登录或注册,新用户先注册,老用户直接登录。

注册页面如下图:

  1. 注册或登录完成后,会返回首页,点击右上⻆的“进⼊后台”,会跳转⾄管理后台,点击左侧,选择“添加应⽤”。如下图:

填入应用名称:

完成创建即可得到appkey和appsecret

选择’添加产品’,找到移动AnalySDK,点击马上开始,至此你的appkey将开始对AnalySDK生效

 

二、下载客户端SDK

请从官网http://www.mob.com/downloadDetail/AnalySDK/android下载客户端SDK,解压后可得到如下文件夹目录:

如上图所示,打开AnalySDK文件夹即可得到以下三个库文件,说明如下:

AnalySDK.jar  –  AnalySDK 的核心库

MobCommons.jar  –  AnalySDK 依赖的公共库

MobTools.jar  –  AnalySDK 依赖的工具库

三、快速集成Android客户端SDK

1、添加SDK

将AnalySDK.jar,MobCommons.jar,MobTools.jar添加到项目libs文件夹中,如下图所示:

 

2、配置AndroidManifest.xml文件

1)添加权限

 

2)将Application修改为MobApplication,添加Mob-AppKey 、Mob-AppSecret 和 渠道参数AnalySDK-Channel免去SDK初始化操作

 

3、代码调用

1)初始化MobSDK

如果您没有在AndroidManifest中设置appliaction的类名,MobSDK会将这个设置为com.mob.MobApplication,但如果您设置了,请在您自己的Application类中调用:

以初始化MobSDK。

2)代码调用

通过AnalySDK,您可以执行以下3种统计操作:

2-1、事件埋点

每个事件应有独立的事件名称,并且传入自定义的键值对参数用于统计数据,建议埋点的代码应部署于一些业务场景发生的地方,例如点击、回调、购买充值等场景。
有以下接口可调用:

例如,统计一个界面的访问次数,可这样写:

这里的page-jump为事件名称,对应统计后台中的”事件code”,创建成功后不可修改,建议使用26个字母与数字的组合,事件上传成功会在Mob统计后台项目里查看并添加描述,方便管理,如下图所示;

 

2-2、添加地理位置信息

一旦添加了地理位置信息,所有的统计事件均会自动带上此位置信息,可在统计后台查看相关详细数据
接口为:

代码调用为

 

2-3、用户事件

支持三种用户事件:用户注册、用户登录、用户信息修改

a>用户注册

接口为:AnalySDK.userRegist(GameUserEvent user)

代码调用如下:

b>用户登录

接口为:AnalySDK.userLogin(GameUserEvent user);

c>用户信息修改

接口为:AnalySDK.userUpdate(GameUserEvent user);

 

2-4、角色事件

支持三种角色事件:新建角色、角色登录、角色更新

a>新建角色

接口为:AnalySDK.roleCreate(RoleEvent roleEvent);

代码调用:

b>角色登录

接口为:AnalySDK.roleLogin(RoleEvent roleEvent);

c>角色更新

接口为:AnalySDK.roleUpdate(RoleEvent roleEvent);

 

2-5、支付事件

接口为:AnalySDK.trackPayEvent(PayEvent payEvent);

代码调用:

2-6、统计事件时长(统计SDK1.1.1版本增加)

一个事件的计时必须拥有behaviorStart和behaviorEnd埋点

同一个事件默认以堆栈形式开始-结束计时 ,更多详情可查看ApiDoc文档

如下统计一个页面显示时长事件:

A 事件开始

接口为:AnalySDK.behaviorStart(String eventName, HashMap<String, Object> eventObj)

代码调用如下:

A’ 事件结束

接口为:AnalySDK.behaviorEnd (String eventName, HashMap<String, Object> eventObj)

代码调用如下:

注意:Mob统计游戏专版为游戏行业做了垂直化定制,提供了3类共7个事件作为特殊事件;
强烈建议您调用SDK提供的方法直接埋点,这样将为您自动生成LTV、ARPU、ARRPU等游戏版专属数据分析模型  
点击查看详情

五、混淆设置

“Mob统计分析”已经做了混淆处理,再次混淆会导致不可预期的错误,请在您的混淆脚本中添加如下的配置,跳过对”Mob统计分析”的混淆操作:

-keep class com.mob.**{*;}

-dontwarn com.mob.**

六、注意事项

1、 如果使用MobSDK的模块会被其它模块依赖,请确保依赖它的模块也引入MobSDK插件,或在此模块的gradle中添加: