完整配置示例

全面的 SDK 配置

下面的示例演示了如何通过多个选项配置 Singular SDK。可通过SingularSDKObject GameObject 上的 Unity 检查器进行配置。

SingularSDKObject 检查器面板

品牌域

为网络到应用程序属性设置品牌域。这样，Singular SDK 就能识别自定义跟踪域，并允许打开应用程序。

使用示例

yourcompany.com

go.yourcompany.com

promo.yourcompany.com

剪贴板归属

使用此复选框可启用 iOS 的剪贴板归因功能。启用后，SDK 会在应用程序启动时读取剪贴板以检测归因链接。

收集 OAID

选中此复选框可启用在 Android 设备上收集 OAID（开放式匿名设备标识符）。在无法使用 Google Advertising ID 的地区，OAID 可用作替代标识符。仅限 Android。

Ddl 超时秒数

设置延迟深度链接解析的超时（秒）。默认值为 60 秒。

启用日志记录

选中此复选框可启用 SDK 日志。启用后，SDK 将输出调试信息，以帮助集成和故障排除。在生产构建中应禁用。

启用带超时间隔的 ODM

启用 ODM（On-Device Matching，设备匹配），指定超时间隔（以秒为单位）。ODM 可通过匹配设备指纹实现更准确的归属。设为 -1 则禁用。

Facebook 应用 ID

为 Facebook 归因整合设置 Facebook App ID。这将使 SDK 能够跟踪 Facebook 营销活动归因。仅限 Android。

唤醒时初始化

决定 GameObject 唤醒时 SDK 是否应自动初始化。如果设置为 false，则必须手动调用InitializeSingularSDK() 来初始化 SDK。

限制广告标识符

在混合受众应用程序中启用限制广告标识符模式。 此选项会影响 SDK 收集和使用设备标识符进行跟踪的方式。如果启用，则不会收集广告标识符。

日志级别

设置 SDK 日志的日志级别。有效值为0（无）、1（错误）、2（警告）、3（信息/调试）、4（详细）。数值越高，日志输出越详细。

手动 SKAN 转换管理

启用手动 SKAdNetwork 转换值管理。启用后，必须使用 SkanUpdateConversionValue() 手动更新转换值。

推送通知链接路径

指定可在推送通知有效载荷中找到深度链接 URL 的 JSON 路径。这样，SDK 就能从推送通知中提取并处理深层链接。

notification/deep_link

data/url

custom_link

会话超时秒数

以秒为单位设置会话超时。这将决定应用进入后台后用户会话的持续时间。默认值为 60 秒。

短链接解决超时

设置短链接解析超时（以秒为单位）。这决定了 SDK 等待短链接解析的时间。默认值为 10 秒。

奇异 API 密钥

设置应用程序的奇异 API 密钥。这是一个必要的配置值，用于在 Singular 平台上识别您的应用程序。您可以在 Singular 面板中找到您的 API 密钥。

Singular API 密钥

为您的应用程序设置 Singular API Secret。这是必要的配置值，与 API 密钥一起用于安全通信。您可以在 Singular 面板中找到您的 API Secret。

启用 SKAN

启用或禁用 SKAdNetwork 功能。启用后，SDK 将自动注册 SKAdNetwork 归属并管理转换值。

等待跟踪授权超时间隔

设置在初始化 SDK 之前等待 ATT（App Tracking Transparency）授权的超时（以秒为单位）。设置为 0 表示不等待。