- 前段時間，咱們公司的產品又雙叒叕給咱們提了新需求，要求咱們把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初始化以前完成。
- 以上內容就是本人集成個推應用統計產品（個數）的經驗總結，但願對你有幫助！若是你們在集成過程當中遇到問題了，能夠在個推官網底部找到他們的技術支持，或者在評論區給我留言，你們一塊兒解決，一塊兒進步。