移動網(wǎng)盟類效果監(jiān)控sdk嵌入說明-v2

1、下載類廣告效果監(jiān)控SDK使用說明V2.1目錄 TOC o 1-3 h z u HYPERLINK l _Toc397428870 目錄 PAGEREF _Toc397428870 h 2 HYPERLINK l _Toc397428871 第一章 簡介 PAGEREF _Toc397428871 h 3 HYPERLINK l _Toc397428872 第二章 添加Jar包與配置修改 PAGEREF _Toc397428872 h 3 HYPERLINK l _Toc397428873 第三章 代碼集成 PAGEREF _Toc397428873 h 7 HYPERLINK l _Toc39

2、7428874 第四章 添加防混淆 PAGEREF _Toc397428874 h 10 HYPERLINK l _Toc397428875 第五章 代碼嵌入檢測 PAGEREF _Toc397428875 h 10第一章 簡介為了能夠對推廣應用進行效果監(jiān)控和優(yōu)化，應用推廣方須在推廣應用中嵌入百度效果監(jiān)控SDK，并按照本說明的方法準確填寫參數(shù)。百度效果監(jiān)控SDK是百度移動統(tǒng)計SDK的定制版本，故其使用方法與百度統(tǒng)計SDK相近，統(tǒng)計相關的其他接口可以參見補充文檔-原版百度統(tǒng)計SDK使用手冊。在您的應用內(nèi)嵌入監(jiān)控sdk代碼的流程如下，請按照流程準確嵌入代碼：整體流程：第二章 添加Jar包與配置修改

3、第一節(jié) 添加jar包將壓縮包中的libs/Baidu_AppMon_SDK_out.jar 文件復制到Android工程的libs目錄下，如下圖所示：第二節(jié)申請appkey（BaiduMobAd_STAT_ID）通過登錄 HYPERLINK 獲取，這個key是對您應用的唯一標識符（注：在獲取到appkey之后，不需要下載統(tǒng)計sdk。因為上一步已經(jīng)添加了定制版SDK）。獲取appKey的方式如下圖所示：另外，多個應用（即：不同包名的應用）不要共用一個AppKey，這會導致監(jiān)控異常！第三節(jié) 配置AndroidManifest.xmlmanifest xmlns:android=/apk/res/a

4、ndroid package=com.baidu.mobstat.demo 渠道號填寫為: Baidu-Mobads（區(qū)分大小寫），該渠道號標識了您在百度移動渠道推廣應用，也是效果統(tǒng)計的過濾依據(jù)。務必準確填寫渠道號，否則會引起統(tǒng)計偏差。如果您希望在Baidu-Mobads渠道下設置子渠道，請?zhí)顚懬捞枮? Baidu-Mobads_subchannel，其中subchannel是您的子渠道號.例如：子渠道號是abc，則渠道號設置為: Baidu-Mobds_abc。監(jiān)控所需的Activity聲明，需要完整地復制到您配置文件的application標簽下。注意更改scheme和host的值：an

