個推數據統計產品（個數）iOS集成實踐

最近業務方給我們部門提了新的需求，希望能一站式統計APP的幾項重要數據。這次我們嘗試使用的是個推（之前專門做消息推送的）旗下新推出的產品“個數·應用統計”，根據官方的說法，個推的數據統計產品通過專業的移動應用數據分析，可以為用戶的應用提供實時數據統計分析服務，包括了解版本質量、渠道狀況、用戶畫像等。數據最后以可視化形式展現，很直觀。我們嘗試了一段時間，發現效果還是很不錯的，這篇文章將為大家介紹如何從零開始快速高效地集成個數iOS SDK。

一、登錄賬號并創建應用獲取 APP ID

1、訪問個推開發者中心，點擊立即注冊：
（也可以從個推官網進入www.getui.com，點擊右上角“開發者中心”。）當然，如果你已經注冊過個推推送的賬號，直接登錄使用即可。

2、根據個人情況填寫并注冊賬號：

3、返回個推開發者中心使用上個步驟注冊好的賬號登錄，進入開發者平臺面板后，選擇左邊菜單欄的個數·應用統計:

4、進入個數·應用統計面板后，選擇右上角的新增應用添加新的應用：

5、填寫應用相關信息，勾選iOS，點擊提交新增應用：

6、新增應用成功會自動返回應用列表，找到新增的應用，點擊應用配置：

7、在配置信息下可以看到APP ID，將其復制保存，后續集成將會使用到APP ID：

二、配置個數SDK

個數iOS SDK提供兩種集成方式，分別是CocoaPods集成和Xcode手動集成，兩種集成方式本文都會介紹。在集成SDK時選擇其中一種即可（推薦使用CocoaPods集成）。

三、CocoaPods集成方式

1、安裝CocoaPods

安裝方式很簡單 , Mac下都自帶ruby，使用ruby的gem命令即可下載安裝：

$ sudo gem install cocoapods
$ pod setup

2、準備Podfile

使用時需要新建一個名為Podfile的文件（若已存在該文件則不需要重新創建），如下格式，將依賴的庫名字依次列在文件中即可：

target 'YourTargetName' do
platform :ios, "8.0"
pod 'GCSDK'
end

3、完成GCSDK導入

將編輯好的Podfile文件放到你的項目根目錄中，執行如下命令即可：

$ cd "<path/to/project>"
$ pod install

4、使用CocosPods集成SDK后，需要關閉原工程，重新在項目根目錄下打開 yourProjectName.xcworkspace的文件進行后續開發：

四、Xcode 集成方式

1、個數應用統計提供了一個 SDK 開發工具包，包含了iOS SDK的全部所需資源，前往個推文檔中心下載，地址：http://docs.getui.com/download.html，選擇個數·應用統計下的iOS端下載SDK資源包 ：

2、解壓資源包內容可以看到如下文件結構：

3、資源包內容詳解

接入文檔/個數集成文檔.pdf : 個數集成文檔;

資源文件/GTCountSDK.h: 個數SDK頭文件

資源文件/libGTCountSDK.a: 個數SDK主包靜態庫

資源文件/libGTCommonSDK.a: 個數SDK工具庫

Demo工程/GTCountDemo/: 個數demo工程

4、注意：libGTCountSDK.a、libGTCommonSDK.a 使用lipo工具將
支持i386、x86_64、arm64、armv7的代碼打包到了一起，所以這個庫將同時支持simulator和device，支持的iOS版本為 7.0 及以上。

5、個數SDK靜態庫設置

右擊添加文件，導入資源文件目錄下的文件。

6、添加依賴庫（必須，如下圖）

添加系統庫支持：

• libsqlit3.tbd
• libz.tbd
• AdSupport.framework

7、設置 Other Linker Flags

找到主工程的target －> Build Setting －> Linking －> Other Linker Flags,將其設置為-ObjC（如圖所示）：

五、初始化并啟動SDK

1、初始化啟動接口的相關信息：

2、在項目工程的AppDelegate.m中添加頭文件，使用前面獲取的APP ID初始化并啟動SDK：

#import 'GTCountSDK.h'
#define kGcAppId @"xxxxxxx"

@implementation AppDelegate

