Singular可通过Singular服务器到服务器（S2S）REST API接收来自Segment的事件数据，用于iOS和安卓移动活动。这被称为"云模式 "目的地。下面的说明介绍了如何在 Segment 中添加 Singular 目的地。
| 工程团队指南 | 工程团队 |
| 前提条件 | 本文假定您已将 Segment iOS 或 Android Analytics SDK 集成到您的应用程序中。 |
要使用此集成，您必须使用 Segment 的移动分析 SDK。此集成与非移动事件数据不兼容。不支持服务器或网络事件。
如果您需要Singular提供的 "完整特性功能 "的S2S支持，您必须独立于Segment实施Singular S2S REST API。 请参见此处的服务器到服务器（S2S）集成指南。
开始使用
- 在 Segment 网络应用程序中，点击 "连接 "菜单下的 "目录"。
- 在目录中搜索"Singular"，选中后点击 "添加目的地 "按钮。
- 选择要将目的地连接到的源，然后单击 "下一步"。
- 为目的地命名，然后点击 "创建目的地"。
- 在 Singular 控制面板的" 开发工具 > SDK 集成 > SDK 密 钥"下获取 Singular "SD K 密钥"，并将其添加到 "连接设置 "部分的 "API 密钥 "下。
注意：对于 "云模式 "集成，您只需输入 API 密钥（SDK 密钥）值。
秘密 "留空。
重要： 请确保在 Segment 中的 API 密钥值使用单一 SDK 密钥。如果使用了错误的密钥，Singular 将不会收到任何数据。
其他设置
苹果搜索广告归属支持
注： 如果您使用的是 "基于设备的目的地"（Device-Based Destination），则无需执行下面的代码，因为数据已经自动收集。
要在 Singular 中获取归因数据，必须包含analytics-ios-iads-attribution依赖项和 3.6.0 或更高版本的Analytics SDK。
要安装它，只需在 Podfile 中添加以下一行：
pod "Analytics"
pod "Analytics-iAds-Attribution"然后导入头文件并初始化配置：
#import <Analytics-iAds-Attribution/SEGADTracker.h>
// Initialize the configuration as you would normally.
SEGAnalyticsConfiguration *configuration = [SEGAnalyticsConfiguration
configurationWithWriteKey:@"YOUR_WRITE_KEY"];
...
// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = @[ [SEGADTracker middleware] ];
[SEGAnalytics setupWithConfiguration:configuration];import Analytics-iAds-Attribution
// Initialize the configuration as you would normally.
var configuration = SEGAnalyticsConfiguration(writeKey: "WriteKey")
...
// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = [SEGADTracker.middleware()]
SEGAnalytics.setup(with: configuration)当 iAd 信息可用时，归属信息会以这种方式转换为 Segment 上下文：
[analytics track:@"Application Installed",
properties: nil,
options: @{
@"context" : @{
@"campaign" : @{
@"provider" : @"Apple",
@"click_date" : attributionInfo[@"iad-click-date"],
@"conversion_date" : attributionInfo[@"iad-conversion-date"],
@"source" : @"iAd",
@"name" : attributionInfo[@"iad-campaign-name"],
@"content" : attributionInfo[@"iad-keyword"],
@"ad_creative" : attributionInfo[@"iad-org-name"],
@"ad_group" : attributionInfo[@"iad-adgroup-name"],
@"id" : attributionInfo[@"iad-campaign-id"],
@"ad_group_id" : attributionInfo[@"iad-adgroup-id"]
}
}
}];Singular 明确映射了应用程序安装生命周期事件，以提供 iAd 信息。
安装归因
使用初始化配置参数（iOS、Android）启用自动跟踪生命周期事件（应用程序已打开、应用程序已安装、应用程序已更新），以便在 Singular 中跟踪安装和会话。只要包含上述事件，Singular "会话 "将由集成自动发送。
跟踪自定义事件
如果你对 Segment Specs 不熟悉，请看一看了解Track 方法的作用。
使用 Segment 跟踪功能将事件翻译并发送到 Singular：
[[SEGAnalytics sharedAnalytics] track:@"simple event"];Analytics.with(this).track("event_name");Segment 会将所有事件属性作为 Singular 事件的回调参数。
这些事件可用于报告和用户级导出。
收入跟踪
当发送包含收入属性（包括零值）的事件时，Singular 将接收收入跟踪。您可以选择传递货币（作为ISO 4217 货币代码）。默认货币为美元。
[[SEGAnalytics sharedAnalytics] track:@"segment revenue event" properties:@{@"currency": @"USD", @"revenue":@20}];Analytics.with(this).track("purchase", new Properties().putRevenue(2.5).putValue("currency","USD"));注意：以三个字母的 ISO 4217 货币代码形式传递货币，如 "USD"、"EUR"、"INR"。
自定义用户 ID
您可以使用Segmentidentify方法向Singular发送您的Segment用户ID。
注意：如果使用Singular的跨设备解决方案，必须在所有平台上收集相同的用户ID。
- 用户 ID 可以是任何标识符，但不能暴露 PII（个人身份信息），例如，不能使用用户的电子邮件地址、用户名或电话号码。Singular 建议使用仅对第一方数据唯一的哈希值。
- 传递给Singular的用户ID值也应该是你在所有平台（Web/移动/PC/控制台/离线）上获取的相同的内部用户ID。
- Singular 将在用户级导出、ETL 和内部 BI 回传（如果配置）中包含用户 ID。用户 ID 是第一方数据，Singular 不会与其他方共享。
- 用户 ID 值设置后将一直存在，直到使用 "分段重置"方法取消设置或卸载应用程序为止。关闭或重启应用程序不会取消设置用户 ID。
请按照以下步骤进行配置：iOS、Android。
[[SEGAnalytics sharedAnalytics] identify:@"segment custom user id"];Analytics.with(context).identify("myUserId");要取消设置自定义用户 ID，请调用重置方法。
[[SEGAnalytics sharedAnalytics] reset];