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. 注意

  • 若使用自定义或第三方打包工具打包,建议通过代码接口的方式配置渠道,具体步骤:
  1. 渠道打包工具打包
  2. 代码中,读取打包工具设置的渠道
  3. 初始化时,调用StatConfig.setInstallChannel(ctx, channel)设置MTA渠道

results matching ""

    No results matching ""