用户行为监控

最近更新时间:2025-07-01 19:08:21

我的收藏

原生用户行为监控

功能说明

用户行为功能数据将会在1min或者超过200条数据聚合上报。

相关接口

自定义用户行为功能:在需要打点的页面加入 #import <QAPM/QAPMUBSMonitor.h> 头文件后,调用如下接口。
@interface QAPMUBSMonitor : NSObject
+ (instancetype)manager;
/**
用户自定义用户行为操作调用,外部用户接口,调用该接口时请完成 QAPM 的一系列初始化操作,设置完 QAPM 的 appKey 后调用。
@param category 事件名,建议全部用大写字母表示
@param tags 字符串的 map 标记,对应的 key 的值只能是 d1~d30/info1~info10范围的值
@param values 数值的 map 标记,对应的 key 的值只能是 v1~v30范围的值
@return 用户行为事件 uuid,如果返回为 nil,则表示生成自定义用户行为事件失败
*/
- (NSString *)customEvent:(NSString *)category
tags:(NSDictionary<NSString *, NSString *> *)tags
values:(NSDictionary<NSString *, NSNumber *> *)values;
接口调用实例:
NSDictionary *tags = @{@"d1":@"iPhone 15 Pro",
@"d2":@"OLED显示屏",
@"d3":@"多摄像头系统",
@"info1":@"包括对专业应用的支持,如增强现实(AR)和专业摄影",
@"info2":@"Pro系列的iPhone通常使用更高级的材料,如不锈钢边框和陶瓷保护罩"
};
NSDictionary *values = @{@"v1":@512,
@"v2":@2048
};
[[QAPMUBSMonitor manager] generateUserEvent:@"CUSTOM_PERF_EVENT" label:@"" action:@"" value:@1 tags:tags values:values];

WebView 用户行为监控

WebView 用户行为功能,将会在1min或者超过200条数据聚合上报。
自定义用户行为功能:在 Web 页面代码中需要使用自定义事件的位置(例如单击购买基金的处理函数中),编写如下代码:
window.QAPM.customEvent(category, tags, values)
参数说明:
1)category:事件名称,字符串,值的长度不超过100
2)tags:事件辅助信息,json 格式,key 只能填写 d1~d30和 info1~info10,它们的值都是字符串,其中 d1~d30的值的长度不超过100,info1~info10的值的长度不超过1024,超长的部分会被截断
3)values:事件辅助信息,json 格式,key 只能填写 v1~v30,它们的值都是 int
接口调用实例:
var event = {
"category": "CLICK_BUY_BUTTON",
"values": {
"v1": 748,
"v2": 1
},
"tags": {
"d1": "FUJI mini7+",
"d2": "package:1",
"d3": "color:white",
"info1": "Fuji novice recommends the king of cost-effective instant camera mini7+ one-time imaging cheap film machine for male and female students",
"info2": "Package type: Package 1 [Official standard + 20 pieces of photo paper + new product gift package + 10-piece accessory gift package] Color classification: White"
}
};
window.QAPM && typeof window.QAPM.customEvent==="function" && window.QAPM.customEvent(event.category, event.tags, event.values);

校验功能是否正常

检索 "topic" : 3或者 "topic" : 4。用户行为数据将会在1min或者超过200条数据聚合上报,如打印以下日志,则代表启动个例数据上报成功。

注意:
用户行为功能目前默认情况下只在添加了 白名单 的情况下才会开启。如果线上环境需要开启,请 联系我们
目前只在问题分析模式下才会看到用户轨迹数据。