1. MTA(Android)接入指南
1.1. 基础指标统计
基础指标包括次数统计、页面统计,会话统计,错误统计4个部分。
1.1.1. 统计次数
自定义事件分析,通过管理台事件配置,后台代码埋点,可完成用户行为追踪,如按钮点击次数等,详情见帮助文档
新建应用时,系统默认注册3个事件。在SDK接入时,按示例代码埋点即可,体验自定义事件功能。
(1)接口内容
void StatService.trackCustomKVEvent(Context ctx, String event_id,
Properties properties)
参数:
Ctx 页面的设备上下文
event_id 事件标识
args 事件参数
(2)代码示例
// 以下三个事件已在管理台由MTA预先为您配置完成,在相应位置完成代码埋点即可完成统计
// 进入首页事件,统计用户进入首页的次数
StatService.trackCustomKVEvent(this, "homepage", null);
// 用户注册事件,统计用户点击注册按钮的次数
StatService.trackCustomKVEvent(this, "register", null);
// 用户登录事件,统计用户点击登录按钮的次数
StatService.trackCustomKVEvent(this, "login", null);
1.1.2. 页面统计
使用下面的函数统计某个页面的访问情况:
Ø 标记一次页面访问的开始
void StatService.onResume(Context ctx)或
void StatService.trackBeginPage(Context ctx, String pageName)
(1)参数:
Ctx 页面的设备上下文
pageName 自定义页面名称,需跟trackEndPage一一匹配使用
@Override
protected void onResume() {
super.onResume();
StatService.onResume(this);
}
(2)调用位置:
每个activity的onResume()
(注意:每次调用,MTA会检查是否产生新会话(session超时),即生成启动次数。)
Ø 标记一次页面访问的结束
void StatService.onPause (Context ctx)或
void StatService.trackEndPage(Context ctx, String pageName)
参数:
Ctx 页面的设备上下文
pageName 自定义页面名称,需跟trackBeginPage一一匹配使用
调用位置:
每个activity的onPause()
@Override
protected void onPause() {
super.onPause();
StatService.onPause(this);
}
(注意:onResume和onPause或trackBeginPage和trackEndPage需要成对使用才能正常统计activity,为了统计准确性,建议在每个activity中都调用以上接口,否则可能会导致MTA上报过多的启动次数,解决办法参考“特殊需求”)
Ø 通过继承的方式统计页面访问
开发者可以通过app本身的acivity基类,调用MTA的onResume和onPause,并在所有子类中,重载这2个方法,实现页面统计功能。可参考MtaDemo中的BaseActivity和DrivedActivity代码。
另外,MTA SDK中的下面两个类实现了StatService.onResume()和StatService.onPause()的调用,可直接继承以下类并在子类中重载页面统计接口。
com.tencent.stat.EasyActivity 继承自android.app.Activity
com.tencent.stat.EasyListActivity 继承自android.app.ListActivity
注:如果使用3.0.0或以上版本SDK,默认通过监控 Activity 生命周期采集页面时长,无需额外添加代码,SDK 版本低于 3.0.0 的建议更新到最新版
1.1.3. 会话统计
会话统计用于统计启动次数,由SDK本身维护,通常开发者无需额外设置或调用接口。
以下3种情况下,会视为用户打开一次新的会话:
1) 应用第一次启动,或者应用进程在后台被杀掉之后启动
2) 应用退到后台或锁屏超过X之后再次回到前台
X秒通过StatConfig.setSessionTimoutMillis(int)函数设置,默认为30000ms,即30秒
举例说明:用户打开手机QQ连续操作10分钟,之后按home键(或锁屏)退到后台,超过30秒后再次回到QQ,此时,SDK会上报一次会话。
注意:请根据您的app业务情况决定是否调整超时时间。
3) 调用SDK提供的startNewSession()函数
void StatService.startNewSession(Context ctx)
参数:
Ctx 页面的设备上下文
1.2. 注意
- 若使用自定义或第三方打包工具打包,建议通过代码接口的方式配置渠道,具体步骤:
- 渠道打包工具打包
- 代码中,读取打包工具设置的渠道
- 初始化时,调用StatConfig.setInstallChannel(ctx, channel)设置MTA渠道
- 如需同时统计app内的h5页面数据,请根据hybird app android使用说明进行集成