百度移動統(tǒng)計SDK

一、簡介

百度移動統(tǒng)計SDK(Android)是百度官方推出的移動統(tǒng)計SDK在Android平臺上的版本(以下簡稱SDK)。SDK的發(fā)行版本(完整下載包為android.zip)中包括JAR包、文檔、示例以及您正在閱讀的用戶手冊。 以下使用代表android.zip解壓后的根目錄。

JAR包：/android_api.jar，開發(fā)過程中導(dǎo)入Android項目；

文檔：/android_doc，提供開發(fā)幫助信息；

示例：/android_demo，統(tǒng)計示例程序代碼，幫助您迅速熟悉SDK的使用方式；

用戶手冊：本文檔。

二、閱讀對象

本文檔面向所有使用該SDK的開發(fā)人員、測試人員、合作伙伴以及對此感興趣的其他用戶。

三、運行環(huán)境

可運行于Android 1.5(API Level 3)及以上版本。

四、開發(fā)指南

(注：以下提及的各個文件均可在/android_demo中找到。)

1.申請應(yīng)用AppKey

AppKey(BaiduMobAd_STAT_ID)在百度移動統(tǒng)計申請，用于標識您的應(yīng)用程序。

2.申請自定義事件

為確保您在后續(xù)代碼中添加的自定義事件能夠出現(xiàn)在我們的統(tǒng)計結(jié)果中，請在百度移動統(tǒng)計平臺申請自定義事件。

3.導(dǎo)入JAR包

將SDK中的JAR包導(dǎo)入您創(chuàng)建的Android項目，以下假設(shè)您已經(jīng)創(chuàng)建了項目A。

右鍵點擊你的工程，然后選擇“Properties”；

在工程屬性對話框左邊選擇“Java Build Path”；

在工程屬性對話框主窗口選擇“Libraries”；

點擊“Add JARs”，添加/android_api.jar。

注：示例(/android_demo)中已經(jīng)引入了該jar，位于/android_demo/lib/Baidu_Mobstat_Android_SDK.jar；如果您安裝的ADT版本大于16，請重命名lib為libs，并重新引入jar。

4.文檔使用

若是在eclipse或其他IDE下開發(fā)，可設(shè)置JAR包的Javadoc路徑為/doc，便于在IDE中獲得即時的開發(fā)幫助信息；

也可以直接在瀏覽器中打開/doc/index.html查看該文檔。

5.配置AndroidManifest.xml

android:versionCode="1" android:versionName="1.0">

圖1 AndroidManifest.xml

具體的信息參見圖1。

注釋中標示了需要配置的信息：

申明App版本信息，有助于為App進行版本統(tǒng)計(android:versionCode和android:versionName)

添加必要的權(quán)限

必須權(quán)限：您必須申明的權(quán)限

可選權(quán)限：您可根據(jù)實際需求設(shè)置

meta-data：

BaiduMobAd_STAT_ID需要在百度移動統(tǒng)計申請，是標識應(yīng)用的唯一信息，如此處為“abcd1234”；

BaiduMobAd_CHANNEL為應(yīng)用程序的分發(fā)渠道，如此處為"Baidu Market"，請根據(jù)需要替換。

BaiduMobAd_EXCEPTION_LOG 為是否開啟錯誤日志統(tǒng)計，默認為false。設(shè)置為true時，其作用等同于調(diào)用接口StatService.setOn(StatService. EXCEPTION_LOG)。推薦使用此配置來替代setOn接口。

BaiduMobAd_SEND_STRATEGY 為日志發(fā)送策略，可選值：APP_START、 ONCE_A_DAY、 SET_TIME_INTERVAL，默認為APP_START。此flag以及下面兩個flag的作用等同于調(diào)用StatService. setSendLogStrategy接口，推薦使用此配置。

BaiduMobAd_TIME_INTERVAL 當(dāng)日志發(fā)送策略為SET_TIME_INTERVAL時，需設(shè)定時間間隔。取值為1-24的整數(shù)，默認為1。

BaiduMobAd_ONLY_WIFI 為日志僅在wifi網(wǎng)絡(luò)下發(fā)送的flag，默認為false。

五、功能和接口

百度移動統(tǒng)計提供了基本統(tǒng)計、渠道統(tǒng)計、版本統(tǒng)計、錯誤統(tǒng)計、自定義事件統(tǒng)計的功能，需要開發(fā)者顯示調(diào)用的接口有以下幾條：

1.基本統(tǒng)計接口

SDK提供兩種調(diào)用基本統(tǒng)計接口的方法：

1.嵌入API的方式，開發(fā)者需要在每個Activity的onResume()和onPause()中調(diào)用SDK提供的StatService.onResume(Context context)和StatService.onPause (Context context)；

