面向开发者的客户数据平台

网站 · 文档 · 社区 Slack


RudderStack iOS SDK

RudderStack 的 iOS SDK 允许您跟踪来自 iOStvOS 应用程序的事件数据。 集成 SDK 后,您还可以将这些事件发送到您喜欢的目标位置,例如 Google Analytics、Amplitude 等。

有关 iOS SDK 的详细文档,请点击此处

安装 iOS SDK

iOS SDK 可通过 CocoaPodsCarthageSwift Package Manager (SPM) 获取。

CocoaPods

要安装 SDK,只需将以下行添加到您的 Podfile 中

pod 'Rudder', '1.31.0'

Carthage

为了支持 Carthage,请将以下行添加到您的 Cartfile

github "rudderlabs/rudder-sdk-ios" "v1.31.0"

请记住在所有要引用或使用 RudderStack SDK 类的 .m.h 文件中包含以下代码,如下所示

#import <Rudder/Rudder.h>

Swift Package Manager (SPM)

您还可以通过以下两种方式之一通过 Swift Package Manager 添加 RudderStack iOS SDK

Xcode

Adding a package

Setting dependency

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: "git@github.com:rudderlabs/rudder-sdk-ios.git", from: "1.31.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 的共享实例可以在初始化后通过 [RSClient sharedInstance] 访问。

发送事件

Track(追踪)

[[RSClient sharedInstance] track:@"simple_track_event"];
[[RSClient sharedInstance] track:@"simple_track_with_props" properties:@{
    @"key_1" : @"value_1",
    @"key_2" : @"value_2"
}];

Screen(屏幕)

[[RSClient sharedInstance] screen:@"Main" properties:@{@"prop_key" : @"prop_value"}];

Identify(识别)

[[RSClient sharedInstance] identify:@"test_user_id"
                             traits:@{@"foo": @"bar",
                                      @"foo1": @"bar1",
                                      @"email": @"test@gmail.com"}
];

Group(分组)

[[RSClient sharedInstance] group:@"sample_group_id"
                          traits:@{@"foo": @"bar",
                                   @"foo1": @"bar1",
                                   @"email": @"test@gmail.com"}
];

Alias(别名)

[[RSClient sharedInstance] alias:@"new_user_id"];

Reset(重置)

[[RSClient sharedInstance] reset];

有关 iOS SDK 的详细文档,请点击此处

贡献

我们非常欢迎您为该项目做出贡献。 有关如何贡献的更多信息,请点击此处

关于 RudderStack

RudderStack 是一个面向开发者的客户数据平台。 我们的工具可以轻松部署管道,从每个应用程序、网站和 SaaS 平台收集客户数据,然后在您的数据仓库和业务工具中激活它。

有关 RudderStack 的更多信息,请点击此处

联系我们

有关使用 RudderStack iOS SDK 的更多信息,您可以联系我们或在我们的Slack频道上发起对话。