可視化圈選SDK接入
SDK簡介
百度移動統計無埋點SDK是在現有的手動埋點SDK上的一個功能更新。結合了所有手動埋點的優勢,同時避免了手動埋點的繁瑣過程。實作了一行代碼接入,配合WEB端圈選,完成頁面和事件統計功能。
百度移動統計無埋點SDK相容現有代碼埋點SDK,API完全相容支援。
版本支援
無埋點SDK支援 android 4.0 及之上(api level >= 14)系統版本。在Android 4.0 之下,依然可以使用此SDK,隻是無埋點功能無效。
內建使用
1、JAR配置
将下載下傳的SDK對應JAR包放入Android工程libs目錄下。
1)Android Studio工程配置
添加完成後,配置build.gradle,将JAR包納入編譯:
dependencies {
// 根據具體JAR名字替換
compile files('libs/Baidu_Mtj_3.7.5.0.jar')
}
2)Eclipse工程配置
直接将JAR包拷貝到libs目錄即可。
2、配置AndroidManifest.xml
1)添權重限聲明
2)添加業務配置
android:name="BaiduMobAd_STAT_ID"
android:value="a9e2ad84a2" />
android:name="BaiduMobAd_CHANNEL"
android:value="Baidu Market" />
android:name="BaiduMobAd_EXCEPTION_LOG"
android:value="true" />
android:name="BaiduMobAd_SEND_STRATEGY"
android:value="APP_START" />
android:name="BaiduMobAd_ONLY_WIFI"
android:value="false" />
android:name="BaiduMobAd_CELL_LOCATION"
android:value="true" />
android:name="BaiduMobAd_GPS_LOCATION"
android:value="true" />
android:name="BaiduMobAd_WIFI_LOCATION"
android:value="true" />
3、Java代碼配置
開啟自動埋點,調用如下代碼即可:
// 自動埋點,建議在Application中調用。否則可能造成部分頁面遺漏,無法完整統計。
// @param autoTrace:如果設定為true,打開自動埋點;反之關閉
// @param autoTrackWebview:
// 如果設定為true,則自動track所有webview,如果有對webview綁定WebChromeClient,
// 為避免影響APP本身回調,請調用trackWebView接口;
// 如果設定為false,則不自動track webview,如需對特定webview進行統計,需要對特定
// webview調用trackWebView()即可。
StatService.autoTrace(Context context, boolean autoTrace, boolean autoTrackWebview)
webview自動埋點統計,如果有綁定WebChromeClient,調用如下代碼傳入即可:
// 适用于自動埋點版本,用于對webview加載的h5頁面進行自動統計;需要在載入頁面前調用,
// 建議在webview初始化時刻調用
// chromeClient,如果有設定的WebChromeClient,則需要将對象傳入,否則影響本身回調
StatService.trackWebView(Context context, WebView webview, WebChromeClient chromeClient)
支援的統計行為
1、頁面統計
自動埋點按照Activity為粒度進行頁面統計,其自動抓取頁面名字(不含包名)作為頁面的名字。
2、事件統計(僅支援事件次數統計,自動埋點不支援時長統計)
自動埋點需要配合WEB端圈選完成。如果未做圈選,則無法統計到相關事件資料
特殊處理
1、禁止頁面自動統計
如需禁用某個Activity被自動統計到,相應XXXActivity implements IIgnoreAutoTrace 即可
2、事件綁定資料
如果您需要對相關事件綁定業務資料,比如:對"注冊"按鈕綁定相關業務資料,age,city,sex 等
// 設定控件附加屬性,用于無埋點對控件添加資料;控件綁定事件附加屬性依賴于
// view.setTag(key, value)支援,使用key值:-96000;如果view已經綁定過此key值,則此設定不生效
// map中的事件參數,即key值,需要在WEB端配置事件參數,方能生效
StatService.setAttributes(View view, Map attributes)
使用建議
1、如果在頁面埋點處調用了手動埋點的API,那麼SDK會自動放棄對該頁面的自動埋點,采用手動埋點為主
2、如果對統計的資料有較進階的功能需求,或者需要統計更多種類的事件,建議采用手動埋點
3、本SDK同時支援手動和自動埋點,可以根據需求混用
4、手動埋點相關文檔請參考百度移動統計幫助中心 的SDK配置文檔部分