最近业务方给我们部门提了新的需求,樊咒及儆希望能一站式统计APP的几项重要数据。这次我们尝试使用的是个推(之前专门做消息推送的)旗下新推出的产品“个数·应用统计”芟坳葩津,根据官方的说法,个推的数据统计产品通过专业的移动应用数据分析,可以为用户的应用提供实时数据统计分析服务,包括了解版本质量、渠道状况、用户画像等。数据最后以可视化形式展现,很直观。我们尝试了一段时间,发现效果还是很不错的,这篇文章将为大家介绍如何从零开始快速高效地集成个数iOSSDK。
工具/原料
个推开发者平台账号
个数iOSSDK
Xcode(不同版本在配置时有点不同)及项目工程
登录账号并创建应用获取APPID
1、访问[个推开发者中心],点击立即注册:点击右上角“开发者中心”。当然,如果你已经注册过个推推送的账号,直接登录使用即可。
2、根据个人情况填写并注册账号:
3、返回[个推开发者中心使用上个步骤注册好的账号登录,进入开发者平台面板后,选择左边菜单栏的个数·应用统计:
4、进入个数·应用统计面板后,选择右上角的新增应用添加新的应用:
5、填写应用相关信息,勾选iOS,点击提交新增应用:
6、新增应用成功会自动返回应用列表,找到新增的应用,点击应用配置:
7、在配置信息下可以看到APPID,将其复制保存,后续集成将会使用到APPID:
配置个数SDK
1、个数iOSSDK提供两种集成方式,分别是CocoaPods集成和Xcode手动集成,两种集成方式本文都会介绍。在集成SDK时选择其中一种即可(推荐使用CocoaPods集成)。
CocoaPods集成方式
1、安装CocoaPods安装方式很简单,Mac下都自带ruby,使用ruby的gem命令即可下载安装:$sudogeminstallcocoapods$podsetup
2、准备Podfi盟敢势袂le使用时需要新建一个名为Podfile的文件(若已存在该文件则不需要重新创建),如下格式,将依赖的库名字依关骇脘骱次列在文件中即可:target'YourTargetName'doplatform:ios,"8.0"pod'GCSDK'end
3、完成GCSDK导入将编辑好的Podfile文件放到你的项目根目录中,执行如下命令即可:$cd"<path/to/project>"$podinstall
4、使用CocosPods集成SDK后,需要关闭原工程,重新在项目根目录下打开yourProjectName.xcworkspace的文件进行后续开发:
Xcode集成方式
1、个数应用统计提供了一个SDK开发工具包,包含了iOSSDK的全部所需资源,前往个推文档中心下载,选择个数·应用统计下的iOS端下载SDK资源包:
2、解压资源包内容可以看到如下文件结构:
3、资源包内容详解接入文档/个数集成文档.pdf:个数集成文档;资源文件/GTCountSDK.h:个数SDK头文件资源文件/libGTCountSDK.a:个数SDK主包静态库资源文件/libGTCommonSDK.a:个数SDK工具库Demo工程/GTCountDemo/:个数demo工程
4、注意:libGTCountSDK.a、libGTCommonSDK.a使用lipo工具将支持i38x86_6arm6armv7的代码打包到了一起,所以这个库将同时支持simulator和device,支持的iOS版本为7.0及以上。
5、个数SDK静态库设置右击添加文件,导入资源文件目录下的文件。
6、添加依赖库(必须,如下图)添加系统库支持:*libsqlit3.tbd*libz.tbd*AdSupport.framework
7、设置OtherLinkerFlags找到主工程的target->BuildSetting->Linking->OtherLinkerFlags,将其设置为-ObjC(如图所示):
初始化并启动SDK
1、初始化启动接口的相关信息:
2、在项目工程的AppDelegate.m中添加头文件,使用前面获取的APPID初始斟闽擞呦化并启动SDK:#impor墉掠载牿t'GTCountSDK.h'#definekGcAppId@"xxxxxxx"@implementationAppDelegate-(BOOL)application:(UIApplication*)applicationdidFinishLaunchingWithOptions:(NSDictionary*)launchOptions{//启动个数SDK[GTCountSDKstartSDKWithAppId:kGcAppIdwithChannelId:@"appstore"];//使用SDK实例的reportStrategy属性设置上报策略。[[GTCountSDKsharedInstance]setReportStrategy:GESHU_STRATEGY_WIFI_ONLY]//使用SDK实例的sessionTime属性获取sessionTime的值。NSLog(@"sessionTime%ld",[[GTCountSDKsharedInstance]sessionTime]);returnYES;}
高级功能:自定义事件
1、自定义事件可以统计某些用户自定义埋点的发生时间以及次数,例如广告点击、短信数量等。通常娣定撰钠event_id用于表姨胀兽辱示某种行为或功能的统计(如统计“发送”按钮被触发多少次),而参数则用于标识统计的具体对象(如功能为“下载”的按钮),由event_id和properties唯一标识一个事件。自定义事件主要分为两种:(1)次数统计:统计指定行为被触发的次数。(2)时长统计:统计指定行为消耗的时间,单位为秒。需要eventBegin和eventEnd接口成对使用才可生效。其中每类事件都支持使用properties参数类型。注意:event_id需要先在个推开发者中心进行配置,才能参与正常的数据统计。event_id不能包含空格或转义字符,如下:
2、点击侧边菜单栏事件列表。
3、点击新增事件按钮。
4、根据事件类型分别输入相应的事件ID以及事件名称。在移动端项目中添加对应事件类型和对应娣定撰钠event_id的事件:刺胳挤萧@implementationTrackCountEventController-(IBAction)clickCount:(id)sender{[GTCountSDKtrackCountEvent:@"countid1"withArgs:@{@"ckey1":@"cvalue1"}];}-(void)viewDidAppear:(BOOL)animated{//为了正确统计,要确保开始和结束接口的参数self.eventProperty内存地址是一致的。self.eventProperty=@{@"key":@"value1"};[GTCountSDKtrackCustomKeyValueEventBegin:@"eid1"withArgs:self.eventProperty];[superviewDidAppear:animated];}-(void)viewWillDisappear:(BOOL)animated{[GTCountSDKtrackCustomKeyValueEventEnd:@"eid1"withArgs:self.eventProperty];[superviewWillDisappear:animated];}@end
高级功能:数据上报策略
1、个数应用统计可自定义数据上报策略,开发者可根据自身应用需求设置,能够有效控制用户流量开销。SDK的数据上报策略包括以下5种(默认为GESHU_STRATEGY_PERIOD,周期为60分钟):
2、注意:数据上报策略建议在应用启动时设置。数据上报策略使用以下接口进行设置和查看:/**设置上报策略*/@property(nonatomic,assign)GeShuStatReportStrategyTypereportStrategy;
3、WIFI环境下上报策略考虑到WIFI网络环境下上报数据的代价较小,因此默认续异收俱情况在WIFI环境下,使吹涡皋陕用实时上报策略。若要关闭该策略,可以调用以下接口关闭:/**智能上报开启以后设备接入WIFI会实时上报否则按照全局策略上报默认打开*/@property(nonatomic,assign)BOOLsmartReporting;
4、数倌栗受绽据上报策略相关接口/**统计上报策略为BATCH时,触发上报时最小缓存消息数,默认32条*/@property(non锾攒揉敫atomic,assign)NSUIntegerminBatchReportNumber;/**上报策略为PERIOD时发送间隔,单位分钟,默认一天(60分钟)*/@property(nonatomic,assign)NSUIntegerperiodMinutes;
集成SDK的应用提交AppStore注意事项
1、为了获取精准的统计结果,需添加AdSupport.framework库支持,因此在提交AppStore时需做以下操作:(1)在App内投放广告,获取IDFA可通过苹果审核。(2)App内无广告,但先前投放了特定广告,可参考如下勾选,通过苹果审核。勾选如图:
2、以上就是我集成个推应用统计产品(个数)的全过程,希望对你有帮助!如果大家有什么其他问题,我们可以留言区交流。