在Android工程中集成友盟統(tǒng)計
首先需要在友盟官網(wǎng)注冊賬號并添加新應(yīng)用,獲取Appkey息罗。具體步驟這里不進(jìn)行敘述。
1.集成準(zhǔn)備
首先需要集成友盟統(tǒng)計SDK
有兩種方式:
1.下載SDK,并復(fù)制到工程 lib/目錄下烤黍;
2.通過添加gradle依賴续担,在app/builde.gradle
中添加
dependencies {
compile 'com.umeng.analytics:analytics:latest.integration'
}
因為gradle文件有變化擅耽,所以需要更新下工程,就可以使用友盟統(tǒng)計包中的方法了物遇。
接下來在工程中配置Appkey
在AndroidManifest.xml中添加權(quán)限乖仇,填寫Appkey和渠道id,代碼如下:
<manifest……>
<uses-sdk ……></uses-sdk>
<!--這4個權(quán)限都是必須添加的询兴,最好檢查下是否同工程已經(jīng)添加的權(quán)限重復(fù)乃沙,權(quán)限具體用途請自行搜索-->
<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 ……/>
<!--替換為在友盟后臺申請的應(yīng)用Appkey-->
<meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"></meta-data>
<!--應(yīng)用的推廣渠道名稱,Channel ID自定義-->
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
</application>
</manifest>
如果希望在代碼中配置Appkey蕉朵,Channel等信息崔涂,就在程序入口處調(diào)用下面的方法:
MobclickAgent. startWithConfigure(UMAnalyticsConfig config)
需要創(chuàng)建UMAnalyticsConfig實例,該類有多個構(gòu)造方法
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)
構(gòu)造意義:String appkey:官方申請的AppkeyString channel: 渠道號EScenarioType eType: 場景模式始衅,包含統(tǒng)計冷蚂、游戲、統(tǒng)計盒子汛闸、游戲盒子Boolean isCrashEnable: 可選初始化. 是否開啟crash模式
- 建議在AndroidManifest文件中進(jìn)行配置
2.session統(tǒng)計
在每個Activity的onResume方法中調(diào)用 MobclickAgent.onResume(Context)
, onPause方法中調(diào)用 MobclickAgent.onPause(Context)
蝙茶。
對于繼承了BaseActivity的類,不要同時在父和子Activity中重復(fù)添加onResume和onPause方法诸老,會造成重復(fù)統(tǒng)計隆夯。
確保在所有的Activity中都調(diào)用 MobclickAgent.onResume() 和MobclickAgent.onPause()方法,這兩個調(diào)用將不會阻塞應(yīng)用程序的主線程别伏,也不會影響應(yīng)用程序的性能蹄衷。
當(dāng)應(yīng)用在后臺運行超過30秒(默認(rèn))再回到前端,將被認(rèn)為是兩個獨立的session(啟動)厘肮,例如用戶回到home愧口,或進(jìn)入其他程序,經(jīng)過一段時間后再返回之前的應(yīng)用类茂∷J簦可通過接口:MobclickAgent.setSessionContinueMillis(long interval) 來自定義這個間隔(參數(shù)單位為毫秒)托嚣。
如果調(diào)用Process.kill或者System.exit之類的方法殺死進(jìn)程,請務(wù)必在此之前調(diào)用MobclickAgent.onKillProcess(Context context)方法厚骗,用來保存統(tǒng)計數(shù)據(jù)示启。
3.頁面統(tǒng)計
只包含Activity的應(yīng)用,使用上面2.session統(tǒng)計 進(jìn)行設(shè)置就已經(jīng)默認(rèn)統(tǒng)計了每個Activity的挑戰(zhàn)路徑了领舰。頁面統(tǒng)計不需要再添加其他代碼夫嗓。
對包含Activity、Fragment和FragmentActivity的應(yīng)用提揍,需要進(jìn)行以下設(shè)置啤月。
建議定義統(tǒng)一的BaseActivity、BaseFragment及BaseFragmentActivity劳跃,然后工程中的類分別對應(yīng)繼承這些Base類谎仲,那么就只需要對Base類進(jìn)行配置了,當(dāng)然在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);
}
}
- 新創(chuàng)建的Activity需要繼承BaseActivity
4.發(fā)送策略
發(fā)送策略有兩種方式:1.啟動時發(fā)送郑诺;2.按間隔發(fā)送。默認(rèn)使用啟動時發(fā)送的策略
在友盟后臺進(jìn)行設(shè)置杉武,位置:**統(tǒng)計分析->設(shè)置->發(fā)送策略 **
5.日志加密辙诞、代碼混淆
在程序入口設(shè)置加密模式
/** 設(shè)置是否對日志信息進(jìn)行加密, 默認(rèn)false(不加密). */
AnalyticsConfig.enableEncrypt(boolean enable);//6.0.0版本以前
MobclickAgent.enableEncrypt(boolean enable);//6.0.0版本及以后
代碼混淆
如果應(yīng)用使用了混淆,需要在混淆文件添加
-keepclassmembers class * {
public <init> (org.json.JSONObject);
}
-keep public class [實際的應(yīng)用包名].R$*{
public static final int *;
}
-keepclassmembers enum * {
public static **[] values();
public static ** valueOf(java.lang.String);
}
6.自定義事件統(tǒng)計
自定義事件也就是常說的埋點事件轻抱,當(dāng)如果點擊了某個按鈕時將用戶的這一動作記錄下來飞涂,并傳回給服務(wù)器,方便統(tǒng)計祈搜。
這里只說下計數(shù)事件
在希望跟蹤的位置较店,調(diào)用如下方法:
MobclickAgent.onEvent(Context context, String eventId); // eventId 事件ID,自己定義
代碼添加之后容燕,在友盟后臺需要添加事件梁呈,位置 統(tǒng)計分析->設(shè)置->事件,將定義的事件ID添加就可以了。
附:友盟官方文檔地址