2.第二種方法是直接繼承SDK提供的StatActivity類。StatActivity封裝了StatService.onResume(context)和StatService.onPause(context)方法，方便開發(fā)者統(tǒng)計頁面信息。

下面主要介紹第一種方式的2個API：

void onResume(Context context)

1.嵌入位置：每個Activity的onResume()回調(diào)方法內(nèi)。

2.功能：基本統(tǒng)計，統(tǒng)計一次頁面訪問的開始。

3.參數(shù)：Context頁面的設(shè)備上下文。

void onPause (Context context)

1.嵌入位置：每個Activity的onPause()回調(diào)方法內(nèi)。

2.功能：基本統(tǒng)計，統(tǒng)計一次頁面訪問的結(jié)束。

3.參數(shù)：Context頁面的設(shè)備上下文。

2.開關(guān)型功能接口—出錯分析

void setOn(Context context， int flag)

1.嵌入位置：啟動Activity的OnCreate()回調(diào)方法內(nèi)。

2.功能：開關(guān)類型的API，功能是否被啟用，通過參數(shù)flag控制。目前，提供了錯誤分析的功能，后續(xù)版本的SDK會支持更多的功能。

3.參數(shù)：

a)context：啟動頁面的設(shè)備上下文

b)flag：二進制表示的每一位表示一個功能開關(guān)，通過或運算實現(xiàn)開啟多個功能，現(xiàn)在flag可選的參數(shù)有：StatService.EXCEPTION_LOG 出錯分析開關(guān)位

3.自定義事件接口(1)

注：自定義事件需要在百度移動統(tǒng)計的設(shè)置中的自定義事件管理中添加對應(yīng)的事件ID。

void onEvent(Context context, String event_id, String label)

1.嵌入位置：任何地方。

2.功能：統(tǒng)計開發(fā)者的自定義事件，自增計數(shù)。

3.參數(shù)：context設(shè)備上下文

event_id業(yè)務(wù)端注冊的事件id

label事件添加的標簽

4.自定義事件接口(2)

void onEvent(Context context, String event_id, String label, int acc)

1.嵌入位置：任何地方。

2.功能：統(tǒng)計開發(fā)者的自定義事件。

3.參數(shù)：context設(shè)備上下文

event_id業(yè)務(wù)端注冊的事件id

label事件添加的標簽

aac事件的發(fā)生次數(shù)

5.日志發(fā)送策略接口(1)

void setSendLogStrategy(Context context,SendStrategyEnum sst,int rtime_interval,boolean only_wifi)

1.嵌入位置: 最好在Activity.onCreate函數(shù)中。

2. 功能：設(shè)置日志發(fā)送策略。

3. 參數(shù)：

context調(diào)用頁面的設(shè)備上下。

sst為枚舉類型SendStrategyEnum。可取值

SendStrategyEnum.APP_START(啟動時發(fā)送)，

SendStrategyEnum.ONCE_A_DAY (每日發(fā)送)

SendStrategyEnum.SET_TIME_INTERVAL(設(shè)定發(fā)送時間)

rtime_interval 當(dāng)參數(shù)sst為SET_TIME_INTERVAL時，此值有效。為1-24之間的整數(shù),即1<=rtime_interval<=24

only_wifi若為true，則僅在wifi網(wǎng)絡(luò)下發(fā)送;默認為false;

6.日志發(fā)送策略接口(2)

void setSendLogStrategy(Context context,SendStrategyEnum sst,int rtime_interval)

1.嵌入位置: 最好在Activity.onCreate函數(shù)中。

2. 功能：設(shè)置日志發(fā)送策略。

3. 參數(shù)：

context調(diào)用頁面的設(shè)備上下文

sst為枚舉類型SendStrategyEnum。可取值

SendStrategyEnum.APP_START(啟動時發(fā)送)，

SendStrategyEnum.ONCE_A_DAY (每日發(fā)送)

SendStrategyEnum.SET_TIME_INTERVAL(設(shè)定發(fā)送時間)

rtime_interval 當(dāng)參數(shù)sst為SET_TIME_INTERVAL時，此值有效。為1-24之間的整數(shù),即1<=rtime_interval<=24

六、示例

Demo工程已經(jīng)嵌入了SDK提供的所有功能接口，開發(fā)者只需將APPSID更換成自己申請的ID，然后運行，在網(wǎng)絡(luò)暢通的情況下，統(tǒng)計數(shù)據(jù)就會被發(fā)送到業(yè)務(wù)端(http://mtj.baidu.com) ，開發(fā)者可以查看相應(yīng)報表。

七、聯(lián)系我們

感謝您的閱讀,如果有問題請email我們。

郵箱: apptongji@baidu.com

總結(jié)

以上是生活随笔為你收集整理的百度云api android,帮助文档首页/百度移动统计API/百度移动统计 Android版SDK - 百度开放云平台...的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。