现在的位置: 首页 > 综合 > 正文

MobclickAgent_onPause_Android

2014年10月12日 ⁄ 综合 ⁄ 共 3282字 ⁄ 字号 评论关闭

导入Analytics_Android_SDK_1.1.jar

Eclipse用户 右键您的工程根目录,选择Properties -> Java Build Path -> Libraries, 然后点击Add External JARs... 选择指向Analytics_Android_SDK_1.1.jar的路径,点击OK,即导入成功。
Android SDK tools 如果您是直接使用android SDK tools,只要将Analytics_Android_SDK_1.1.jar放在应用程序的libs目录下,and task会自动识别出来。

配置AndroidManifest.xml

  1. android.permission.INTERNET 向我们的服务器发送用户分析数据。
  2. android.permission.READ_PHONE_STATE 这个权限仅为了获取用户手机的IMEI,用来唯一的标识用户。
  3. android.permission.READ_LOGS (可选), 如果您想获得客户端crash的报告, 需要添加这个权限。具体见高级功能错误报告
  4. 将应用程序的Appkey (需要先添加应用程序获得Appkey) 写到AndroidManifest.xml的meta-data里。
    <application......>
    ...
    <meta-data android:value="XXXXXXYOURAPPKEYXXXXXXX" android:name="UMENG_APPKEY"></meta-data>
    ...
    </application>

添加代码

  1. 添加 import com.mobclick.android.MobClickAgent
  2. 在每个Activity的onResume方法中调用 MobclickAgent.onResume(Context), 传入的参数为当前context的引用,这个方法将会自动地从AndroidManifest.xml文件里读取Appkey。 这里请不要将全局的application context传入。
    public void onResume() {
    super.onResume();
    MobclickAgent.onResume(this);
    }
  3. 在每个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,或进入其他程序,经过一段时间后再返回之前的应用。

测试

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

错误报告 (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);
...
}

自定义事件分析

除了的基本统计分析功能外,我们还支持您自定义的事件分析,例如您可以统计游戏中通过不同关卡的人数,广告的点击次数或者视频被播放的次数等等。这里我们将提供几个简单而通用的接口:
  1. 简单事件
    MobclickAgent.onEvent(Context context, String event_id);
    将统计event_id对应事件的发生次数,变化趋势,例如广告点击,短信数量等等。参数context为当前context的引用。event_id为当前统计的事件ID,您可以在程序里直接定义,但是我们推荐您在

    这里
    预先定义。
    一个例子,监测应用程序里广告的点击次数,事件ID为“ad_click”。那么需要在程序里每次广告点击后调用 MobclickAgent.onEvent(this, "ad_click") 通知服务器一个广告点击事件。
  2. 多标签事件
    MobclickAgent.onEvent(Context context, String event_id, String label);
    除了能够统计event_id所对应事件的发生次数,变化趋势外,还能统计事件中具体标签所占的比例。label为当前标签。
    例如在我们的demo应用程序“星座罗盘”中,定义了一个事件“星座关注分布”,每个星座对应这个事件中的一个标签。我们可以在生产的统计图表中看到用户关注不同星座的比例。
  3. 事件累计
    在应用程序中某些自定义事件可能会被频繁触发,例如用户点击某个按钮。开发者可以在程序中维护一个计数器,这样某个事件被多次触发但只需要生成一个消息,这个消息中包括该事件被触发的次数。为了支持这个功能,这里我们简单重载了之前的两个接口:
    MobclickAgent.onEvent(Context context, String event_id, int acc);
    MobclickAgent.onEvent(Context context, String event_id, String label, int acc);
    参数acc是对应事件 (和对应标签)被触发的次数。

分发渠道分析

我们还提供方法帮助您分析应用程序的分发渠道,例如有多少用户来自于联想乐phone,又有多少用户通过Google android market下载到您的应用程序。简单的您只需要在AndroidManifest.xml里添加meta-data:。
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL">
当然,这需要您在不同渠道发布应用程序时,重新编译打包。

实时发送

应用程序产生每条消息(包括启动信息,自定义消息,退出消息)时都会立即发送到服务器,设置实时发送需要在应用程序Main Activity的onCreate()中调用。
MobclickAgent.setReportPolicy(ReportPolicy.REALTIME);

启动时发送

应用程序每次只会在启动时会向服务器发送一次消息,在应用程序过程中产生的所有消息(包括自定义事件和本次使用时长)都会在下次启动时候发送。 如果应用程序启动时处在不联网状态,那么消息将会缓存在本地,下次再尝试发送。 发送策略默认为启动时发送。

抱歉!评论已关闭.