用户工具

站点工具


差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

razor:ios-developer-guide [2015/09/15 15:34]
cobub
razor:ios-developer-guide [2017/07/14 11:18]
行 1: 行 1:
-~~Title:IOS 开发者指南 - 开源移动应用运营平台 - 移动统计、移动推送解决方案 - Cobub 移动开发者中心~~ 
-{{description>​Cobub Razor是一个免费开源的移动应用分析系统。用户可以自己建立服务收集移动应用的相关数据,分析并生成统计分析报表。该文章介绍了如何将Cobub Razor的iOS的SDK嵌入到iOS移动应用客户端。}} 
-{{keywords>​Cobub Razor,​开源移动应用分析,​移动分析,​移动应用分析,​开发者指南,​IOS}} 
-v0.7.1 
-====== IOS 开发者指南 ====== 
- 
-Cobub Razor是一个免费开源的移动应用分析系统。用户可以自己建立服务收集移动应用的相关数据,分析并生成统计分析报表。该文章介绍了如何将Cobub Razor的iOS的SDK嵌入到iOS移动应用客户端。 
- 
- 
- 
-====== 1   ​基本设置指南 ====== 
- 
-===== 1.1   ​获取APPkey ===== 
- 
- 
-登陆账号后,到管理后台注册应用,填写ios应用的相关信息。App建立成功后,可获得该App的Appkey以及最新的开发文档和SDK文件。 
- 
-===== 1.2   ​使用ios SDK ===== 
- 
- 
-==== 1.2.1   ​下载SDK ==== 
- 
- 
-下载SDK压缩包并将其解压缩。解压缩之后,可以看到两个文件,UMSAgent.h 和 libUMSAgent.a 
- 
-==== 1.2.2   ​导入SDK ==== 
- 
- 
-在项目工程目录中,选择Add->​Existing files.. 选择上面解压缩后的两个文件。或者直接将两个文件拖拽至目录结构中,选择Copy Items into destination group’s folder(if needed). 
- 
-{{:​razor:​20150318-024630.png}} 
- 
-==== 1.2.3   ​添加依赖框架 ==== 
- 
- 
-为了获取网络信息,获取运营商标识,您需要添加CoreTelephony类库。 ​ 
- 
-{{:​razor:​20150318-024709.png}} 
-==== 1.2.4   ​设置Other Linker Flags ==== 
- 
- 
-添加 –all_load和-ObjC标记 
- 
-{{:​razor:​20150318-024739.png}} 
-==== 1.2.5   ​嵌入代码 ==== 
- 
- 
-在AppDelegate.h中添加,#​import “UMSAgent.h”。在AppDelegate.m中的didFinishLaunchingWithOptions函数添加如下函数调用: 
-<​code>​ 
-[UMSAgent startWithAppKey:​@"​14aaa92e098df46cb63ed5196e0c331c"​ ReportPolicy:​BATCH ServerURL:@ 
-"YOUR SDK SERVICE URL"]; 
--(BOOL)application:​(UIApplication *)application didFinishLaunchingWithOptions:​(NSDictionary *) 
-launchOptions 
-{ 
-[UMSAgent startWith]AppKey:​@"​UMSAgentKey"​ ReportPolicy:​BATCH];​ 
-} 
-</​code>​ 
-其中UMSAgentKey是从网站注册应用时获取到的AgentKey。 
- 
-ServiceURL 为服务器SDK Service接口地址。 
- 
-其中BATCH模式为系统下次启动时一次性上传数据。 
- 
-如果希望改为实时上传模式,请将BATCH改为REALTIME 
- 
-建议采用BATCH模式,减少APP与网络交互,节约流量,增强用户体验。 
-**使用时长统计** 
- 
-平台将每次APP进入前台和进入后台之间的间隔作为一次生命周期过程。平台会将每次生命周期作为数据提交到后台,为开发者提供相应的统计分析报告。 
- 
-==== 1.2.6   ​使用自定义事件 ==== 
- 
- 
-自定义的事件用来为开发者提供更为详细的用户行为统计分析。使用前请在后台提前添加指定的事件,并获得事件的Event_identifier后,后台才能进行相应的处理工作,否则后台对客户端未注册事件不进行处理。 
- 
-=== 1.2.6.1 ​    ​简单事件 === 
- 
-<​code>​ 
-+(void)postEvent:​(NSString *)event_id;</​code>​ 
-event_id: 当前事件的ID值,在服务端定义的,ID值不能有空格。在您需要发送事件报告的代码段,调用如下方法就可以向服务器发送事件记录,将统计event_id对应事件发送次数,变化趋势,例如广告点击,短信发送量等等。 
- 
-比如,监测应用程序里的广告的点击次数,事件ID为”ad_click “。那么需要在程序里每次广告点击时调用postEvent:​@ “ad_click “通知服务器一个广告点击事件发生 
- 
-=== 1.2.6.2 ​    ​多标签事件 === 
- 
-<​code>​ 
-+(void)postEvent:​(NSString *)event_id label:​(NSString *)label;</​code>​ 
-这是postEvent:(NSString *) event_id一个重载的方法。 
- 
-除了能够统计event_id所对应事件的发生次数,变化趋势外,还能统计事件中具体标签所占的比例,label为当前标签,同样这里的event_id字符串中也不能有空格。例如:在应用程序中省份对应一个event_id,​每个城市对应一个label,这样我们可以在生成的统计分析表中看到不同城市的比例。 
- 
-=== 1.2.6.3 ​    ​累计事件 === 
- 
-<​code>​ 
-+(void)postEvent:​(NSString *)event_id acc:​(NSInteger)acc;</​code>​ 
-对于程序中的某些可能被频繁触发的事件,开发者可以再程序中维护一个计数器,这样事件被多次触发只需要生成一个消息,这个消息包括该事件被触发的次数。 
- 
-这里我们重载了两个接口(累计事件): 
-<​code>​ 
-+(void)postEvent:​(NSString *)event_id acc:​(NSInteger)acc;​ 
-+(void)postEvnet:​(NSString *)event_id label:​(NSString *)label acc:​(NSInteger)acc;</​code>​ 
-==== 2.2.7   ​自动更新 ==== 
- 
- 
-[UMSAgent checkUpdate];​ 
-调用该方法系统会自动检测是否有更高版本的应用。如果有新的版本会提示用户更新,如果用户选择更新应用,系统会自动为用户更新应用;不选择就不更新,​ 
- 
-对应不同渠道的每个App,​ Cobub Razor后台提供了唯一的key。在为不同的渠道提供更新时,注意更为不同的key。 
- 
-==== 1.2.8   ​使用在线参数配置 ==== 
- 
-<​code>​ 
-[IMSAgent setOnLineConfig:​false];</​code>​ 
-在AppDelegate.m中的didFinishLaunchingWithOptions函数添加如下函数调用该API,如果选择true,​用户在服务器端设置了参数值后,SDK将联网检测您的在线配置,并将这些信息保存在本地。如果选择false, 将不检测。 
- 
-==== 1.2.9  记录页面访问 ==== 
- 
- 
-+(void)startTracPage:​(NSString*)page_name;​ 
-在页面的viewWillAppear()方法调用该方法,该方法会记录下用户进入页面的时间。如下图: 
-<​code>​ 
--(void) viewWillAppear(BOOL)animated 
-{ 
- [UMSAgent startTracPage:​@"​Main"​];​ 
-} 
-+(void)endTracPage:​(NSString*)page_name;​ 
-</​code>​ 
-在页面的viewWillDisappear()方法中调用该方法,该方法会记录下用户离开页面的时间。 
- 
-如下图: 
-<​code>​ 
--(void) viewWillDisappear:​(BOOL)animation { 
-    [UMSAgent endTracPage:​@"​Main"​];​ 
-} 
-</​code>​ 
-注:以上两个方法需要成对调用。 
- 
-==== 1.2.10 绑定用户 ==== 
- 
- 
-调用该方法可以将用户的id与app进行绑定。 
-<​code>​ 
-[UMSAgetnt bindUserIdentifier:​@"​userid"​];</​code>​ 
-==== 1.2.11 绑定Tags ==== 
- 
-<​code>​ 
-[UMSAgetnt postTag:​@"​tag"​];</​code>​ 
-用户可以自定义设置tag信息,并发送至后台。用作以后的用户分组(暂未实现)。 
  
razor/ios-developer-guide.txt · 最后更改: 2017/07/14 11:18 (外部编辑)