友盟統計SDK更新了,以前一些項目使用的老版SDK都需要更換成新版的,之前一直想找機會記錄一下,一直沒有機會,正好有個項目需要更換就做下記錄。
新建應用
新建應用之前你需要註冊一個友盟開發者賬號,自己用郵箱註冊一下就是了。
- 1、登錄友盟,選擇需要集成的功能,這裏我們就集成“U-App(應用統計)”
- 2、選擇“立即使用”,進入“我的產品”
- 3、選擇“添加新應用”,按照提示填寫相關信息,提交獲取AppKey
查看AppKey
提交完新應用之後,我們可以在“我的應用”中查看,我們賬號下的相關應用
相關的統計數據也是在這裏查看,OK,創建應用已經完成,現在我們來處理代碼中的使用
代碼集成
1、下載SDK
選擇對應的SDK進行下載,同時可以查看官方的集成文檔
SDK下載好之後,我們需要下面兩個jar包導入項目
- common/umeng-common-1.x.x.jar //統計的基礎服務包
- analytics/umeng-analytics-7.x.x.jar //統計包
2、AndroidManifest配置
注意: 新版本中即使已經在AndroidManifest.xml中配置appkey和channel(渠道標識)值,也需要在App代碼中調用初始化接口(如需要使用AndroidManifest.xml中配置好的appkey和channel值,UMConfigure.init調用中appkey和channel參數請置爲null):
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
...
<meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"/>
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
3、代碼中設置APPKEY
使用如下代碼
/**
* 初始化common庫
* 參數1:上下文,不能爲空
* 參數2:友盟 app key
* 參數3:友盟 channel
* 參數4:設備類型,UMConfigure.DEVICE_TYPE_PHONE爲手機、UMConfigure.DEVICE_TYPE_BOX爲盒子,默認爲手機
* 參數5:Push推送業務的secret
*/
UMConfigure.init(Context context, String appkey, String channel, int deviceType, String pushSecret);
注意:
參數1:上下文,必須的參數,不能爲空
參數2:友盟 app key,非必須參數,如果Manifest文件中已配置app key,該參數可以傳null,則使用Manifest中配置的app key,否則該參數必須傳入
參數3:友盟 channel,非必須參數,如果Manifest文件中已配置channel,該參數可以傳null,則使用Manifest中配置的channel,否則該參數必須傳入,channel命名請詳見channel渠道命名規範
參數4:設備類型,必須參數,傳參數爲UMConfigure.DEVICE_TYPE_PHONE則表示手機;傳參數爲UMConfigure.DEVICE_TYPE_BOX則表示盒子;默認爲手機
參數5:Push推送業務的secret,需要集成Push功能時必須傳入Push的secret,否則傳null
4、各種數據的統計
- 使用時間的統計
在每個Activity的onResume方法中調用 MobclickAgent.onResume(Context),
onPause方法中調用 MobclickAgent.onPause(Context)
我們可以在BaseActivity中的onResume方法中調用 MobclickAgent.onResume(Context), onPause方法中調用 MobclickAgent.onPause(Context),這樣就不需要再每個Activity中添加代碼了。
@Override
protected void onResume() {
super.onResume();
MobclickAgent.onResume(this);
}
@Override
protected void onPause() {
super.onPause();
MobclickAgent.onPause(this);
}
非常重要:必須調用 MobclickAgent.onResume() 和MobclickAgent.onPause()方法,才能夠保證獲取正確的新增用戶、活躍用戶、啓動次數、使用時長等基本數據。
- 使用用戶的統計
//當用戶使用自有賬號登錄時,可以這樣統計:
MobclickAgent.onProfileSignIn("userID");
//當用戶使用第三方賬號(如新浪微博)登錄時,可以這樣統計:
MobclickAgent.onProfileSignIn("WB","userID");
退出登錄時調用
MobclickAgent.onProfileSignOff();
- 其他統計
其他的統計可以看這裏:http://dev.umeng.com/sdk_integate/android_sdk/analytics_doc#1_2_3
查看應用使用數據
登錄友盟即可查看應用的使用數據了。