如何集成 TikTok 应用事件 SDK

准备工作

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

注意：同一个账号现支持同时设置 TikTok 应用事件 SDK 和 MMP。你可以新建 TikTok 广告账号或使用现有 MMP 账号集成 SDK。

如何集成 TikTok 应用事件 SDK

第 1 步：创建应用或使用现有应用，并生成 TikTok 应用 ID 和应用密钥

选项 1：将 SDK 添加到已关联 MMP 的应用（混合设置）

1. 登录 TikTok 广告管理平台。

2. 点击工具选项卡，然后点击事件管理工具。

3. 选择数据来源，然后选择要关联 SDK 的应用。

   
   
   

4. 前往设置选项卡，点击 TikTok 应用事件 SDK 下的选择合作伙伴。

   
   
   

5. 按照流程将 SDK 添加到账号。生成 TikTok 应用 ID 和应用密钥。

   

选项 2：将 SDK 添加到新创建的应用

1. 登录 TikTok 广告管理平台。

2. 点击工具选项卡，然后点击事件管理工具。

3. 选择左上角导航栏中的关联数据来源，并选择应用。

   
   
   

4. 选择 TikTok SDK 以关联你的应用。

   
   
   

5. 提供应用详细信息并创建应用。按照流程生成 TikTok 应用 ID 和应用密钥。

   
   
   

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

1. 要初始化 SDK，你需要提前在第 1 步中获取应用 ID、TikTok 应用 ID 和应用密钥。

   1. 获取应用 ID 和 TikTok 应用 ID 的演示：

      
      
      

   2. 获取应用密钥的演示：

      
      
      

2. 在 GitHub 下载 SDK。目前支持原生 iOS SDK、原生 Android SDK、Unity SDK。

第 3 步：通过 SDK 回传事件

1. 如需了解可记录的标准应用事件和自动记录事件的完整列表，参见标准事件。

2. 下方列出了自动记录事件。注意：你可以关闭自动记录事件。如需了解更多信息，参见应用事件 SDK 开发者文档。

   1. 打开应用：用户打开应用时。

   2. 安装应用：用户首次打开应用时。

   3. 次日留存：用户首次打开应用后的第二天再次打开应用。

   4. 付费：用户为消耗品/非消耗品/订阅成功付款。

      1. 在启用自动记录付费事件回传前，确保其符合你的业务需求。详细了解 iOS 自动记录付费事件和 Android 自动记录付费事件。

关于自动记录付费事件的特别说明：SDK 可以自动捕捉通过 StoreKit (iOS) 或 Google Play 结算 (Android) 完成的交易。如需传入更多属性和参数，或者如果你使用的不是 Apple 或 Google 原生支付入口，建议使用手动付费事件回传。

第 4 步：[iOS] 度量 SKAN 事件

在 SKAdNetwork (SKAN) 环境中，建议只使用一种 SDK 来报告转化价值。如果你使用 MMP 或其他 SDK 向 SKAdNetwork 更新转化价值，务必在配置中添加 disableSKAdNetworkSupport() 以避免更新冲突。

确定是否需要启用 TikTok SDK SKAN 度量：

如果拥有 MMP：

• MMP SDK 更新转化价值 (CV)，并且你打算使用 MMP 的 SKAN 架构：关闭 TikTok SDK 的 SKAdNetwork 支持，并且不要将架构上传到 TikTok 事件管理工具。 （你的 MMP 仍是 CV 更新和架构的唯一可信来源。）

如果没有 MMP：

确保你的应用中只有一个 SDK 用于更新 SKAN 转化价值。

• 其他非 MMP SDK 更新 CV：在 TikTok SDK 中关闭 SKAdNetwork 支持，但需将架构上传到 TikTok 事件管理工具。 （TikTok 将使用你的架构，但不会执行重复的 CV 更新。）

• TikTok SDK 负责更新 CV：在 TikTok SDK 中启用 SKAdNetwork 支持，并将架构上传到 TikTok 事件管理工具。 （TikTok 成为 SKAN CV 更新的主要处理方。）

如需了解更多信息，参见应用事件 SDK 开发者文档。

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

自 SDK 版本 1.5.0 起，用户可在发布前通过两种方式验证 SDK 集成：

• （推荐）基于令牌的测试事件模式；该模式全程在 TikTok 事件管理工具中完成，无需修改代码。

• 手动调试模式，需修改代码。使用手动调试模式时，务必在发布应用前关闭调试模式。使用上述任一工具生成的事件会经过测试流程，不可用于报告。

  • 调试模式：开启

    

    调试模式：关闭

    

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

在 TikTok 开始接收来自 SDK 的实时信号后，你就可以看到 SDK 事件显示在事件管理工具的报告选项卡中。测试模式下的信号不会在该处显示。

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

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