如何集成TikTok应用事件SDK

准备工作

你需要一个 TikTok 广告账号和 TikTok 应用 ID 才能使用 Android 和 iOS 版本的 TikTok 应用事件 SDK。你可以使用现有应用，也可以新建一个应用。

注意：同一个广告账号不支持同时使用 TikTok 应用事件 SDK 和 MMP。请新建一个 TikTok 广告账号，将 TikTok 应用事件 SDK 集成到新的广告账号，而不使用 MMP。

如何集成 TikTok 应用事件 SDK

第 1 步：在 TikTok 事件管理工具中创建一个应用，并生成 TikTok 应用 ID。

1. 在 TikTok 广告管理平台上，依次点击“工具”选项卡和“事件”，进入事件管理工具。

2. 选择右上方导航栏中的“关联数据来源”。

3. 选择“应用”，然后继续。

4. 填写你的应用详细信息。

5. 选择“使用 TikTok 事件 SDK”，然后继续。现在，应用已创建成功。

6. 生成你的 TikTok 应用 ID。

第 2 步：按照 TikTok 开发者中心指南中的操作说明，集成 TikTok 应用事件 SDK。

1. 有关可以记录的标准应用事件和自动记录事件的完整列表，请参阅：标准事件。

2. 下方列出了自动记录事件。注意：你可以关闭自动记录事件。如需查看详情，请参阅应用事件 SDK 开发者文档。

   1. LaunchApp：应用启动时。

   2. InstallApp：应用首次启动时。

   3. 2DRetention：应用在首次启动后的次日再次启动。

3. [仅限 iOS] 在 TikTok 事件管理工具 (TTEM) 中配置 SKAN 转化值方案。

   1. 必须在 TTEM 中设置转化值方案才能接收 SKAN 转化量数据。TikTok 支持通过 SKAN 3.0 实现 64 位转化值的映射，对 SKAN 4.0 方案映射的支持仍处在 Beta 测试阶段。

   2. [最佳实践]在 SKAdNetwork (SKAN) 环境中，建议只使用一种 SDK 来报告转化值。如果你要使用 MMP 或其他 SDK 来向 SKAdNetwork 更新转化值，你需要：

      1. 沿用 MMP 上设置的值来配置 TTEM 转化值 (CV) 方案。

      2. 实施 disableSKAdNetworkSupport() 功能可避免通过 TikTok 应用事件 SDK 来更新转化值。

第 3 步：使用调试模式实时验证回传。

1. 你可以在应用中启用调试模式，实时验证和调试事件回传和相关参数。如需查看事件，请前往 TikTok 事件管理工具内应用下方的“测试事件”选项卡。

注意：

• 测试事件支持同时测试多个 TikTok 应用 ID。不过，如果同时测试多个 TikTok 应用 ID，所有来自不同 TikTok 应用 ID 的测试事件都将显示在第一个关联的 TikTok 应用 ID 所属的广告账号中的“测试事件”选项卡下。

• 验证完信号设置后，请先关闭调试模式再将应用发布到 App Store/Play 商店。调试模式关闭后，测试事件最长可显示 72 小时。如果 72 小时后在“测试事件”选项卡中仍能看到事件，那么调试模式仍未关闭。查看下方示例：

调试模式：开启

调试模式：关闭

第 4 步：将集成了 TikTok SDK 的新版应用发布到 App Store (iOS)/Play 商店 (Android)。

第 5 步：投放使用 TikTok SDK 的推广系列。

如果在集成应用事件 SDK 的过程中遇到任何问题或困难，你可以提交客户支持工单。确保在选择问题类别时依次选择“度量”和“应用事件 SDK”。