1.使用自定义事件
使用自定义事件功能请先在网站应用管理后台(设置->编辑自定义事件)中添加相应的自定义事件后,服务器才会对相应的自定义事件请求进行处理。这里我们将提供几个简单而通用的接口:
1.1. 事件数量统计
- 在您希望跟踪的代码部分,调用如下方法:
[MobClick event:(NSString *)eventId];
eventId
为当前统计的事件ID。示例:统计微博应用中"转发"事件发生的次数,那么在转发的函数里调用
[MobClick event:@"Forward"];
- 考虑事件在一个属性上的取值,可以调用如下方法:
[MobClick event:(NSString *)eventId attributes:(NSDictionary *)attributes];
attributes为当前事件的属性和取值(键值对)。
示例:统计电商应用中“购买”事件发生的次数,以及购买的商品类型及数量,那么在购买的函数里调用:
NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys: @"book", @"type", @"3", @"quantity", nil]; [MobClick event:@"purchase" attributes:dict];
- 有时,只需考虑事件在一个属性上的取值,可以调用如下方法:
[MobClick event:(NSString *)eventId label:(NSString *)label];
label
为当前事件的取值。示例: 统计游戏中“死亡”事件发生的关卡数,那么可以在死亡的函数里调用
[MobClick event:@"player_dead" label:@"level"];
1.2. 事件时长统计
有的事件是持续发生的,需要记录其持续的时间,这里提供了两种解决方法。
在事件开始和结束时调用[MobClick beginEvent:]
和[MobClick endEvent:]
两个函数
示例: 跟踪播放音乐事件发生的总时间,那么在音乐播放开始时调用:
[MobClick beginEvent:@"music_play"];
在音乐播放结束时调用:
[MobClick endEvent:@"music_play"];
- 跟踪时长的事件包含多个属性
[MobClick beginEvent:(NSString *)eventId primarykey:(NSString *)keyName attributes:(NSDictionary *)attributes];
[MobClick endEvent:(NSString *)eventId primarykey:(NSString *)keyName];
primarykey
这个参数用于和eventId
一起标示一个唯一事件,并不会被统计;
对于同一个事件在beginEvent
和endEvent
中要传递相同的eventId
和 primarykey
(为什么要增加primarykey
,请看时长统计常见错误案例)
示例: 跟踪每种类型的音乐播放了多久,那么在音乐播放开始时调用
NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys: @"popular", @"type", @"JJLin", @"artist",@"registered",@"User_status", nil]; [MobClick beginEvent:@"music" primarykey:@"m7" attributes:dict];
在音乐播放结束时调用:
[MobClick endEvent:@"music" primarykey:@"m7"];
- 自己计算并上传event时长,在您想跟踪时长的代码部分,调用如下方法
在您想跟踪时长的代码部分,调用如下方法(单位为毫秒)
[MobClick event:(NSString *)eventId durations:(int)millisecond];
[MobClick event:(NSString *)eventId label:(NSString *)label durations:(int)millisecond];
[MobClick event:(NSString *)eventId attributes:(NSDictionary *)attributes durations:(int)millisecond];
时长是友盟统计的一个新功能,使用过程中可能会出现一些常见的错误,开发者应该尽量的避免。
注意
event_id
和tag
不能使用特殊字符,且长度不能超过128个字节;map
中的key
和value
都不能使用特殊字符,key
不能超过128个字节,value
不能超过256个字节id
,ts
,du
是保留字段,不能作为eventId
及key
的名称。- 每个应用至多添加500个自定义事件,每个
event
的key
不能超过10个,每个key
的取值不能超过1000个(不允许通过key-value结构来统计类似搜索关键词,网页链接等随机生成的字符串信息)。 如有任何问题,请联系客服qq: 800083942。
2.使用分发渠道分析
您选择多个分发渠道时,例如某Cydia源,或某网站,可以为不同渠道进行分发渠道的设定,分别打包成不同的渠道包,以便统计终端用户的程序安装渠道。
注意:
每台设备仅记录首次安装激活的渠道,在其他渠道再次安装不会重复计量。 所以在测试不同的渠道的时候,请使用不同的设备来分别测试。
示例: 在91和tongbu发布:
- [MobClick startWithAppkey:@"xxxxxxxxxxxxxxx" reportPolicy:REALTIME channelId:@"91store"];
- [MobClick startWithAppkey:@"xxxxxxxxxxxxxxx" reportPolicy:REALTIME channelId:@"tongbu"];
3.使用在线配置功能
这个功能目前可以帮您在网站上动态配置两种类型的参数:
- 自定义key-value型的键值对
- 数据发送策略
示例: 动态修改应用的欢迎语,修改应用中开关选项的"on"或"off",以及类似游戏中虚拟物品的价格。
您需要在
[MobClick startWithAppkey:@"xxxxxxxxxxxxxxx"];
之后添加
[MobClick updateOnlineConfig];
这句代码从服务器获取在线参数,并缓存本地。 当在项目里需要获取某个具体参数时调用
[MobClick getConfigParams:@"xxxx"];
xxxx
为友盟服务器上事先设置好的key
。 如果你想获取所有的在线参数,请使用.
[MobClick getConfigParams];
这两个方法都是从[NSUserDefaults standardUserDefaults]
获取缓存的值, 所以上面的[MobClick updateOnlineConfig]
方法要先在app启动时被调用。
注意:
updateOnlineConfig
在app启动时application:didFinishLaunchingWithOptions:
执行,前后台切换是不会执行的,如果需要在切换时更新在线参数,可以在相关回调里执行updateOnlineConfig
。
如果您需要知道在线参数何时获取完毕,可以监听 UMOnlineConfigDidFinishedNotification
,当这个通知发生时,最新的在线参数会传递给notification.userInfo
。
如果此时未联网或在线参数获取失败,这个通知是不会被发出的。
您可以用类似下面的代码来完成这个过程:
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onlineConfigCallBack:) name:UMOnlineConfigDidFinishedNotification object:nil];
- (void)onlineConfigCallBack:(NSNotification *)notification {
NSLog(@"online config has fininshed and params = %@", notification.userInfo);
}
最后别忘记调用removeObserver:name:object:
删除这个监听。
4.页面访问路径统计
您可以统计每个View停留时长及路径。
需要配对使用
- (void)viewWillAppear:(BOOL)animated
{
[super viewWillAppear:animated];
[MobClick beginLogPageView:@"PageOne"];
}
- (void)viewWillDisappear:(BOOL)animated
{
[super viewWillDisappear:animated];
[MobClick endLogPageView:@"PageOne"];
}
注意: 我们针对页面访问进行的是抽样统计,所以只有数据量达到一定规模之后才可以看到
如果您想自己传递时长(单位为秒),我们也提供了方法。
+ (void)logPageView:(NSString *)pageName seconds:(int)seconds;
5.按渠道自动更新检测
在网站上分渠道提交app的版本号,更新日志及openURL后,您只需添加一行代码来完成自动更新检查。
请将下面代码添加到[MobClick startWithAppkey:@"xxxxxxxxxxxxxxx"];
之后
[MobClick checkUpdate];
如果想对UIAlertView
的标题和按钮文字做多国语言支持,则需要对下面三个词组做翻译。
umUpdateTitle
:标题
umUpdateCancel
: 放弃按钮
umUpdateOK
: 确定按钮
当然您可以更简单的自定义标题和按钮的文字
[MobClick checkUpdate:@"New version" cancelButtonTitle:@"Skip" otherButtonTitles:@"Goto Store"];
如果默认的行为不满足你的需求,您可以完全自定义自动更新检查行为。只需实现
- (void)appUpdate:(NSDictionary *)appInfo;
这个delegate
方法。appInfo
是服务器传回来的app相关信息。
Xcode4有两个版本号,一个是Version
,另一个是Build
,对应于Info.plist的字段名分别为CFBundleShortVersionString
,CFBundleVersion
。 友盟SDK为了兼容Xcode3的工程,默认取的是Build
号,如果需要取Xcode4的Version
,可以使用下面 的方法。
NSString *version = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"];
[MobClick setAppVersion:version];
6.自定义事件案例
自定义事件用于追踪用户的行为,包括记录行为发生的次数、持续的时长以及该行为的具体细节。不同的需求可以采用不同的方式来跟踪。以音乐类应用为例,如果想监控music play(播放音乐)事件,那么
6.1.1. 跟踪播放音乐事件发生的总次数和平均每次启动该事件发生的次数,只需要下面一行代码:
[MobClick event:@"music_play"];
6.1.2 跟踪播放音乐事件发生的总时间:
在音乐播放开始的时调用:
[MobClick beginEvent:@"music_play"];
在音乐播放结束时调用:
[MobClick endEvent:@"music_play"];
6.1.3 播放音乐事件还有很多其它特征:比如所播放音乐的风格、表演者,用户播放音乐时的状态(登录或匿名)。了解这些细节需要下面的代码:
NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:
6.1.4 更进一步,您可以捕捉到每种状态的持续时间,比如每种风格的音乐播放了多久。您需要采用如下方法:
NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:
在音乐播放开始时调用:
NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:
[MobClick beginEvent:@"music" primarykey :(NSString *)keyName];
在音乐播放结束时调用:
[MobClick endEvent:@"music" primarykey :(NSString *)keyName];
媒体类应用都可以依照上面的方法去追踪事件,比如阅读文章、观看视频、播放音乐等。这样可以清楚地了解哪些作品有更高点击率、更长展示时间,以及更受用户喜欢,从而在内容选择和推荐上更有针对性。
再来看一个游戏案例:这是一个即时策略的塔防游戏,采用的是内置付费模式。
6.2.1. 首先,我们想观察玩家在每次过关时的状态,那么可以监控”user_status”这个事件。
NSDictionary *status = [NSDictionary dictionaryWithObjectsAndKeys:
这样,我们就会知道每次过关时,等级怎样,剩余多少金币,是否购买玩了多少次,玩了多少时间。从而了解玩家在哪一关的流失率较高,接下来应该重点去改善。
6.2.2. 进一步,我们可以验证关卡难度,即监控”player_dead”这个事件。
[MobClick event:@"player_dead" label:@"level"];
可以观察玩家在哪一关的死亡率最高,是否与上面流失率最高的关卡吻合,这样能判断关卡难度是否是造成流失的主要原因。如果是,我们可以通过降低关卡难度来让更多的玩家留在游戏中;如果不是,那么需要从其他方面入手,比如丰富游戏内容增加对玩家吸引力、加强对新手的引导环节等。
6.2.3. 购买监控道具购买是该游戏主要的收入模式,我们非常关心用户购买行为的发生次数,那么我们可以监控”purchase”这个事件:
[MobClick event:@"purchase"];
购买这个事件还有很多细节特征可以记录。比如,玩家是在哪些关购买的道具、购买道具的类型是什么、是否购买成功、购买道具时人物处于什么样的角色等等。您可以这么做:
NSDictionary *purchase = [NSDictionary dictionaryWithObjectsAndKeys:
知道了玩家更喜欢在哪几关购买道具,那么我们可以设法尽量让更多玩家到达那一关;知道了玩家喜欢什么样的道具,大概是什么样的功能和定价,那么我们可以考虑优化道具设计、适当促销,从而优化收益。
原文:http://blog.sina.com.cn/s/blog_a19a961b0101i823.html