iOS全埋点解决方案-数据采集SDK
前言
埋点一般可以分为客户端埋点和后端埋点。由于客户端埋点更加贴近业务，更加直观，因此称为市面上主流数据采集手段。对于 iOS 端的埋点，目前市面上主流代码埋点和全埋点两种方案。其中，代码埋点即显式地调用数据采集 SDK 提供的接口来采集数据，在采集能力上有比较大的优势，但是需要做额外的开发，易用性较欠缺；全埋点则不需要做额外写代码，使用方便快捷，但是在采集能力上有所欠缺，并且存在较多的兼容性问题。两种方案上不上孰优孰劣，各自有适用的场景。根据市面的的需求，推崇两种方案综合使用。
数据分析的流程一般是：
因此，数据采集是分析和运营的基本，源头。
一、数据采集 SDK 简介
数据采集 SDK 一般需要包含两大基础功能：
1、通过埋点来采集数据
2、将采集的数据传输到指定的服务器端。
主流的埋点方式包括三种：
1、代码埋点：应用程序集成埋点 SDK 后，在程序启动时初始化埋点 SDK，然后在某个事件触发的时候调用埋点 SDK 提供的方法拉埃触发事件。
2、全埋点：无须应用程序写代或者只写少量的代码，即可预先自动收集用户绝大部分的行为数据，然后根据实际的业务分析需求从中筛选出所需要的数据并进行分析。
3、可视化埋点：通过可视化的方式在产品界面中筛选出来，形成可视化全埋点事件。
二、搭建 SDK 框架
1、创建 Cocoa Touch Framework
第一步：启动 Xcode 创建项目，双击 Framework & library 栏目下Framework 项。
第二步：填写 Product Name 相关的信息，然后点击 Next 按钮，选择 SensorsSDK Project 的保存位置，并点击 Create 按钮，Xcode 会打开创建好的项目。
2、新建 Workspace
第一步：依次单击 File -> New -> Workspace （或者使用快捷键 Control + Command -> N），出现下图弹框，将 Workspace 的名字填写为 SensorsSDK 点击选择保存到 SensorsSDK Project 根目录下，然后点击保存 Save 按钮，此时 Xcode 会打开 SensorsSDK Workspace 窗口。
第二步：在当前 Sensors Workspace 窗口中，将 SensorsSDK Project 项目添加到 SensorsSDK Workspace 中。（在 SensorsSDK Workspace 窗口中依次单击 File -> Add Files to "SensorsSDK"，或者使用 Option + Command + A 快捷键）。
此时，SensorsSDK Workspace 的目录结构如图所示：
3、新建 Demo 工程
第一步：依次单击 File -> New -> Project （或者使用快捷键 Shift + Command + N），双击 App 图标。填写 Product Name 为 Demo，然后点击 Next 按钮，选择项目保存的位置
第二步：选择 Demo Project 的保存位置为 SensorsSDK Project 同级目录，并单击 Create 按钮，Demo 创建成功
第三步：返回到 SensorSDK Workspace 窗口，依次单击 File -> Add Files to "SensorsSDK"（或者使用快捷键 Option + Command + A）, 选中 Demo.xcodeproj 文件，然后单击 Add 按钮， 将 Demo Project 添加到
4、添加依赖关系
在 SensorsSDK Workspace 窗口中，点击 Demo TARGERS ，依次选择 General -> Frameworks，点击添加（+）按钮，选择 SensorsSDK.framework ,单击 Add 按钮。
SensorsSDK Workspace 窗口目录如下图:
5、编写埋点SDK
第一步：在 SensorsSDK Group 下，新建埋点 SDK 主类 SensorsAnalyticsSDK。
第二步: 实现埋点 SDK 获取实例以及 +sharedInstance 类方法。
#import <UIKit/UIkit.h>
NS_ASSUME_NONNULL_BEGIN
@interface SensorsAnalyticsSDK : NSObject
/// 获取 SDK 实例方法
/// 返回单例对象
+ (SensorsAnalyticsSDK *)sharedInstance;
@end
NS_ASSUME_NONNULL_END
#import "SensorsAnalyticsSDK.h"
@implementation SensorsAnalyticsSDK
+ (SensorsAnalyticsSDK *)sharedInstance {
static SensorsAnalyticsSDK *sdk = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
sdk = [[SensorsAnalyticsSDK alloc] init];
});
return sdk;
}
@end
第三步：实现基本的预置属性
预置属性：一般情况下，用户触发任何事件都会携带一些最基本的信息，比如：操作系统类型、运行商信息、应用版本号等，这些信息都是有埋点 SDK 自动采集，我们把这些属性称为预置属性。
我们需要做的就是 SDK 初始化的时候，获取这些预置属性，然后在触发事件时，将这些预置属性添加到每一个事件中。
首先，在 SensorsAnalyticsSDK.m 文件中新增一个 NSDictionary<NSString *, id> 类型的属性 automaticProperties, 用于保存事件的预置属性。
@interface SensorsAnalyticsSDK()
/// 预置属性
@property (nonatomic, strong) NSDictionary<NSString *, id> *automaticProperties;
@end
接着，在 SensorsAnalyticsSDK.m 文件中新增 - collectAutomaticProperties 方法来获取预置属性
#import "SensorsAnalyticsSDK.h"
#include <sys/sysctl.h>
static NSString * const SensorsAnalyticsVersion = @"1.0.0";
@interface SensorsAnalyticsSDK()
/// 预置属性
@property (nonatomic, strong) NSDictionary<NSString *, id> *automaticProperties;
@end
#pragma mark - Properties
- (NSDictionary<NSString *, id> *)collectAutomaticProperties {
NSMutableDictionary *properties = [NSMutableDictionary dictionary];
// 操作系统类型
properties[@"$os"] = @"iOS";
// SDK平台类型
properties[@"$lib"] = @"iOS";
// 设备制造商
properties[@"$manufacturer"] = @"Apple";
// SDK 版本号
properties[@"$lib_version"] = SensorsAnalyticsVersion;
// 手机型号
properties[@"$model"] = [self deviceModel];
// 操作系统版本号
properties[@"$os_version"] = UIDevice.currentDevice.systemVersion;
// 应用程序版本号
properties[@"$app_version"] = NSBundle.mainBundle.infoDictionary[@"CFBundleShortVersionString"];
return [properties copy];
}
/// 获取手机型号
- (NSString *)deviceModel {
size_t size;
sysctlbyname("hw.machine", NULL, &size, NULL, 0);
char answer[size];
sysctlbyname("hw.machine", answer, &size, NULL, 0);
NSString *results = @(answer);
return results;
}
第四步：实现 init 方法
- (instancetype)init {
self = [super init];
if (self) {
_automaticProperties = [self collectAutomaticProperties];
}
return self;
}
第五步：实现 -track:properties: 方法，用于触发事件
@implementation SensorsAnalyticsSDK (Track)
- (void)track:(NSString *)eventName properties:(nullable NSDictionary<NSString *, id> *)properties {
NSMutableDictionary *event = [NSMutableDictionary dictionary];
// 设置事件名称
event[@"event"] = eventName;
// 事件发生的时间戳，单位毫秒
event[@"time"] = [NSNumber numberWithLong:NSDate.date.timeIntervalSince1970 *1000];
NSMutableDictionary *eventProperties = [NSMutableDictionary dictionary];
// 添加预置属性
[eventProperties addEntriesFromDictionary:self.automaticProperties];
// 添加自定义属性
[eventProperties addEntriesFromDictionary:properties];
// 设置事件属性
event[@"propeerties"] = eventProperties;
// 打印
[self printEvent:event];
}
@end
- (void)printEvent:(NSDictionary *)event {
#if DEBUG
NSError *error = nil;
NSData *data = [NSJSONSerialization dataWithJSONObject:event options:NSJSONWritingPrettyPrinted error:&error];
if (error) {
return NSLog(@"JSON Serialized Error: %@", error);
}
NSString *json = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
NSLog(@"[Event]: %@", json);
#endif
}
第六步：修改 SensorsSDK.h 文件
在 SensorsSDK.h 文件中导入 SensorsAnalyticeSDK。
#import "SensorsAnalyticsSDK.h"
第七步：修改 Headers
依次选择 SensorsSDK -> Build Phases -> Headers，然后将 Project 下的 SensorsAnalyticsSDK.h 头文件拖到 Public 下
6、Demo 集成埋点 SDK
第一步：在 AppDelegate.m 文件的头部导入 SDK 头文件
#import <SensorsSDK/SensorsSDK.h>
第二步：初始化埋点 SDK
在 AppDelegate.m 文件的 - application: didFinishLaunchingWithOptions: 方法中初始化 SDK，并进行事件触发。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
[SensorsAnalyticsSDK sharedInstance];
[[SensorsAnalyticsSDK sharedInstance] track:@"MyFirstTrack" properties:@{@"testKey": @"testValue"}];
return YES;
}
第三步：测试验证
通过Xcode 启动 Demo，可以在 Xcode 控制台中看到如下事件信息。
2022-03-25 17:27:55.956029+0800 Demo[23382:685455] [Event]: {
"event" : "MyFirstTrack",
"time" : 1648200475955,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"testKey" : "testValue",
"$app_version" : "1.0",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
至此，一个非常基础的数据采集 SDK 框架完成。