• (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions {
  // 啟動個數 SDK
  [GTCountSDK startSDKWithAppId:kGcAppId withChannelId:@"appstore"];
  // 使用 SDK 實例的 reportStrategy 屬性設置上報策略。
  [[GTCountSDK sharedInstance] setReportStrategy:GESHU_STRATEGY_WIFI_ONLY]
  // 使用 SDK 實例的 sessionTime 屬性獲取 sessionTime 的值。
  NSLog(@"sessionTime %ld",[[GTCountSDK sharedInstance]sessionTime]);
  return YES;
  }

六、高級功能：自定義事件

自定義事件可以統計某些用戶自定義埋點的發生時間以及次數，例如廣告點擊、短信數量等。通常event_id用于表示某種行為或功能的統計（如統計“發送”按鈕被觸發多少次），而參數則用于標識統計的具體對象（如功能為“下載”的按鈕），由event_id和properties唯一標識一個事件。

自定義事件主要分為兩種：

（1）次數統計：統計指定行為被觸發的次數。

（2）時長統計：統計指定行為消耗的時間，單位為秒。需要eventBegin和eventEnd接口成對使用才可生效。

其中每類事件都支持使用properties參數類型。

注意：event_id需要先在個推開發者中心（https://dev.getui.com/）進行配置，才能參與正常的數據統計。event_id不能包含空格或轉義字符，如下：

1、點擊側邊菜單欄事件列表。

2、點擊新增事件按鈕。

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

4、在移動端項目中添加對應事件類型和對應event_id的事件：

@implementation TrackCountEventController

• (IBAction)clickCount:(id)sender {
  [GTCountSDK trackCountEvent:@"countid1" withArgs:@{@"ckey1":@"cvalue1"}];
  }

-(void) viewDidAppear:(BOOL)animated {
// 為了正確統計，要確保開始和結束接口的參數 self.eventProperty 內存地址是一致的。
self.eventProperty = @{@"key":@"value1"};
[GTCountSDK trackCustomKeyValueEventBegin:@"eid1" withArgs:self.eventProperty];
[super viewDidAppear:animated];
}

• (void)viewWillDisappear:(BOOL)animated {
  [GTCountSDK trackCustomKeyValueEventEnd:@"eid1" withArgs:self.eventProperty];
  [super viewWillDisappear:animated];
  }
  @end

七、高級功能：數據上報策略

個數應用統計可自定義數據上報策略，開發者可根據自身應用需求設置，能夠有效控制用戶流量開銷。

1、SDK的數據上報策略包括以下 5 種（默認為 GESHU_STRATEGY_PERIOD，周期為 60 分鐘）：

2、注意：數據上報策略建議在應用啟動時設置。數據上報策略使用以下接口進行設置和查看：

/*
設置上報策略
/
@property(nonatomic,assign)GeShuStatReportStrategyType reportStrategy;

3、WIFI 環境下上報策略

考慮到 WIFI 網絡環境下上報數據的代價較小，因此默認情況在 WIFI 環境下，使用實時上報策略。若要關閉該策略，可以調用以下接口關閉：

/*
智能上報
開啟以后設備接入WIFI會實時上報
否則按照全局策略上報
默認打開
/
@property (nonatomic, assign)BOOL smartReporting;

4、數據上報策略相關接口

/*
統計上報策略為 BATCH 時，觸發上報時最小緩存消息數，默認32條
/
@property (nonatomic, assign)NSUInteger minBatchReportNumber;

/*
上報策略為 PERIOD 時發送間隔，單位分鐘，默認一天（60分鐘）
/
@property (nonatomic, assign)NSUInteger periodMinutes;

八、集成 SDK 的應用提交App Store注意事項

1、為了獲取精準的統計結果，需添加AdSupport.framework庫支持，因此在提交App Store時需做以下操作：

(1)在App內投放廣告，獲取IDFA可通過蘋果審核。

(2)App內無廣告，但先前投放了特定廣告，可參考如下勾選，通過蘋果審核。

勾選如圖：

![](https://s1.51cto.com/images/blog/201807/27/6325bcc339f07bb78366f659af0bee84.png?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_100,g_se,x_10,y_10,shadow_90,type_ZmFuZ3poZW5naGVpdGk=)

以上就是我集成個推應用統計產品（個數）的全過程，希望對你有幫助！如果大家有什么其他問題，我們可以留言區交流。