友盟---诊断跟踪工具

本文主要是介绍友盟---诊断跟踪工具，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

http://scofield-android.iteye.com/blog/1350499

1- 导入Analytics_Android_SDK_2.1.jar

Eclipse用户 右键您的工程根目录，选择Properties -> Java Build Path -> Libraries，然后点击Add External JARs... 选择指向Analytics_Android_SDK_2.1.jar的路径，点击OK，即导入成功。

Android SDK tools 如果您是直接使用android SDK tools，只要将Analytics_Android_SDK_2.1.jar放在应用程序的libs目录下，and task会自动识别出来。

2- 配置AndroidManifest.xml

android.permission.INTERNET

向我们的服务器发送用户分析数据。
android.permission.READ_PHONE_STATE

这个权限仅为了获取用户手机的IMEI，用来唯一的标识用户。
android.permission.READ_LOGS (可选),

如果您想获得客户端crash的报告, 需要添加这个权限。具体见高级功能错误报告
将应用程序的Appkey (需要先添加应用程序获得Appkey)

写到AndroidManifest.xml的meta-data里。

<application......>

...

<meta-data android:value=" XXXXXXYOURAPPKEYXXXXXXX"

android:name=" UMENG_APPKEY">

</meta-data>

...

</application>

3.添加代码

添加 import com.mobclick.android.MobClickAgent
在每个Activity的onResume方法中调用 MobclickAgent.onResume(Context), 传入的参数为当前context的引用， 这个方法将会自动地从AndroidManifest.xml文件里读取Appkey。

这里请不要将全局的application context传入。

public void onResume() {

super.onResume();

MobclickAgent.onResume(this);

}
在每个Activity的onPause方法中调用MobclickAgent.onPause(Context),

只需传入一个参数当前activity的context.

public void onPause() {

super.onPause();

MobclickAgent.onPause(this);

}

一个应用程序在多个activity之间连续切换时，将会被视为同一个session，

所以需要您确保在所有的activity中都调用 MobclickAgent.onResume()和MobclickAgent.onPause()方法，这两个调用将不会阻塞应用程序的主线程，也不会影响应用程序的行能。

当用户两次使用之间间隔超过30秒时，将被认为是两个的独立的session，

例如用户回到home，或进入其他程序，经过一段时间后再返回之前的应用。

4 测试

确认所需的权限都已经添加：

INTERNET, READ_PHONE_STATE, (READ_LOGS for crash report)
确认APPKEY已经正确的写入manifest.xml
确认所有的Activity中都调用了onResume和onPause方法
确认测试手机(或者模拟器)已成功连入网络
启动应用程序，几分钟之后您应该已经可以看到相应的报表.
如果几分钟后报表中仍然没有收到数据，请与我们的技术支持联系 QQ1589487991 或者邮件到support@umeng.com我们会尽快回复您

高级功能

1--错误报告 (crash report)

友盟统计分析工具，还可以帮助您捕捉用户在使用应用程序过程中出现的异常退出(FC), 并在应用程序 下次启动时将错误报告发送给服务器。

错误报告包含应用程序版本，操作系统版本和设备型号以及程序出现异常时的Stacktrace，这些数据将帮助您修正应用程序Bug。

您需要在AndroidManifest.xml里面添加权限 android.permission.READ_LOGS，

并且在程序的Main Activity (应用程序入口)的 onCreate方法里调用MobclickAgent.onError(Context):

public void onCreate(Bundle savedinstanceState) {

super.onCreate(savedInstanceState);

MobclickAgent.onError(this);

...

}

错误报告报表示例

2自定义事件分析

除了的基本统计分析功能外，我们还支持您自定义的事件分析，

例如您可以统计游戏中通过不同关卡的人数，广告的点击次数或者视频被播放的次数等等。

这里我们将提供几个简单而通用的接口：

简单事件

MobclickAgent.onEvent(Context context, String event_id);

将统计event_id对应事件的发生次数，变化趋势，例如广告点击，短信数量等等。参数 context为当前context的引用。 event_id为当前统计的事件ID，您可以在程序里直接定义，但是我们推荐您在这里预先定义。

一个例子，监测应用程序里广告的点击次数，事件ID为“ad_click”。那么需要在程序里每次广告点击后调用 MobclickAgent.onEvent(this, "ad_click") 通知服务器一个广告点击事件。

简单事件分析图表示例
多标签事件

MobclickAgent.onEvent(Context context, String event_id, String label);

除了能够统计event_id所对应事件的发生次数，变化趋势外，还能统计事件中具体标签所占的比例。 label为当前标签。

例如在我们的demo应用程序“星座罗盘”中，定义了一个事件“星座关注分布”，每个星座对应这个事件中的一个标签。我们可以在生产的统计图表中看到用户关注不同星座的比例。

多标签事件分析图表示例
事件累计

在应用程序中某些自定义事件可能会被频繁触发，例如用户点击某个按钮。开发者可以在程序中维护一个计数器，这样某个事件被多次触发但只需要生成一个消息，这个消息中包括该事件被触发的次数。为了支持这个功能，这里我们简单重载了之前的两个接口：

MobclickAgent.onEvent(Context context, String event_id, int acc);

MobclickAgent.onEvent(Context context, String event_id, String label, int acc);

参数acc是对应事件（和对应标签）被触发的次数。