前提条件

要求	说明
iOS 或 Android 应用程序	此集成支持 iOS 和 Android 应用程序。根据平台的不同，应用程序中可能需要代码片段。有关这些要求的详细信息，请参阅集成流程的第 1 步。
Singular SDK 和 Braze SDK	除所需的Braze SDK外，您还必须安装Singular SDK。

集成

要完成Braze集成，您需要更新您的Singular SDK集成，并通过Singular的全局属性传递Braze设备ID。请参阅我们关于全局属性的SDK文档（Android SDK文档和iOS SDK文档）。

步骤 1：映射用户 ID

安卓

如果您有安卓应用程序，则需要包含以下代码段，将唯一的Braze用户ID传递给Singular。

// Retrieve the Braze deviceId

val brazeDeviceID = Braze.getInstance(context).deviceId

// Set the Singular Global Property in the Singular Config

val config = SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true)

// Retrieve the Braze deviceId

String brazeDeviceID = Braze.getInstance(context).getDeviceId();

// Set the Singular Global Property in the Singular Config

SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true);

安卓

重要：

在2023年2月之前，我们的Singular归因整合使用IDFV作为主要标识符来匹配iOS归因数据。使用Objective-C的Braze客户无需获取Braze device_id并在安装时发送至Singular，因为服务不会中断。

对于使用 Swift SDK v5.7.0+ 的用户，如果希望继续使用 IDFV 作为相互标识符，则必须确保useUUIDAsDeviceId 字段设置为false ，以便不会中断集成。

如果设置为true ，则必须为Swift实现iOSdevice ID 映射，以便在应用程序安装时将Braze device_id传递给Singular，使Braze与iOS属性适当匹配。

// Retrieve the Braze deviceId

let brazeDeviceId = AppDelegate.braze?.deviceId

// Set the Singular Global Property in the Singular Config

config.setGlobalProperty("brazeDeviceId", withValue: brazeDeviceId, overrideExisting: true)

// Retrieve the Braze deviceId

NSString *brazeDeviceId = ((AppDelegate *)[UIApplication sharedApplication].delegate).braze.deviceId;

// Set the Singular Global Property in the Singular Config

[config setGlobalProperty:@"brazeDeviceId" withValue:brazeDeviceId overrideExisting:YES];

第2步：获取Braze数据导入密钥

在 Braze 中，导航至Partner Integrations > Technology Partners 并选择Singular。

注：如果您使用的是旧版导航，可在 "集成 "下找到 "技术合作伙伴"。

在此，您将找到 REST 端点并生成 Braze 数据导入密钥。生成密钥后，您可以创建新密钥或使现有密钥失效。

您需要向Singular客户经理提供数据导入密钥和REST端点，以完成集成。

第3步：启用Braze回传功能

在Singular中，从左侧菜单导航至 "属性">"合作伙伴配置"。

点击"添加合作伙伴"按钮，搜索"Braze"。
选择您的应用程序
输入上一步收到的 Braze 数据导入密钥
选择 Braze 域名
点击保存

第四步：确认整合

一旦Braze收到来自Singular的归因数据，Braze中Singular技术合作伙伴页面上的状态连接指示器将从 "未连接 "变为 "已连接"。最后一次成功请求的时间戳也将包含在内。

请注意，这要等到我们收到归属安装的数据后才会发生。有机安装应排除在 Singular 回传之外，会被我们的 API 忽略，在确定是否建立成功连接时也不会计算在内。