在Android工程中集成友盟統計
首先需要在友盟官網注冊賬號并添加新應用,獲取Appkey。具體步驟這里不進行敘述。
1.集成準備
首先需要集成友盟統計SDK
有兩種方式:
1.下載SDK,并復制到工程 lib/目錄下;
2.通過添加gradle依賴,在app/builde.gradle
中添加
dependencies {
compile 'com.umeng.analytics:analytics:latest.integration'
}
因為gradle文件有變化,所以需要更新下工程,就可以使用友盟統計包中的方法了。
接下來在工程中配置Appkey
在AndroidManifest.xml中添加權限,填寫Appkey和渠道id,代碼如下:
<manifest……>
<uses-sdk ……></uses-sdk>
<!--這4個權限都是必須添加的,最好檢查下是否同工程已經添加的權限重復,權限具體用途請自行搜索-->
<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>
<application ……>
……
<activity ……/>
<!--替換為在友盟后臺申請的應用Appkey-->
<meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"></meta-data>
<!--應用的推廣渠道名稱,Channel ID自定義-->
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
</application>
</manifest>
如果希望在代碼中配置Appkey,Channel等信息,就在程序入口處調用下面的方法:
MobclickAgent. startWithConfigure(UMAnalyticsConfig config)
需要創建UMAnalyticsConfig實例,該類有多個構造方法
UMAnalyticsConfig(Context context, String appkey, String channelId)
?
UMAnalyticsConfig(Context context, String appkey, String channelId, EScenarioType eType)
UMAnalyticsConfig(Context context, String appkey, String channelId, EScenarioType eType,Boolean isCrashEnable)
構造意義:String appkey:官方申請的AppkeyString channel: 渠道號EScenarioType eType: 場景模式,包含統計、游戲、統計盒子、游戲盒子Boolean isCrashEnable: 可選初始化. 是否開啟crash模式
- 建議在AndroidManifest文件中進行配置
2.session統計
在每個Activity的onResume方法中調用 MobclickAgent.onResume(Context)
, onPause方法中調用 MobclickAgent.onPause(Context)
。
對于繼承了BaseActivity的類,不要同時在父和子Activity中重復添加onResume和onPause方法,會造成重復統計。
確保在所有的Activity中都調用 MobclickAgent.onResume() 和MobclickAgent.onPause()方法,這兩個調用將不會阻塞應用程序的主線程,也不會影響應用程序的性能。
當應用在后臺運行超過30秒(默認)再回到前端,將被認為是兩個獨立的session(啟動),例如用戶回到home,或進入其他程序,經過一段時間后再返回之前的應用。可通過接口:MobclickAgent.setSessionContinueMillis(long interval) 來自定義這個間隔(參數單位為毫秒)。
如果調用Process.kill或者System.exit之類的方法殺死進程,請務必在此之前調用MobclickAgent.onKillProcess(Context context)方法,用來保存統計數據。
3.頁面統計
只包含Activity的應用,使用上面2.session統計 進行設置就已經默認統計了每個Activity的挑戰路徑了。頁面統計不需要再添加其他代碼。
對包含Activity、Fragment和FragmentActivity的應用,需要進行以下設置。
建議定義統一的BaseActivity、BaseFragment及BaseFragmentActivity,然后工程中的類分別對應繼承這些Base類,那么就只需要對Base類進行配置了,當然在Base類里也可以定義其他一些方法。
說下base類如何配置
BaseActivity.class
public class BaseActivity extends Activity {
@Override
protected void onResume() {
super.onResume();
MobclickAgent.onResume(this);
}
?
@Override
protected void onPause() {
super.onPause();
MobclickAgent.onPause(this);
}
}
BaseFragment.class
public abstract class BaseFragment extends Fragment {
@Override
public void onResume() {
super.onResume();
MobclickAgent.onPageStart(getClass().getName());
}
?
@Override
public void onPause() {
super.onPause();
MobclickAgent.onPageEnd(getActivity().getLocalClassName());
}
}
BaseFragmentActivity
public class BaseFragmentActivity extends FragmentActivity {
@Override
protected void onResume() {
super.onResume();
MobclickAgent.onResume(this);
}
?
@Override
protected void onPause() {
super.onPause();
MobclickAgent.onPause(this);
}
}
- 新創建的Activity需要繼承BaseActivity
4.發送策略
發送策略有兩種方式:1.啟動時發送;2.按間隔發送。默認使用啟動時發送的策略
在友盟后臺進行設置,位置:**統計分析->設置->發送策略 **
5.日志加密、代碼混淆
在程序入口設置加密模式
/** 設置是否對日志信息進行加密, 默認false(不加密). */
AnalyticsConfig.enableEncrypt(boolean enable);//6.0.0版本以前
MobclickAgent.enableEncrypt(boolean enable);//6.0.0版本及以后
代碼混淆
如果應用使用了混淆,需要在混淆文件添加
-keepclassmembers class * {
public <init> (org.json.JSONObject);
}
-keep public class [實際的應用包名].R$*{
public static final int *;
}
-keepclassmembers enum * {
public static **[] values();
public static ** valueOf(java.lang.String);
}
6.自定義事件統計
自定義事件也就是常說的埋點事件,當如果點擊了某個按鈕時將用戶的這一動作記錄下來,并傳回給服務器,方便統計。
這里只說下計數事件
在希望跟蹤的位置,調用如下方法:
MobclickAgent.onEvent(Context context, String eventId); // eventId 事件ID,自己定義
代碼添加之后,在友盟后臺需要添加事件,位置 統計分析->設置->事件,將定義的事件ID添加就可以了。
附:友盟官方文檔地址