在 $AppClick 事件采集中,还有两个比较特殊的控件:
这两个控件的点击事件,一般指的是点击 UITableViewCell 和 UICollectionViewCell。而 UITableViewCell 和 UICollectionViewCell 都是直接继承自 UIView 类,而不是 UIControl 类。因此,我们之前实现 $AppClick 事件全埋点的两个方案均不适用于 UITableView 和 UICollectionView。
关于实现 UITableView 和 UICollectionView $AppClick 事件的全埋点,常见的方案有三种:
这三种方案,各有优缺点。
下面,我们以 UITableView 控件为例,来分别介绍如何使用这三种方案实现 $AppClick 事件的全埋点。
大概思路:首先,我们使用 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 事件。
大概思路:动态子类的方案,就是在运行时,给实现了 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 事件。
在 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" } }
我们可以通过方法交换、动态子类和消息转发三种方式实现 UITableViewCell 的点击事件。他们各有优缺点。
方案一:方法交换
优点:简单,易理解, Method Swizzling 属于成熟技术,性能相对来说比较高。
缺点:对原始的类有入侵,容易造成冲突。
方案二:动态子类
优点:没有对原始的类入侵,不会修改原始类的方法,不会和第三方库冲突,是一种比较稳定的方案。
缺点:动态创建子类对性能和内存有比较大的消耗。
方案三:消息转发
优点:充分利用消息转发机制,对消息进行拦截,性能较好。
缺点:容易与一些同样使用消息转发进行拦截的第三方库冲突。
大概思路:获取到 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" } }
通过 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 的 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]; } }
第五步:测试验证