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];
    }
}

第五步:测试验证

页面下部广告