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

前段時間，咱們公司的產品又雙叒叕給咱們提了新需求，要求咱們把APP相關的數據統計分析一下，這些指標包括但不限於應用每日的新增、活躍、留存率等等，最好天天都能提供數據報表。這種事情真是想一想就麻煩，你們最後仍是決定交給專業的團隊來解決。咱們一直在用個推推送，相比於其餘第三方推送，個推的到達率比較高，恰好他們旗下有一款叫「個數·應用統計」的產品，很是符合咱們的需求。通過一段時間的體驗，咱們發現個數效果仍是很不錯的，集成操做簡單方便，數據快準狠。好東西固然要拿出來分享出來了，下面就手把手教你們快速集成個數Android SDK。

 

• 1、 登陸帳號並建立應用

 

• 1. 訪問個推開發者中心，點擊當即註冊（若是已有帳號了能夠直接進入步驟3）：

 

•  

 

• 2. 根據我的狀況填寫並註冊帳號：

 

•  

 

• 3. 註冊好了以後就能夠登陸啦，選擇主界面左邊菜單欄的個數·應用統計：

 

•  

 

• 4.進入個數·應用統計面板後，選擇右上角的「新增應用」添加新的應用：

 

 

• 5.填寫應用相關信息，勾選Android，點擊提交：

 

•  

 

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

 

 

• 7.在應用配置界面能夠看到APPID，咱們能夠將其複製保存下來，它在後續的集成環節會被用到：

 

 

• 2、配置個數SDK

 

• 個數Android SDK提供兩種集成方式，分別是maven集成和aar包手動集成（本人推薦使用maven集成，更加簡單方便）。
•  
• 3、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'
• }
•  
• 4、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的產品，則無需再次引入。
• 5、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集成工做就完成啦。

 

• 6、SDK初始化

 

• 個數SDK的初始化操做很是簡單，只需在Application的onCreate方式中添加以下代碼便可：

 

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

 

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

 

• 7、一些自定義的功能

 

• 應用時長統計：

 

• 應用時長統計功能主要用於統計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）點擊新增事件按鈕。

 

 

• 三、根據事件類型分別輸入相應的事件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初始化以前完成。

 

• 以上內容就是本人集成個推應用統計產品（個數）的經驗總結，但願對你有幫助！若是你們在集成過程當中遇到問題了，能夠在個推官網底部找到他們的技術支持，或者在評論區給我留言，你們一塊兒解決，一塊兒進步。