开发者的客户数据处理平台
RudderStack iOS SDK
RudderStack 的 iOS SDK 允许您跟踪您 iOS 和 tvOS 应用程序的事件数据。在集成 SDK 之后，您还将能够将这些事件发送到您偏好的目的地，如 Google Analytics、Amplitude 等。
有关 iOS SDK 的详细文档，请点击此处。
安装 iOS SDK
iOS SDK 可以通过 CocoaPods、Carthage 和 Swift 包管理器 (SPM) 获得。
CocoaPods
要安装SDK，只需将以下行添加到您的Podfile中
pod 'Rudder', '1.16.0'
Carthage
为了支持Carthage，将以下行添加到您的Cartfile
github "rudderlabs/rudder-sdk-ios" "v1.16.0"
请记得，您需要在所有希望引用或使用RudderStack SDK类的
.m和.h文件中包含以下代码，如下所示
#import <Rudder/Rudder.h>
Swift Package Manager (SPM)
您还可以通过以下两种方式之一通过Swift Package Manager添加RudderStack iOS SDK
Xcode
- 转到文件 - 添加包，如图所示
-
在搜索栏中输入包仓库（
[email protected]:rudderlabs/rudder-sdk-ios.git）。 -
在依赖规则中，选择到下一个主要版本，并将
1.16.0作为值输入，如图所示
-
选择您想要添加包的项目。
-
最后，单击添加包。
Swift
为了利用package.swift，在您的项目中使用以下片段
// swift-tools-version:5.5
// The swift-tools-version declares the minimum version of Swift required to build this package.
import PackageDescription
let package = Package(
name: "RudderStack",
products: [
// Products define the executables and libraries a package produces, and make them visible to other packages.
.library(
name: "RudderStack",
targets: ["RudderStack"]),
],
dependencies: [
// Dependencies declare other packages that this package depends on.
.package(url: "[email protected]:rudderlabs/rudder-sdk-ios.git", from: "1.16.0")
],
targets: [
// Targets are the basic building blocks of a package. A target can define a module or a test suite.
// Targets can depend on other targets in this package, and on products in packages this package depends on.
.target(
name: "RudderStack",
dependencies: [
.product(name: "Rudder", package: "rudder-sdk-ios")
]),
.testTarget(
name: "RudderStackTests",
dependencies: ["RudderStack"]),
]
)初始化 RudderStack 客户端
要初始化 RSClient，将以下代码放入您的 AppDelegate.m 文件中的 didFinishLaunchingWithOptions 方法下。
RSConfigBuilder *builder = [[RSConfigBuilder alloc] init];
[builder withDataPlaneUrl:<DATA_PLANE_URL>];
[RSClient getInstance:<WRITE_KEY> config:[builder build]];
初始化后，可以通过 [RSClient sharedInstance] 访问 RSClient 的共享实例。
发送事件
跟踪
[[RSClient sharedInstance] track:@"simple_track_event"];
[[RSClient sharedInstance] track:@"simple_track_with_props" properties:@{
@"key_1" : @"value_1",
@"key_2" : @"value_2"
}];
屏幕
[[RSClient sharedInstance] screen:@"Main" properties:@{@"prop_key" : @"prop_value"}];
标识
[[RSClient sharedInstance] identify:@"test_user_id"
traits:@{@"foo": @"bar",
@"foo1": @"bar1",
@"email": @"[email protected]"}
];
组
[[RSClient sharedInstance] group:@"sample_group_id"
traits:@{@"foo": @"bar",
@"foo1": @"bar1",
@"email": @"[email protected]"}
];
别名
[[RSClient sharedInstance] alias:@"new_user_id"];
重置
[[RSClient sharedInstance] reset];
有关 iOS SDK 的详细文档，请点击此处。
贡献
我们非常希望能看到您为这个项目做出贡献。更多关于如何贡献的信息，请访问这里。
关于 RudderStack
RudderStack 是一个为开发者提供的客户数据平台。我们的工具可以轻松部署收集来自每个应用程序、网站和 SaaS 平台的客户数据的管道，然后在您的仓库和业务工具中激活这些数据。
关于RudderStack的更多信息，请参阅这里。