1. 程式人生 > >個推應用統計產品(個數)Android集成實踐

個推應用統計產品(個數)Android集成實踐

按鈕 官方網站 color 返回 註冊 3.0 控制 分享 ica

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

一、 登錄賬號並創建應用

  1. 訪問個推開發者中心,點擊立即註冊(如果已有賬號了可以直接進入步驟3):

技術分享圖片

  1. 根據個人情況填寫並註冊賬號:

技術分享圖片

  1. 註冊好了之後就可以登錄啦,選擇主界面左邊菜單欄的個數·應用統計:

技術分享圖片

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集成實踐