5、droid:scheme為appkey前加“x”，android:host為appkey。例子：假如您申請到的appkey=5fd6b6814d則：android:scheme=x5fd6b6814dandroid:host=5fd6b6814d第三章 代碼集成第一節(jié) 調(diào)用激活接口在每次應用啟動時，調(diào)用：ActiveManager.sendActive(this.getApplicationContext();該方法只在新用戶首次啟動時發(fā)送數(shù)據(jù)，用以確定用戶首次激活時間。第二節(jié) 調(diào)用事件接口百度統(tǒng)計sdk能夠檢測一些默認的行為，并統(tǒng)計一些基礎指標如：首次激活、留存率、使用時間、使用頻次等。為了

6、能夠更好的監(jiān)控轉化效果，并通過自動優(yōu)化的方式幫助您提升轉化效果，降低推廣成本。推薦在合適的位置嵌入自定義行為統(tǒng)計，監(jiān)控您可能更加關注的指標：注冊用戶、充值用戶。（自定義事件次數(shù)統(tǒng)計接口調(diào)用方法參見：補充文檔-原版百度統(tǒng)計SDK使用手冊 第五章-第五節(jié)-1/自定義事件次數(shù)統(tǒng)計）注意：event_id必須是以下定義的兩個：newRegisterUser或payingUser（大小寫一致），否則處理中會被忽略。1）注冊用戶event_id : newRegisterUserlabel : 注冊用戶調(diào)用范例：（請在用戶注冊完成處調(diào)用）StatService.onEvent(context, newRe

7、gisterUser, 注冊用戶);2）充值用戶Event_id : payingUserLabel : 充值用戶調(diào)用范例：（請在用戶充值完成處調(diào)用）StatService.onEvent(context, payingUser, 充值用戶);其中，事件需要在系統(tǒng)中注冊：第三節(jié) 調(diào)用頁面時長接口Activity頁面時長開發(fā)者需要在每個Activity的onResume()和onPause()中調(diào)用SDK提供的StatService.onResume(Context context)StatService.onPause (Context context)；context參數(shù)是當前Activit

8、y的引用,這里請不要將全局的application context傳入。 注意：如果開發(fā)者在父類Activity中添加了這兩個函數(shù)調(diào)用，那么在子類Activity中就務必不要添加這兩個函數(shù)調(diào)用。注：為了使使用時長等數(shù)據(jù)更加準確，建議開發(fā)者在每個頁面都添加統(tǒng)計接口，至少要在主界面添加。說明:發(fā)送日志數(shù)據(jù)時，sdk將會自動地從AndroidManifest.xml文件里讀取Appkey。如果你的appkey是寫在xml頁面里的。確保在所有的activity中都調(diào)用StatService.onResume(this)和StatService.onPause(this)方法，這兩個調(diào)用將不會阻塞應用程

9、序的主線程，也不會影響應用程序的性能。注意如果您的Activity之間有繼承或者控制關系，請不要同時在父和子Activity中重復添加onPause和onResume方法，否則會造成統(tǒng)計數(shù)據(jù)混亂(例如.使用TabHost、TabActivity、ActivityGroup時)。一個應用程序在多個activity之間連續(xù)切換時，將會被視為同一個session(啟動)。當用戶兩次使用之間間隔超過30秒時，將被認為是兩個的獨立的session(啟動)，例如用戶回到home，或進入其他程序，經(jīng)過一段時間后再返回之前的應用。該數(shù)值可以通過StatService.setSessionTimeOut(30)

10、函數(shù)來設置。特別注意：Activity的頁面的onResume以及onPause函數(shù)不能多個頁面交叉調(diào)用如出現(xiàn)調(diào)用順序：onResumeonResume或者onPauseonPause，統(tǒng)計將會出問題。必須是順序的onResumeonPause onResume onPause。如果需要進行交叉調(diào)用，那么可以使用onPageStart和onPageEnd自定義頁面統(tǒng)計函數(shù)來配合使用。onPageStart和onResume是可以交叉調(diào)用的。Fragment頁面統(tǒng)計開發(fā)者需要在需要統(tǒng)計的Fragment的onResume()和onPause()中調(diào)用SDK提供的StatService.onRes

11、ume(Context context)StatService.onPause (Context context)；context參數(shù)是當前Fragment的引用,這里請不要將全局的application context或者Activity的Context傳入。 注意：如果開發(fā)者在父類Fragment中添加了這兩個函數(shù)調(diào)用，那么在子類Fragment中就務必不要添加這兩個函數(shù)調(diào)用。注：建議開發(fā)者在需要統(tǒng)計的頁面都添加統(tǒng)計接口，至少要在能夠填充整個界面的Fragment中添加。特別注意：Fragment的頁面的onResume以及onPause函數(shù)不能多個頁面交叉調(diào)用如出現(xiàn)調(diào)用順序：onResu

12、meonResume或者onPauseonPause，統(tǒng)計將會出問題。必須是順序的onResumeonPause onResume onPause。如果需要進行交叉調(diào)用，那么可以使用onPageStart和onPageEnd自定義頁面統(tǒng)計函數(shù)來配合使用。onPageStart和onResume是可以交叉調(diào)用的。具體參見demo里面的Fragment可以和Activity的頁面以及自定義的頁面交叉調(diào)用。如果Fragment以及包含F(xiàn)ragment的Activity都使用了統(tǒng)計，那么頁面順序是按照頁面的結束時間來排序。例如MainActivity中有三個Fragment 1、2、3.那么依次訪問的

13、順序為MainActivityFragment123。由于我們是按照頁面結束時間來記錄，那么我們收集的日志順序為Fragment123MainActivity。特殊用法注意：若有一個Fragment如TestFragment同時被初始化多次，那么如果調(diào)用StatService.onResume()和StatService.onPause()函數(shù)，我們只會記錄TestFragment這個頁面名稱，而且在運行時由于被同時多次初始化，從而造成多次調(diào)用onResume和onPause函數(shù)，且順序不正常，從而造成有頁面丟失的exception異常拋出到Log日志，可以通過eclipse的log查看，請?zhí)?/p>

14、別注意。自定義頁面統(tǒng)計開發(fā)者需要在需要統(tǒng)計的View頁面的onPageStart和onPageEnd()中調(diào)用SDK提供的StatService.onPageStart(Context context, Sring pageName);StatService.onPageEnd(Context context, Sring pageName);context參數(shù)是Activity的Context或者application的Context的引用, 這里請注意同一個頁面pageName必須一樣，否則無法統(tǒng)計到。 注意：如果開發(fā)者在父類自定義View中添加了這兩個函數(shù)調(diào)用，那么在子類View中就務必

15、不要添加這兩個函數(shù)調(diào)用。注：為了使使用時長等數(shù)據(jù)更加準確，建議開發(fā)者在每個頁面都添加統(tǒng)計接口，至少要在能夠填充整個界面的自定義View中添加。特別注意： 自定義頁面統(tǒng)計的onPageStart以及onPageEnd函數(shù)不能多個頁面交叉調(diào)用如出現(xiàn)調(diào)用順序：onPageStartonPageStart或者onPageEndonPageEnd，統(tǒng)計將會出問題。必須是順序的onPageStartonPageEnd onPageStart onPageEnd。具體參見demo里面的Fragment可以和Fragment的頁面以及Activity的頁面交叉調(diào)用。如果自定義頁面以及包含自定義頁面的Activ

16、ity或者Fragment都使用了統(tǒng)計，那么頁面順序是按照頁面的結束時間來排序。例如MainActivity中有三個Page 1、2、3.那么依次訪問的順序為MainActivityPage123。由于我們是按照頁面結束時間來記錄，那么我們收集的日志順序為Page123MainActivity。詳細參見Demo中自定義頁面的使用。如果您還想使用崩潰統(tǒng)計等功能，可以參考補充文檔-原版百度統(tǒng)計SDK使用手冊，來添加額外的Java代碼。第四章 添加防混淆在Android項目的proguard配置文件中，添加以下代碼防止混淆：-keep public class com.baidu.mobile.appmon.MonActivity-keep public class co