iOS全埋点解决方案-手势采集

前言

​ 随着科技以及业务的发展,手势的应用也越来越普及,因此对于数据采集,我们要考虑如果通过全埋点来实现手势的采集。

一、手势识别器

​ 苹果为了降低开发者在手势事件处理方面的开发难度,定义了一个抽象类 UIGestureRecognizer 来协助开发者。UIGestureRecognizer 是具体手势识别器的抽象基类,它定义了一组可以为所有具体手势识别器配置的常见行为。它还可以通过设置委托(即实现了 UIGestureRecognizerDelegate 协议的对象),来支持对某些行为进行更细粒度的定制。

​ 手势识别器必须被添加在一个特定的视图上(比如 UILabel、UIImageView 等控件),即需要通过调用 UIView 类中的 – addGestureRecognizer: 方法进行添加。手势识别器也是用了 Target-Action 设计模式。当我们为一个手势识别器添加一个或者多个 Target-Action 后,在视图上进行触摸操作时,一旦系统识别了该手势,就会向所有的 Target 对象发送消息,并执行 Action 方法。虽然手势识别器和 UIControl 类一样,都是使用了 Target-Action 设计模式,但是手势识别器并不会将消息交由 UIApplication 对象来进行发送。因此,我们无法使用与 UIControl 控件相同的处理方式,即通过响应者链的方式来实现对手势操作的全埋点。

​ 由于 UIGestureRecognizer 是一个抽象基类,所以它并不会处理具体的手势。因此,对于轻拍(UITapGestureRecognizer)、长按(UILongPressGestureRecognizer)等具体的手势触摸事件,需要使用相应的子类即具体的手势识别器进行处理。

常见的具体手势识别器有:

  • UITapGestureRecognizer:轻拍手势
  • UILongPressGestureRecognizer:长按手势
  • UIPinchGestureRecognizer:捏合(缩放)手势
  • UIRotationGestureRecognizer:旋转手势
  • UISwipeGestureRecognizer:轻扫手势
  • UIPanGestureRecognizer:平移手势
  • UIScreenEdgePanGestureRecognizer:屏幕边缘平移手势

​ 给上面所有的具体手势识别器添加 Target-Action 的方法都是相同的,常见的主要是通过以下的两个方法进行添加。

  • initWithTarget:target action:

  • addTarget:action:

    详细的定义参考如下:

    /**
    指定初始化方法
    
    通过添加一个 Target-Action 进行初始化,
    当初始化的手势识别器对象,识别到触摸手势时,会向 Target 对象发送消息,即调用 Action 方法
    
    @param target 需要发送消息的 Target 对象
    @param action 向 Target 对象发送的消息,即方法名
    @return 初始化的对象
    */
    - (instancetype)initWithTarget:(nullable id)target action:(nullable SEL)action NS_DESIGNATED_INITIALIZER;
    
    /**
    向一个手势识别器添加一个 Target-Action
    
    可以多次调用此方法,给一个手势识别器对象添加多个 Target-Action 。
    如果已经添加了一个 Target-Action,再次添加相同的 Target-Action 时,会被忽略。
    
    @param target 需要发送消息的 Target 对象
    @param action 向 Target 对象发送的消息,即方法名
    */
    - (void)addTarget:(id)target action:(SEL)action;
    

​ 在实际的开发过程中,使用比较多的是 UITapGestureRecognizer 和 UILongPressGestureRecognizer 两个手势识别器,这两个手势识别器分别是处理轻拍手势和长按手势。

二、手势全埋点

​ 在数据采集中,一般只需要采集常见控件(UILabel、UIImageView)的轻拍和长按手势。
所以,我们分别介绍如何实现控件轻拍和长按手势的全埋点。

2.1 UITapGestureRecognizer 全埋点

​ 为了采集控件的轻拍手势,我们可以通过 Method Swizzling 交换 UITapGestureRecognizer 类的添加 Target-Action 的方法,从而可以添加一个新的 Target-Action,并在新添加的 Action 方法中触发 $AppClick 事件,从而就可以达到采集控件轻拍手势全埋点的效果。

在 UITapGestureRecognizer 类中,用于添加 Target-Action 方法有两个:

• – initWithTarget:action:

• – addTarget:action:

因此,我们需要对这两个方法分别进行交换。

第一步:创建 UITapGestureRecognizer 分类 UIGestureRecognizer+SensorsData,并实现 +load 类方法,在 + load方法中,进行 – initWithTarget:action: 和 – addTarget:action: 的方法交换。

#import "UIGestureRecognizer+SensorsData.h"
#import "NSObject+SASwizzler.h"
#import "SensorsAnalyticsSDK+Track.h"

@implementation UITapGestureRecognizer (SensorsData)

+ (void)load {
    [UITapGestureRecognizer sensorsdata_swizzleMethod:@selector(sensorsdata_initWithTarget:action:) withMethod:@selector(initWithTarget:action:)];
    [UITapGestureRecognizer sensorsdata_swizzleMethod:@selector(addTarget:action:) withMethod:@selector(sensorsdata_addTarget:action:)];
}

- (instancetype)sensorsdata_initWithTarget:(id)target action:(SEL)action {
    [self sensorsdata_initWithTarget:target action:action];
    [self addTarget:target action:action];
    return self;
}

- (void)sensorsdata_addTarget:(id)target action:(SEL)action {
    [self sensorsdata_addTarget:target action:action];
    
    // 新增 Target-Action, 用于触发 $AppClick 事件
    [self sensorsdata_addTarget:self action:@selector(sensorsdata_trackTapGestureAction:)];
}

- (void)sensorsdata_trackTapGestureAction:(UITapGestureRecognizer *)sender {
    [[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:view properties:nil];
}

第二步:在 – sensorsdata_trackTapGestureAction: 方法中判断要采集的控件

- (void)sensorsdata_trackTapGestureAction:(UITapGestureRecognizer *)sender {
    UIView *view = sender.view;
    // 暂定只采集 UILabel 和 UIImageView
    BOOL isTrackClass = [view isKindOfClass:UILabel.class] || [view isKindOfClass:UIImageView.class];
    if (!isTrackClass) {
        return;
    }
    [[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:view properties:nil];
}

第三步:测试验证

{
  "event" : "$AppClick",
  "time" : 1648892963385,
  "propeerties" : {
    "$model" : "x86_64",
    "$manufacturer" : "Apple",
    "$element_type" : "UIImageView",
    "$lib_version" : "1.0.0",
    "$os" : "iOS",
    "$app_version" : "1.0",
    "$screen_name" : "ViewController",
    "$os_version" : "15.2",
    "$lib" : "iOS"
  }
}

2.2 UILongPressGestureRecognizer 全埋点

​ 对于 UILongPressGestureRecognizer 来说,其实现逻辑与 UITapGestureRecognizer 基本上是相同的。

页面下部广告