集成 Singular SDK：规划和前提条件

关注
Avatar
Jared Ornstead
Updated
文档

以下是任何 Singular SDK 集成所 需的初步步骤。

了解如何规划 SDK 集成、注册开发应用程序、创建用于跟踪链接的域，以及如何在开发期间和之后测试集成。

适用指南 业务/营销团队
1

规划 SDK 集成

在开始集成 Singular SDK 之前，营销/业务团队应回答以下问题。这可以让开发团队知道要启用哪些 SDK 特性和功能。

该应用程序是否明确针对儿童？

儿童应用程序必须遵守 Play Store 和 App Store 政策，以保护儿童隐私。我们建议使用Singular 的儿童应用程序 SDK，它不会捕获设备标识符，有助于您遵守这些政策。

应用程序能否处理深层链接？

请按照Singular Links Prerequisites中的说明进行操作，然后按照相关 SDK 指南中的解释在代码中实现深层链接处理程序。

应用程序会跟踪用户事件吗？

Singular可以收集应用内事件的相关数据，帮助分析营销活动的效果并衡量关键绩效指标（KPI）。例如，您的组织可能希望收集有关用户登录、注册、教程完成或游戏应用中等级提升的数据。

标准事件

Singular 支持各种 标准事件。广告网络通常支持这些常用事件，用于报告和优化。另一个优点是，当你使用标准事件名称时，Singular 会自动识别并将其添加到事件列表中，而无需手动定义。我们建议尽可能使用标准事件。

对于每个标准事件，你都应该传递标准推荐属性。例如，对于sng_content_view事件（客户查看产品），你应该传递sng_attr_content_type、sng_attr_content_id 和sng_attr_content 等属性。

发送到 Singular 的事件列表（附带属性）应由UA/市场营销/业务团队根据市场营销关键绩效指标编制。以下指南有助于制定活动策略：

重要提示： 在应用程序中集成 Singular SDK 时，您的开发团队可能需要根据开发平台使用略有不同的事件/属性名称（全大写、无下划线等）。请查看 iOS、 Android、 Unity、 React 和 Flutter 的事件和属性名称列表。

自定义事件

如果您想测量与 Singular 标准事件不匹配的事件，您可以使用自定义名称定义自己的自定义事件。

开发团队可以使用任何自定义名称（最多 32 个字符）。我们建议使用英文名称，以便与可能从 Singular 接收事件进行优化的广告网络合作伙伴兼容。

提示： 只有在需要出于营销相关目的对事件进行跟踪时，才向 Singular 发送事件。如果某个事件对营销活动绩效或用户价值的关键绩效指标（KPI）不重要，则Singular不应跟踪该事件。

(iOS）应用程序将实施 SKAdNetwork 吗？

您可以使用 SDK 方法在托管模式（转换值由 Singular 更新）或手动模式（您自己更新转换值）下启用 SKAN。

(iOS）应用程序是否会要求用户同意共享跟踪信息（ATT）？

我们建议显示 ATT 提示，因为如果用户选择共享设备 ID，这将有助于正确归属安装。

如果显示 ATT 提示，则应配置 SDK 以延迟应用程序中 Singular 的初始化，直到用户做出回应。
2

注册开发/测试应用程序

应用程序捆绑标识符

生产和测试应用程序使用相同的 SDK 密钥和秘钥。一旦测试/生产数据保存在 Singular 中，就无法删除。

考虑到这一点，我们建议为测试应用程序使用不同的捆绑标识符，以便将数据与最终的生产应用程序分开。

例如，如果您的生产应用程序使用com.myapp 这个捆绑标识符，您可以在开发阶段使用com.myapp.dev 。然后，在应用程序商店发布应用程序之前，您可以将捆绑标识符改回生产版本。

注册应用程序的步骤

  1. 在 Singular 平台，进入"设置">"应用程序"，点击 "添加新应用程序"。
  2. 为开发应用程序输入一个应用程序名称。建议使用捆绑 ID。
  3. 选择与应用程序平台相对应的操作系统。
  4. 使用捆绑 ID选项识别应用程序，并输入开发版本的捆绑标识符。保存应用程序。
  5. 对于 iOS 应用程序： 保存应用程序后，单击应用程序名称旁边的箭头查看应用程序详细信息，并切换 "显示高级设置"选项。添加您的TeamID 和方案。这是通用链接和深度链接所必需的。

完成应用程序的开发和测试后，将捆绑 ID 更新为生产版本，并让营销团队根据应用程序配置常见问题解答中的说明添加生产应用程序。
3

创建链接域（如果还没有的话）

奇异链接（奇异跟踪链接）的结构如下，其中 [SUBDOMAIN] 由您选择：

https://[SUBDOMAIN].sng.link/[PARAMETERS]

例如，对于一个营销名为 Jewel Rush 的应用程序的营销活动，您可以创建域名 "jewelrush.sng.link"。然后，您就可以用它来创建具有以下结构的跟踪链接：

https://jewelrush.sng.link/[PARAMETERS]

您可以使用一个域来创建所有链接，也可以创建多个域用于不同目的。无论如何，在使用奇异跟踪链接之前，至少需要一个域。

企业的营销团队应参与链接域的决定，因为它将在营销活动中曝光。

在 iOS 应用程序中集成 Singular SDK 时，必须在 Xcode 关联域设置中以以下形式添加链接域：

applinks:[DOMAIN].sng.link

另请参阅：奇异链接 前提条件
4

了解如何测试集成

在将 Singular SDK/S2S 集成到应用程序中时，重要的是在新版本应用程序上线之前确保其正常运行。

Singular 提供了一系列测试集成的工具：

实施过程中的测试：

实施后测试：

  • 运行 SDK 审计报告，自动识别集成中的任何问题，并推荐可靠的解决方案。
  • 使用导出日志页面下载用户级数据。CSV 文件会显示从应用程序成功发送到 Singular 的所有数据。请注意，数据在此工具中可用大约需要 30 分钟。
  • 按照 "如何测试 Singular SDK 集成"中的说明测试深度链接。
  • 测试后，使用归因详情 API查询设备详情。大约需要 4-6 分钟才能获得归因数据。了解更多信息。

有关更多测试技巧，请参阅《如何测试 Singular SDK 集成》。