個推應用統計產品（個數）Android整合實踐

標籤：src   one   rate   follow   int   string   名稱   value   eve   

最近，產品部門向我們提出了統計APP資料的需求，我們測試了幾款產品後選擇了“個數”，它是個推旗下的應用統計產品，總的來說資料快准狠，體驗也不錯。這篇經驗就給大家介紹一下整合的詳細步驟。

一、 登入帳號並建立應用

1. 訪問個推開發人員中心，點擊立即註冊（如果已有帳號了可以直接進入步驟3）：

2. 根據個人情況填寫並註冊帳號：

3. 註冊好了之後就可以登入啦，選擇主介面左邊功能表列的個數·應用統計：

4.進入個數·應用統計面板後，選擇右上方的“新增應用”添加新的應用：

5.填寫應用相關資訊，勾選Android，點擊提交：

6.提交後，頁面自動返回應用列表，我們就能看到剛剛添加的應用了。點擊應用配置：

7.在應用配置介面可以看到APPID，我們可以將其複製儲存下來，它在後續的整合環節會被用到：

二、配置個數SDK

個數Android SDK提供兩種整合方式，分別是maven整合和aar包手動整合（本人推薦使用maven整合，更加簡單方便）。

三、maven整合方式

1．添加maven庫地址

在以項目名命名的頂層 build.gradle 檔案中，添加個推 maven 庫地址，如下所示：

maven{
url ‘http://mvn.gt.igexin.com/nexus/content/repositories/releases‘
}

2.配置依賴

在 app/build.gradle 檔案中引用個數SDK依賴庫，如所示:

dependencies{
compile ‘com.getui:gssdk:2.2.3.0‘
}

四、aar包整合方式

去官網下載SDK文檔

將資源檔中的 GSSDKxxx.aar 以及 GTCxxx.aar 一起複製到 app 模組下的 libs 檔案中，開啟 app/build.gradle ，在 dependencies 中添加相應包的引用 :

dependencies {
implementation files(‘libs/GTC-2.0.0.aar‘)
implementation files(‘libs/GSSDK-2.2.2.0.aar‘)
}

GTC為個推平台的公用程式碼程式庫，如果你已經接入過個推其他包含GTC的產品，則無需再次引入。

五、SDK配置

這一步需要配置混淆。首先需要在混淆檔案中加入如下配置：
-dontwarn com.getui.
-keep class com.getui.{*;}

然後配置個數應用參數：

在 app/build.gradle 檔案中的 android.defaultConfig 下添加 manifestPlaceholders ，配置個數相關的應用參數，如所示：

manifestPlaceholders = [
GS_APPID : "APP_ID",
GT_INSTALL_CHANNEL : "APP_CHANNEL"
]

APP_ID為步驟1中從官方網站擷取到的值，APP_CHANNEL為將要發布的渠道。
APP_CHANNEL也可以通過Gsconfig類中setInstallChannel的方法來設定。需要注意的是，若使用這個方法，需要在SDK初始化之前配置，否則不能生效。

做完了這一步，SDK整合工作就完成啦。

六、SDK初始化

個數SDK的初始化操作非常簡單，只需在Application的onCreate方式中添加如下代碼即可：

GsManager.getInstance().init(Context context);

初始化後SDK產品功能就能正常使用了。新增、日活、留存率、人均訪問時間長度、各個頁面的瀏覽次數……APP資料統計涉及到的各類指標，都能夠通過個數SDK自動統計完成。

七、一些自訂的功能

應用時間長度統計：

應用時間長度統計功能主要用於統計APP的啟動次數和真實活躍時間長度，整合個數SDK 後不需要開發人員調用額外的介面。其中Android平台一次完整的啟動指的是如下兩種情況之一：
（1）從啟動應用到關閉應用。
（2）從啟動應用到應用退至後台，且在後台已耗用時間超過預設值30s。這個預設值支援修改：

void GsConfig.setSessionTimoutMillis(long time);

注意：GsConfig配置類的操作需要在SDK初始化之前完成。

1.自訂事件功能：

自訂事件可以統計某些使用者自訂埋點的發生時間以及次數，例如廣告點選、簡訊數量等。通常 event_id 用於表示某種行為或功能的統計（如統計“發送”按鈕被觸發多少次），而參數properties則用於標識被統計的具體對象（如功能為“下載”的按鈕）。通過event_id 和 properties ，我們可以為一個事件打上唯一標識。
自訂事件主要分為兩種：
（1）次數統計：統計指定行為被觸發的次數。
（2）時間長度統計：統計指定行為消耗的時間，單位為秒。需要 eventBegin 和 eventEnd 介面成對使用才可生效。
其中每類事件都支援使用 properties 參數類型。
注意：event_id 需要先在個數網站上面配置，才能參與正常的資料統計。event_id 不能包含空格或逸出字元，如下：

（1）點擊側邊功能表列事件列表。

（2）點擊新增事件按鈕。

3、根據事件類型分別輸入相應的事件ID以及事件名稱。

目前個數的自訂事件有兩種：

1.次數統計事件

在事件執行開始時調用次數統計方法，SDK會根據事件ID，統計該事件被點擊的次數。

void GsManager.getInstance().onEvent(String eventId, Properties properties)

參數：
eventId :自訂事件ID，用於標識唯一的事件
properties : key-value ，自訂屬性，用於擴充統計需求
key和value都是string類型

使用代碼：

1.事件時間長度統計

在事件開始和結束時調用對應的方法，可以擷取並上傳事件的時間。

void GsManager.getInstance().onBeginEvent(String eventId, Properties properties)

void GsManager.getInstance().onEndEvent(String eventId, Properties properties)

參數：
eventId :自訂事件ID，用於標識唯一的事件
properties : key-value ，自訂屬性，用於擴充統計需求，key和value都是string 類型
使用代碼：

1.資料上傳策略

開發人員可根據自身應用需求，設定不同的資料上報策略，從而有效地控制使用者流量開銷。

（1）個數目前支援的上報策略包括以下5種：

void GsConfig.setUploadStrategyType(GsConfig.GESHU_STRATEGY_REAL_TIME);

目前預設的規則是：在串連WIFI的情況下即時上傳，未串連WIFI則每隔 1 小時上報一次資料。開發人員也可以手動關閉WIFI環境下即時上傳資料的開關。

void GsConfig.setEnableSmartReporting(boolean isEnable);

（2）資料上傳相關的設定介面

1）（僅在發送策略為GESHU_STRATEGY_PERIOD時有效）設定間隔時間（預設為60，單位是分鐘，即 1 小時）

void GsConfig.setUploadPeriodMinutes(int minutes);

2）（僅在發送策略為GESHU_STRATEGY_BATCH時有效）設定最大批量發送訊息的個數（預設值為32）

void GsConfig.setMaxBatchReportCount(int maxCount);

注意：GsConfig配置類需要在SDK初始化之前完成。

以上內容就是本人整合個推應用統計產品（個數）的經驗總結，希望對你有協助！如果大家在整合過程中遇到問題了，可以在個推官網底部找到他們的支援人員，或者在評論區給我留言，大家一起解決，一起進步。

個推應用統計產品（個數）Android整合實踐