RudderStack 是一个开源的客户数据平台 (CDP)，可帮助企业收集、统一客户数据并将其发送到不同目的地。它为管理客户数据管道提供了一个集中式平台，使企业能够轻松地从网站、移动应用程序、服务器和云服务等各种来源收集数据。
Singular SDK 提供了许多标准"设备模式 "或"云模式 "集成选项无法提供的功能。
在使用 Rudderstack 与 Singular 时，建议采用混合方法进行集成，以充分利用 Singular 的所有特性和功能。
混合方法包括
- 独立于 Rudderstack实施 Singular SDK，允许 Singular SDK 处理会话跟踪，增加对 SDK 框架（React Native、Unity 等）、SkAdNetwork、深度链接和延迟深度链接以及高级功能的支持。
- 在 Rudderstack 中为单一目的地启用"云模式 "选项。这样，所有 Rudderstack 移动轨迹事件都会被发送到 Singular 目的地。
下面的说明阐述了如何使用 Rudderstack 配置 Singular 混合实现。
| 适用于 | 工程团队 |
| 前提条件 | 本文假设您 的应用程序中已经 集成了 Rudderstack Mobile SDK。 |
要使用此集成，您必须使用 Rudderstack 的移动 SDK。
Singular SDK 将提供以下支持：
- 安装归属
- 支持 SkAdNetwork
- 支持谷歌安装推荐人
- META 安装推荐人支持
- 苹果搜索广告归因
- 自定义应用内事件跟踪
- 收入跟踪
- 自定义用户 ID
- 全局属性支持
- 隐私选项
Rudderstack "云模式 "集成将提供以下支持：
- 自定义应用程序内事件跟踪
- 收入跟踪
- 自定义用户 ID
混合配置
-
集成 Singular SDK
独立于 Rudderstack 实施 Singular SDK。请点击此处查看 SDK 选项和框架。
-
启用 Rudderstack - Singular 目的地（云模式）
按照此处的指南进行操作。
建议的附加设置
使用混合方法时，建议将 Rudderstack AnonymousId 和 Rudderstack User ID 传递给 Singular 的 SDK。
请特别注意并小心实施 SDK 文档中的这些可选功能。根据你使用的框架，步骤可能会略有不同。
实现全局属性
将 RudderstackAnonymousId传递到 Singular 全局属性中。这将把 Rudderstack AnonymousId 与来自 SDK 的设备级数据关联起来。
全局属性应在初始化 Singular SDK 时配置，键值为rudderstack_anonymous_id 和从 Rudderstack SDK 获取的Rudderstack anonymousId的值。Rudderstack 匿名 ID 可通过此方法从 Rudderstack SDK 获取[iOS][Android]。
[RSClient getInstance].anonymousId;奇异 SDK 配置示例
- (SingularConfig *)getConfig {
// Get the 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
NSString* thirdPartyKey = @"rudderstack_anonymous_id";
NSString* thirdPartyValue = [RSClient getInstance].anonymousId;
// Singular Config Options
SingularConfig* config = [[SingularConfig alloc]
initWithApiKey:APIKEY andSecret:SECRET];
...
// Using Singular Global Properties feature to capture 3rd-party identifiers
[config setGlobalProperty:thirdPartyKey
withValue:thirdPartyValue overrideExisting:YES];
...
return config;}// (Optional) Get 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
String thirdPartyKey = new String("rudderstack_anonymous_id");
String thirdPartyValue = new String(RudderClient.getInstance()?.anonymousId);
// Singular Config Options
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
.withGlobalProperty(thirdPartyKey, thirdPartyValue, true);实现自定义用户 ID
将 Rudderstack UserId 传入 Singular Custom User ID 方法。这将把 Rudderstack UserId 与来自 SDK 的设备级数据关联起来。在 Singular SDK 初始化时，在 Singular Config 对象中向 Singular 提供此值也将允许 Singular 在安装回传时向 Rudderstack 发送 UserId。请阅读更多有关您用于 Singular 集成的 SDK 框架文档。iOS][Android]示例
此外，用户 ID 将与 Singular SDK 原生触发的任何应用内事件相关联。
对于接收到的 "云模式 "事件，Singular 已将自定义用户 ID映射到 Rudderstack 用户 ID 值。