個推應用統計產品（個數）Android集成實踐

前段時候，我們公司的產物又雙叒叕給我們提了新需求，要求我們把APP相關的數據統計闡發一下，這些指標包羅但不限于應用每日的新增、活躍、留存率等等，最好天天都能供給數據報表。這種工作真是想想就麻煩，大師最后仍是決議交給專業的團隊來解決。我們一向在用個推推送，比擬于其他第三方推送，個推的達到率比力高，剛好他們旗下有一條目叫“個數·應用統計”的產物，很是合適我們的需求。顛末一段時候的體驗，我們發現個數結果仍是很不錯的，集當作操作簡單便利，數據快準狠。好工具當然要拿出來分享出來了，下面就手把手教大師快速集當作個數Android SDK。

東西/原料

-個推開辟者平臺賬號
-Android Studio

一、登錄賬號并建立應用

1
拜候個推開辟者中間，點擊當即注冊（若是已有賬號了可以直接進入步調3）：
2
按照小我環境填寫并注冊賬號：
3
注冊好了之后就可以登錄啦，選擇本家兒界面左邊菜單欄的個數·應用統計：
4
進入個數·應用統計面板后，選擇右上角的“新增應用”添加新的應用：
5
填寫應用相關信息，勾選Android，點擊提交：
6
提交后，頁面主動返回應用列表，我們就能看到方才添加的應用了。點擊應用設置裝備擺設：
7
在應用設置裝備擺設界面可以看到APPID，我們可以將其復制保留下來，它在后續的集當作環節會被用到：

二、設置裝備擺設個數SDK

1
個數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包集當作體例

1
去官網下載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設置裝備擺設

1
這一步需要設置裝備擺設混合。起首需要在混合文件中插手如下設置裝備擺設：

-dontwarn com.getui.**
-keep class com.getui.**{*;}

然后設置裝備擺設個數應用參數：

在 app/build.gradle 文件中的 android.defaultConfig 下添加 manifestPlaceholders ，設置裝備擺設個數相關的應用參數，如下圖所示：
manifestPlaceholders = [
GS_APPID : "APP_ID",
GT_INSTALL_CHANNEL : "APP_CHANNEL"
]
2
APP_ID為步調1中從官方網站獲取到的值，APP_CHANNEL為將要發布的渠道。
APP_CHANNEL也可以經由過程Gsconfig類中setInstallChannel的方式來設置。需要注重的是，若利用這個方式，需要在SDK初始化之前設置裝備擺設，不然不克不及生效。

做完了這一步，SDK集當作工作就完當作啦。

六、SDK初始化

1
個數SDK的初始化操作很是簡單，只需在Application的onCreate體例中添加如下代碼即可：

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

初始化后SDK產物功能就能正常利用了。新增、日活、留存率、人均拜候時長、各個頁面的瀏覽次數……APP數據統計涉及到的各類指標，都可以或許經由過程個數SDK主動統計完當作。

七、一些自界說的功能

1
1. 應用時長統計：

應用時長統計功能本家兒要用于統計APP的啟動次數和真實活躍時長，集當作個數SDK 后不需要開辟者挪用額外的接口。此中Android平臺一次完整的啟動指的是如下兩種環境之一：
（1）從啟動應用到封閉應用。
（2）從啟動應用到應用退至后臺，且在后臺運行時候跨越默認值30s。這個默認值撐持點竄：

void GsConfig.setSessionTimoutMillis(long time);

注重：GsConfig設置裝備擺設類的操作需要在SDK初始化之前完當作。
2.自界說事務功能：

自界說事務可以統計某些用戶自界說埋點的發生時候以及次數，例如告白點擊、短信數目等。凡是 event_id 用于暗示某種行為或功能的統計（如統計“發送”按鈕被觸發幾多次），而參數properties則用于標識被統計的具體對象（如功能為“下載”的按鈕）。經由過程event_id 和 properties ，我們可覺得一個事務打上獨一標識。
自界說事務本家兒要分為兩種：
（1）次數統計：統計指心猿意馬行為被觸發的次數。
（2）時長統計：統計指心猿意馬行為耗損的時候，單元為秒。需要 eventBegin 和 eventEnd 接口當作對利用才可生效。
此中每類事務都撐持利用 properties 參數類型。
注重：event_id 需要先在個數網站上面設置裝備擺設，才能介入正常的數據統計。event_id 不克不及包含空格或轉義字符，如下：
2

（1）點擊側邊菜單欄事務列表。
3
（2）點擊新增事務按鈕。
4
按照事務類型別離輸入響應的事務ID以及事務名稱。
5
今朝個數的自界說事務有兩種：

1. 次數統計事務

在事務執行起頭時挪用次數統計方式，SDK會按照事務ID，統計該事務被點擊的次數。

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

參數：
· eventId :自界說事務ID，用于標識獨一的事務
· properties : key-value ，自界說屬性，用于擴展統計需求
· key和value都是string類型

利用代碼：
6
2.事務時長統計

在事務起頭和竣事時挪用對應的方式，可以獲取并上傳事務的時候。

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

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

參數：
· eventId :自界說事務ID，用于標識獨一的事務
· properties : key-value ，自界說屬性，用于擴展統計需求，key和value都是string 類型
利用代碼：
7
3.數據上傳策略

開辟者可按照自身應用需求，設置分歧的數據上報策略，從而有用地節制用戶流量開銷。
8
個數量前撐持的上報策略包羅以下5種：

void GsConfig.setUploadStrategyType(GsConfig.GESHU_STRATEGY_REAL_TIME);
今朝默認的法則是：在毗連WIFI的環境下及時上傳，未毗連WIFI則每隔 1 小時上報一次數據。開辟者也可以手動封閉WIFI情況下及時上傳數據的開關。

void GsConfig.setEnableSmartReporting(boolean isEnable);
9
數據上傳相關的設置接口

1）（僅在發送策略為GESHU_STRATEGY_PERIOD時有用）設置距離時候（默認為60，單元是分鐘，即 1 小時）

void GsConfig.setUploadPeriodMinutes(int minutes);

2）（僅在發送策略為GESHU_STRATEGY_BATCH時有用）設置最多量量發送動靜的個數（默認值為32）

void GsConfig.setMaxBatchReportCount(int maxCount);

注重：GsConfig設置裝備擺設類需要在SDK初始化之前完當作。

以上內容就是本人集當作個推應用統計產物（個數）的經驗總結，但愿對你有幫忙！若是大師在集當作過程中碰到問題了，可以在個推官網底部找到他們的手藝撐持，或者在評論區給我留言，大師一路解決，一路前進。