天天看點

百度android sdk聚合,SDK接入 · 百度移動統計Android SDK使用手冊

可視化圈選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工程配置

百度android sdk聚合,SDK接入 · 百度移動統計Android SDK使用手冊

添加完成後,配置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配置文檔部分