iOS全埋点解决方案-UITableView和UICollectionView点击事件
前言
在 $AppClick 事件采集中,还有两个比较特殊的控件:
- UITableView
- •UICollectionView
这两个控件的点击事件,一般指的是点击 UITableViewCell 和 UICollectionViewCell。而 UITableViewCell 和 UICollectionViewCell 都是直接继承自 UIView 类,而不是 UIControl 类。因此,我们之前实现 $AppClick 事件全埋点的两个方案均不适用于 UITableView 和 UICollectionView。
关于实现 UITableView 和 UICollectionView $AppClick 事件的全埋点,常见的方案有三种:
- 方法交换
- 动态子类
- 消息转发
这三种方案,各有优缺点。
下面,我们以 UITableView 控件为例,来分别介绍如何使用这三种方案实现 $AppClick 事件的全埋点。
一、支持 UITableView 控件
1.1 方案一:方法交换
大概思路:首先,我们使用 Method Swizzling 交换 UITableView 的 – setDelegate: 方法,然后能获取到实现了 UITableViewDelegate 协议的 delegate 对象,在拿到 delegate 对象之后,就可以交换 delegate 对象的 – tableView:didSelectRowAtIndexPath: 方法,最后,在交换后的方法中触发 $AppClick 事件,从而达到全埋点的效果。
实现步骤:
第一步: 添加 UITableView+SensorsData 类别,在类别中实现 + load 类方法,并在 + load 类方法中交换 – setDelegate: 方法
+ (void)load {
[UITableView sensorsdata_swizzleMethod:@selector(setDelegate:) withMethod:@selector(sensorsdata_setDelegate:)];
}
- (void)sensorsdata_setDelegate:(id<UITableViewDelegate>)delegate {
// 调用原始的设置代理方法
[self sensorsdata_setDelegate:delegate];
}
第二步:添加 sensorsdata_tableViewDidSelectRow 函数
#import <objc/message.h>
static void sensorsdata_tableViewDidSelectRow(id object, SEL selector, UITableView *tableView, NSIndexPath *indexPath) {
SEL destinationSelecotr = NSSelectorFromString(@"sensorsdata_tableView:didSelectRowAtIndexPath:");
// 通过消息发送,调用原始的 tableView:didSelectRowAtIndexPath: 方法实现
((void(*)(id, SEL, id, id))objc_msgSend)(object, destinationSelecotr, tableView, indexPath);
// 触发 $AppClick 事件
}
第三步:添加一个私有方法 – sensorsdata_swizzleDidSelectRowIndexPathMethodWithDelegate: 负责给 delegate 添加一个方法并进行替换
#import "NSObject+SASwizzler.h"
- (void)sensorsdata_swizzleDidSelectRowIndexPathMethodWithDelegate:(id)delegate {
// 获取 delegate 对象的类
Class delegateClass = [delegate class];
// 方法名
SEL sourceSelector = @selector(tableView:didSelectRowAtIndexPath:);
// 当 delegate 对象中没有实现 tableView:didSelectRowAtIndexPath: 方法时,直接返回
if (![delegate respondsToSelector:sourceSelector]) {
return;
}
SEL destinationSelecrot = @selector(sensorsdata_tableView:didSelectRowAtIndexPath:);
//当 delegate 对象中已经存在实现 sensorsdata_tableView:didSelectRowAtIndexPath: 方法时,说明已经交换,直接返回
if ([delegate respondsToSelector:destinationSelecrot]) {
return;
}
Method souceMethod = class_getInstanceMethod(delegateClass, sourceSelector);
const char *encoding = method_getTypeEncoding(souceMethod);
if (!class_addMethod([delegate class], destinationSelecrot, sensorsdata_tableViewDidSelectRow, encoding)) {
NSLog(@"Add %@ to %@ error", NSStringFromSelector(sourceSelector), [delegate class]);
return;
}
// 方法添加成功后进行方法交换
[delegateClass sensorsdata_swizzleMethod:sourceSelector withMethod:destinationSelecrot];
}
第四步:在 – sensorsdata_setDelegate:方法中调用 – sensorsdata_swizzleDidSelectRowIndexPathMethodWithDelegate:方法进行交换
- (void)sensorsdata_setDelegate:(id<UITableViewDelegate>)delegate {
// 调用原始的设置代理方法
[self sensorsdata_setDelegate:delegate];
// 方案一: 方法交换
// 交换 delegate 对象中的 tableView:didSelectRowAtIndexPath: 方法
[self sensorsdata_swizzleDidSelectRowIndexPathMethodWithDelegate:delegate];
}
第五步:在 SensorsAnalyticsSDK+Track 中新增一个触发 UITableView 控件点击事件的方法 – trackAppClickWithTableView: didSelectRowAtIndexPath: properties: 。
@interface SensorsAnalyticsSDK (Track)
/// 支持 UITableView 触发 $AppClick 事件
/// @param tableView 触发事件的 tableView 视图
/// @param indexPath 在 tableView 中点击的位置
/// @param properties 自定义事件参数
- (void)trackAppClickWithTableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath properties:(nullable NSDictionary <NSString*, id> *)properties;
@end
- (void)trackAppClickWithTableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath properties:(nullable NSDictionary <NSString*, id> *)properties {
NSMutableDictionary *eventProperties = [NSMutableDictionary dictionary];
// TODO: 获取用户点击的 UITableViewCell 控件对象
// TODO: 设置被用户点击的 UITableViewCell 控件上的内容
// TODO: 设置被用户点击 UITableViewCell 控件所在的位置
// 添加自定义属性
[eventProperties addEntriesFromDictionary:properties];
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:tableView properties:properties];
}
第六步:在 sensorsdata_tableViewDidSelectRow 函数中触发 $AppClick 事件
static void sensorsdata_tableViewDidSelectRow(id object, SEL selector, UITableView *tableView, NSIndexPath *indexPath) {
SEL destinationSelecotr = NSSelectorFromString(@"sensorsdata_tableView:didSelectRowAtIndexPath:");
// 通过消息发送,调用原始的 tableView:didSelectRowAtIndexPath: 方法实现
((void(*)(id, SEL, id, id))objc_msgSend)(object, destinationSelecotr, tableView, indexPath);
// 触发 $AppClick 事件
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithTableView:tableView didSelectRowAtIndexPath:indexPath properties:nil];
}
第七步:测试运行
在 Demo 中添加 tableView, 点击 tableView 上的 cell
{
"event" : "$AppClick",
"time" : 1648801408348,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$element_type" : "UITableView",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$screen_name" : "ViewController",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
至此,已经通过方法交换实现了 UITableView 的 $AppClick 事件。
1.2 方案二:动态子类
大概思路:动态子类的方案,就是在运行时,给实现了 UITableViewDelegate 协议的 – tableView:didSelectRowAtIndexPath: 方法的类创建一个子类,让这个类的对象变成我们自己创建的子类的对象。同时,还需要在创建的子类中动态添加 – tableView:didSelectRowAtIndexPath: 方法。那么,当用户点击 UITableViewCell 时,就会先运行我们创建的子类中的 – tableView:didSelectRowAtIndexPath: 方法。然后,我们在实现这个方法的时候,先调用 delegate 原来的方法实现再触发 $AppClick 事件,即可达到全埋点的效果。
实现步骤:
第一步:在项目创建一个动态添加子类的工具类 SensrosAnalyticsDynamicDelegate。在工具类 SensrosAnalyticsDynamicDelegate 中添加 – tableView: didSelectRowAtIndexPath: 方法。
#import "SensrosAnalyticsDynamicDelegate.h"
#import "SensorsAnalyticsSDK+Track.h"
#import <objc/runtime.h>
/// delegate 对象的之类前缀
static NSString *const kSensorsDelegatePrefix = @"cn.SensorsData";
/// tableView:didSelectRowAtIndexPath: 方法指针类型
typedef void (*SensorsDidSelectImplementation)(id, SEL, UITableView *, NSIndexPath *);
@implementation SensrosAnalyticsDynamicDelegate
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(nonnull NSIndexPath *)indexPath {
// 第一步: 获取原始类
Class cla = object_getClass(tableView);
NSString *className = [NSStringFromClass(cla) stringByReplacingOccurrencesOfString:kSensorsDelegatePrefix withString:@""];
Class originalClass = objc_getClass([className UTF8String]);
// 第二步:调用开发者自己实现的方法
SEL originalSelector = NSSelectorFromString(@"tableView:didSelectRowAtIndexPath:");
Method originalMethod = class_getInstanceMethod(originalClass, originalSelector);
IMP originalImplementation = method_getImplementation(originalMethod);
if (originalImplementation) {
((SensorsDidSelectImplementation)originalImplementation)(tableView.delegate, originalSelector, tableView, indexPath);
}
// 第三步:埋点
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithTableView:tableView didSelectRowAtIndexPath:indexPath properties:nil];
}
@end
第二步:在 SensrosAnalyticsDynamicDelegate 类中添加 – proxyWithTableViewDelegate:类方法
+ (void)proxyWithTableViewDelegate:(id<UITableViewDelegate>)delegate {
SEL originalSelector = NSSelectorFromString(@"tableView:didSelectRowAtIndexPath:");
// 当 delegate 对象中没有实现 tableView:didSelectRowAtIndexPath: 方法时,直接返回
if (![delegate respondsToSelector:originalSelector]) {
return;
}
// 动态创建一个新类
Class originalClass = object_getClass(delegate);
NSString *originalClassName = NSStringFromClass(originalClass);
// 当 delegate 对象已经是一个动态创建的类时,无需重复创建,,直接返回
if ([originalClassName hasPrefix:kSensorsDelegatePrefix]) {
return;
}
NSString *subClassName = [kSensorsDelegatePrefix stringByAppendingString:originalClassName];
Class subClass = NSClassFromString(subClassName);
if (!subClass) {
// 注册一个新的子类,其父类为originalClass
subClass = objc_allocateClassPair(originalClass, subClassName.UTF8String, 0);
// 获取 SensrosAnalyticsDynamicDelegate 中的 tableView:didSelecorRowIndexPath: 方法指针
Method method = class_getInstanceMethod(self, originalSelector);
// 获取方法实现
IMP methodIMP = method_getImplementation(method);
// 获取方法类型编码
const char *types = method_getTypeEncoding(method);
// 在 subClass 中添加 tableView:didSelectRowAtIndexPath: 方法
if (!class_addMethod(subClass, originalSelector, methodIMP, types)) {
NSLog(@"Cannot copy method to destination selector %@ as it already exists", NSStringFromSelector(originalSelector));
}
// 子类和原始类的大小必须相同 ,不能有更多的成员变量或者属性
// 如果不同,将导致设置新的子类时,重新分配内存,重写对象的 isa 指针
if (class_getInstanceSize(originalClass) != class_getInstanceSize(subClass)) {
NSLog(@"Cannot create subClass of Delegate, beacause the created subClass is not the same size. %@", NSStringFromClass(originalClass));
NSAssert(NO, @"Classes must be the same size to swizzle isa");
return;
}
// 将 delegate 对象设置成新创建的子类对象
objc_registerClassPair(subClass);
}
if (object_setClass(delegate, subClass)) {
NSLog(@"SuccessFully create Delegere Proxy automatically.");
}
}
第三步:修改 UITableView+SensorsData 中 – sensorsdata_setDelegate:方法
#import "SensrosAnalyticsDynamicDelegate.h"
- (void)sensorsdata_setDelegate:(id<UITableViewDelegate>)delegate {
// 调用原始的设置代理方法
// [self sensorsdata_setDelegate:delegate];
// 方案一: 方法交换
// 交换 delegate 对象中的 tableView:didSelectRowAtIndexPath: 方法
// [self sensorsdata_swizzleDidSelectRowIndexPathMethodWithDelegate:delegate];
// 方案二:动态子类
// 调用原始的设置代理方法
[self sensorsdata_setDelegate:delegate];
// 设置 delegate 对象的动态子类
[SensrosAnalyticsDynamicDelegate proxyWithTableViewDelegate:delegate];
}
第四步:测试验证
{
"event" : "$AppClick",
"time" : 1648807502558,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$element_type" : "UITableView",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$screen_name" : "cn.SensorsDataViewController",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
问题: “$screen_name”的名称是动态生成子类的名称 “cn.SensorsDataViewController”, 我们期望是原类的名称。
解决方案:在生成的子类中,重写 class 方法,该方法返回原始子类。
第一步:重写 class 方法
- (Class)sensorsdata_class {
// 获取对象的类
Class class = object_getClass(self);
// 将类名前缀替换成空字符串,获取原始类名
NSString *className = [NSStringFromClass(class) stringByReplacingOccurrencesOfString:kSensorsDelegatePrefix withString:@""];
// 通过字符串获取类,返回
return objc_getClass(className.UTF8String);
}
第二步:给动态创建的子类添加 class 方法
+ (void)proxyWithTableViewDelegate:(id<UITableViewDelegate>)delegate {
SEL originalSelector = NSSelectorFromString(@"tableView:didSelectRowAtIndexPath:");
// 当 delegate 对象中没有实现 tableView:didSelectRowAtIndexPath: 方法时,直接返回
if (![delegate respondsToSelector:originalSelector]) {
return;
}
// 动态创建一个新类
Class originalClass = object_getClass(delegate);
NSString *originalClassName = NSStringFromClass(originalClass);
// 当 delegate 对象已经是一个动态创建的类时,无需重复创建,,直接返回
if ([originalClassName hasPrefix:kSensorsDelegatePrefix]) {
return;
}
NSString *subClassName = [kSensorsDelegatePrefix stringByAppendingString:originalClassName];
Class subClass = NSClassFromString(subClassName);
if (!subClass) {
// 注册一个新的子类,其父类为originalClass
subClass = objc_allocateClassPair(originalClass, subClassName.UTF8String, 0);
// 获取 SensrosAnalyticsDynamicDelegate 中的 tableView:didSelecorRowIndexPath: 方法指针
Method method = class_getInstanceMethod(self, originalSelector);
// 获取方法实现
IMP methodIMP = method_getImplementation(method);
// 获取方法类型编码
const char *types = method_getTypeEncoding(method);
// 在 subClass 中添加 tableView:didSelectRowAtIndexPath: 方法
if (!class_addMethod(subClass, originalSelector, methodIMP, types)) {
NSLog(@"Cannot copy method to destination selector %@ as it already exists", NSStringFromSelector(originalSelector));
}
// 获取 SensrosAnalyticsDynamicDelegate 中的 sensorsdata_class 指针
Method classMethod = class_getInstanceMethod(self, @selector(sensorsdata_class));
// 获取方法实现
IMP classIMP = method_getImplementation(classMethod);
// 获取方法的类型编码
const char *classTypes = method_getTypeEncoding(classMethod);
if (!class_addMethod(subClass, @selector(class), classIMP, classTypes)) {
NSLog(@"Cannot copy method to destination selector -(void)class as it already exists");
}
// 子类和原始类的大小必须相同 ,不能有更多的成员变量或者属性
// 如果不同,将导致设置新的子类时,重新分配内存,重写对象的 isa 指针
if (class_getInstanceSize(originalClass) != class_getInstanceSize(subClass)) {
NSLog(@"Cannot create subClass of Delegate, beacause the created subClass is not the same size. %@", NSStringFromClass(originalClass));
NSAssert(NO, @"Classes must be the same size to swizzle isa");
return;
}
// 将 delegate 对象设置成新创建的子类对象
objc_registerClassPair(subClass);
}
if (object_setClass(delegate, subClass)) {
NSLog(@"SuccessFully create Delegere Proxy automatically.");
}
}
第三步:测试验证
{
"event" : "$AppClick",
"time" : 1648808663270,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$element_type" : "UITableView",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$screen_name" : "ViewController",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
至此,已经通过动态创建子类实现了 UITableView 的 $AppClick 事件。
1.3 方案三:消息转发
在 iOS 应用开发中,自定义一个类的时候,一般都需要继承自 NSObject 类或者 NSObject 的子类。但是 NSProxy 类却并不是继承自 NSObject 类或者 NSObject 的子类,NSProxy 是一个实现了 NSObject 协议的抽象基类。
实现步骤
第一步:创建 SensorsAnalyticsDelegateProxy 类,继承 NSProxy, 并添加 + proxyWithTableViewDelegate 类方法
@interface SensorsAnalyticsDelegateProxy : NSProxy
+ (instancetype)proxyWithTableViewDelegate:(id<UITableViewDelegate>) delegate;
@end
@interface SensorsAnalyticsDelegateProxy()
@property (nonatomic, weak) id delegate;
@end
@implementation SensorsAnalyticsDelegateProxy
+ (instancetype)proxyWithTableViewDelegate:(id<UITableViewDelegate>) delegate {
SensorsAnalyticsDelegateProxy *proxy = [SensorsAnalyticsDelegateProxy alloc];
proxy.delegate = delegate;
return proxy;
}
@end
第二步:重写 – methodSignatureForSelector 方法,返回 delegate 对象中对应的方法签名,重写 – forwardInvocation: 方法,将消息转给 delegate 对象执行,并触发 $AppClick 事件
- (NSMethodSignature *)methodSignatureForSelector:(SEL)sel {
// 返回 delegate 对象方法中对应的方法签名
return [(NSObject *)self.delegate methodSignatureForSelector:sel];
}
- (void)forwardInvocation:(NSInvocation *)invocation {
// 先执行 delegate 对象中的方法
[invocation invokeWithTarget:self.delegate];
// 判断是否是 cell 的点击事件代理方法
if (invocation.selector == @selector(tableView:didSelectRowAtIndexPath:)) {
// 将方法修改成采集数据行为的方法
invocation.selector = NSSelectorFromString(@"sensorsdata_tableView:didSelectRowAtIndexPath:");
// 执行是数据采集相关的方法
[invocation invokeWithTarget:self];
}
}
- (void)sensorsdata_tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithTableView:tableView didSelectRowAtIndexPath:indexPath properties:nil];
}
第三步:修改 UITableView+SensorsData 中 – sensorsdata_setDelegate: 方法,创建委托对象,并设置成 UITableView 控件的 delegate 对象。
#import "SensorsAnalyticsDelegateProxy.h"
- (void)sensorsdata_setDelegate:(id<UITableViewDelegate>)delegate {
// 方案三:NSProxy 消息转发
SensorsAnalyticsDelegateProxy *proxy = [SensorsAnalyticsDelegateProxy proxyWithTableViewDelegate:delegate];
[self sensorsdata_setDelegate:proxy];
}
第四步:测试验证,程序奔溃。原因是在 – sensorsdata_setDelegate:创建的 proxy 对象是一个临时变量,方法结束后,该对象被销毁。
解决方法:
第五步:创建 UIScrollView 的分类 UIScrollView+SensorsData,并在头文件中进行属性声明
@interface UIScrollView (SensorsData)
@property (nonatomic, strong) SensorsAnalyticsDelegateProxy *sensorsdata_delegateProxy;
@end
第六步:然后,通过 runtime 的 objc_setAssociatedObject 和 objc_getAssociatedObject 函数实现类别中添加属性
#import <objc/runtime.h>
@implementation UIScrollView (SensorsData)
- (void)setSensorsdata_delegateProxy:(SensorsAnalyticsDelegateProxy *)sensorsdata_delegateProxy {
objc_setAssociatedObject(self, @selector(setSensorsdata_delegateProxy:), sensorsdata_delegateProxy, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
- (SensorsAnalyticsDelegateProxy *)sensorsdata_delegateProxy {
return objc_getAssociatedObject(self, @selector(sensorsdata_delegateProxy));
}
@end
第七步:修改 – sensorsdata_setDelegate:方法。增加保存委托对象的代码。
- (void)sensorsdata_setDelegate:(id<UITableViewDelegate>)delegate {
// 方案三:NSProxy 消息转发
// 销毁保存的委托对象
self.sensorsdata_delegateProxy = nil;
if (delegate) {
SensorsAnalyticsDelegateProxy *proxy = [SensorsAnalyticsDelegateProxy proxyWithTableViewDelegate:delegate];
self.sensorsdata_delegateProxy = proxy;
// 调用原始方法,将代理设置为委托对象
[self sensorsdata_setDelegate:proxy];
} else {
// 调用原始方法,将代理设置nil
[self sensorsdata_setDelegate:nil];
}
}
第八步:测试验证
{
"event" : "$AppClick",
"time" : 1648882043652,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$element_type" : "UITableView",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$screen_name" : "ViewController",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
1.4 三种方法的总结
我们可以通过方法交换、动态子类和消息转发三种方式实现 UITableViewCell 的点击事件。他们各有优缺点。
方案一:方法交换
优点:简单,易理解, Method Swizzling 属于成熟技术,性能相对来说比较高。
缺点:对原始的类有入侵,容易造成冲突。
方案二:动态子类
优点:没有对原始的类入侵,不会修改原始类的方法,不会和第三方库冲突,是一种比较稳定的方案。
缺点:动态创建子类对性能和内存有比较大的消耗。
方案三:消息转发
优点:充分利用消息转发机制,对消息进行拦截,性能较好。
缺点:容易与一些同样使用消息转发进行拦截的第三方库冲突。
1.5 优化
(1)获取控件的内容
大概思路:获取到 UITableViewCell 对象后,递归遍历所有的子控件,每次获取子控件的内容,并按照一定格式进行拼接,然后将拼接的内容作为 UITableViewCell 控件显示的内容。
第一步:修改 UIView+SensorsData 的 – sensorsdata_elementContent 方法
- (NSString *)sensorsdata_elementContent {
// 如果是隐藏控件,不获取控件内容
if (self.isHidden || self.alpha == 0) {
return nil;
}
// 初始化数组,用于保存子控件的内容
NSMutableArray *contents = [NSMutableArray array];
for (UIView *view in self.subviews) {
// 获取子控件内容
// 如果子类有内容,例如 UILabel 的 text,获取到的就是 text 属性
// 如果子类没有内容,将递归调用该方法,获取其子控件的内容
NSString *content = view.sensorsdata_elementContent;
if (content.length > 0) {
// 当该子控件有内容是,保存到数组中
[contents addObject:content];
}
}
// 当未获取到内容时,返回 nil,如果获取到多个子控件的内容时,使用”-“拼接
return contents.count == 0 ? nil : [contents componentsJoinedByString:@"-"];
}
第二步:修改 UIButton 控件的 – sensorsdata_elementContent 方法
#pragma mark -UIButton
@implementation UIButton (SensorsData)
- (NSString *)sensorsdata_elementContent {
return self.currentTitle ?: super.sensorsdata_elementContent;
}
@end
第三步:修改 UILabel 控件的 – sensorsdata_elementContent 方法
#pragma mark -UILabel
@implementation UILabel (SensorsData)
- (NSString *)sensorsdata_elementContent {
return self.text ?: super.sensorsdata_elementContent;
}
@end
第四步:修改 SensorsAnalyticsSDK+Track 文件中 – trackAppClickWithTableView:didSelectRowAtIndexPath: properties: 方法
- (void)trackAppClickWithTableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath properties:(nullable NSDictionary <NSString*, id> *)properties {
NSMutableDictionary *eventProperties = [NSMutableDictionary dictionary];
// TODO: 获取用户点击的 UITableViewCell 控件对象
UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath];
// TODO: 设置被用户点击的 UITableViewCell 控件上的内容
eventProperties[@"$element_content"] = cell.sensorsdata_elementContent;
// TODO: 设置被用户点击 UITableViewCell 控件所在的位置
// 添加自定义属性
[eventProperties addEntriesFromDictionary:properties];
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:tableView properties:eventProperties];
}
第五步:测试验证:
{
"event" : "$AppClick",
"time" : 1648885587341,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$element_type" : "UITableView",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$element_content" : "CELL",
"$app_version" : "1.0",
"$screen_name" : "ViewController",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
(2)获取 UITableView 的位置
通过 indexPath 获取用户点击 cell 的位置。
- (void)trackAppClickWithTableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath properties:(nullable NSDictionary <NSString*, id> *)properties {
NSMutableDictionary *eventProperties = [NSMutableDictionary dictionary];
// 获取用户点击的 UITableViewCell 控件对象
UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath];
// 设置被用户点击的 UITableViewCell 控件上的内容
eventProperties[@"$element_content"] = cell.sensorsdata_elementContent;
// 设置被用户点击 UITableViewCell 控件所在的位置
eventProperties[@"$element_position"] = [NSString stringWithFormat:@"%ld:%ld", (long)indexPath.section, (long)indexPath.row];
// 添加自定义属性
[eventProperties addEntriesFromDictionary:properties];
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:tableView properties:eventProperties];
}
运行 Demo 测试验证
{
"event" : "$AppClick",
"time" : 1648887065273,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$element_position" : "0:5",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$element_content" : "CELL",
"$element_type" : "UITableView",
"$app_version" : "1.0",
"$screen_name" : "ViewController",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
二、支持 UICollectionView
UICollectionView 的 cell 的 $AppClick 全埋点点击事件,整体和 UITableView 类似,同样可以用三种方案实现。此刻,我们用第三种方案消息转发来实现UICollectionView 的 cell 的 $AppClick 全埋点点击事件。
第一步:在 SensorsAnalyticsSDK+Track 中新增 – trackAppClickWithCollection: didSelectItemAtIndexPath: properties: 方法
/// 支持 UICollectionView 触发 $AppClick 事件
/// @param collectionView 触发事件的 tableView 视图
/// @param indexPath 在 tableView 中点击的位置
/// @param properties 自定义事件参数
- (void)trackAppClickWithCollection:(UICollectionView *)collectionView didSelectItemAtIndexPath:(NSIndexPath *)indexPath properties:(nullable NSDictionary <NSString*, id> *)properties;
- (void)trackAppClickWithCollection:(UICollectionView *)collectionView didSelectItemAtIndexPath:(NSIndexPath *)indexPath properties:(nullable NSDictionary <NSString*, id> *)properties {
NSMutableDictionary *eventProperties = [NSMutableDictionary dictionary];
// 获取用户点击的 UITableViewCell 控件对象
UICollectionViewCell *cell = [collectionView cellForItemAtIndexPath:indexPath];
// 设置被用户点击的 UITableViewCell 控件上的内容
eventProperties[@"$element_content"] = cell.sensorsdata_elementContent;
// 设置被用户点击 UITableViewCell 控件所在的位置
eventProperties[@"$element_position"] = [NSString stringWithFormat:@"%ld:%ld", (long)indexPath.section, (long)indexPath.row];
// 添加自定义属性
[eventProperties addEntriesFromDictionary:properties];
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:collectionView properties:eventProperties];
}
第二步:在 SensorsAnalyticsDelegateProxy 中新增初始化方法
@interface SensorsAnalyticsDelegateProxy : NSProxy
/// 初始化委托对象,用于拦截 UICollectionView 控件选中 cell 事件
/// @param delegate UICollectionView 控件代理
+ (instancetype)proxyWithCollectionViewDelegate:(id<UICollectionViewDelegate>) delegate;
@end
+ (instancetype)proxyWithCollectionViewDelegate:(id<UICollectionViewDelegate>) delegate {
SensorsAnalyticsDelegateProxy *proxy = [SensorsAnalyticsDelegateProxy alloc];
proxy.delegate = delegate;
return proxy;
}
第三步:修改 – forwardInvocation:方法
- (void)forwardInvocation:(NSInvocation *)invocation {
// 先执行 delegate 对象中的方法
[invocation invokeWithTarget:self.delegate];
// 判断是否是 cell 的点击事件代理方法
if (invocation.selector == @selector(tableView:didSelectRowAtIndexPath:)) {
// 将方法修改成采集数据行为的方法
invocation.selector = NSSelectorFromString(@"sensorsdata_tableView:didSelectRowAtIndexPath:");
// 执行是数据采集相关的方法
[invocation invokeWithTarget:self];
} else if (invocation.selector == @selector(collectionView:didSelectItemAtIndexPath:)) {
// 将方法修改成采集数据行为的方法
invocation.selector = NSSelectorFromString(@"sensorsdata_collectionView:didSelectItemAtIndexPath:");
// 执行是数据采集相关的方法
[invocation invokeWithTarget:self];
}
}
- (void)sensorsdata_collectionView:(UICollectionView *)collectionView didSelectItemAtIndexPath:(NSIndexPath *)indexPath {
[[SensorsAnalyticsSDK sharedInstance] trackAppClickWithCollection:collectionView didSelectItemAtIndexPath:indexPath properties:nil];
}
第四步:新增 UICollectionView 类别 UICollectionView+SensorsData,实现 + load 方法交换和设置代理对象
+ (void)load {
[UICollectionView sensorsdata_swizzleMethod:@selector(setDelegate:) withMethod:@selector(sensorsdata_setDelegate:)];
}
- (void)sensorsdata_setDelegate:(id<UICollectionViewDelegate>) delegate {
// NSProxy 消息转发
// 销毁保存的委托对象
self.sensorsdata_delegateProxy = nil;
if (delegate) {
SensorsAnalyticsDelegateProxy *proxy = [SensorsAnalyticsDelegateProxy proxyWithCollectionViewDelegate:delegate];
self.sensorsdata_delegateProxy = proxy;
// 调用原始方法,将代理设置为委托对象
[self sensorsdata_setDelegate:proxy];
} else {
// 调用原始方法,将代理设置nil
[self sensorsdata_setDelegate:nil];
}
}
第五步:测试验证