配置 TikTok 上报（Business SDK）

info

本页记录的是 TikTok Business SDK 统计通道，该通道使用独立的 TikTok Business SDK，数据上报至 TikTok For Business 广告管理平台。它与 AppLog 通道相互独立——AppLog 使用 TTGP 内置的 TikTok SDK，数据上报至 TTGP 后端。

新接入推荐使用 AppLog 通道，除非 TikTok 业务接口人要求使用 Business SDK 统计。

本文介绍如何配置 TikTok Business SDK 统计通道，使游戏可以通过 TikTok Business SDK 将分析数据上报至 TikTok。

前提条件

1. 创建一个 TikTok 账号，并在 TikTok For Business 中设置与配置您的应用。

2. 获取应用配置信息

1. 进入 TikTok For Business。

2. 选择您的应用。

3. 查看关于应用的详细信息。

   • ID：应用 ID
   • TikTok App ID：TikTok 应用 ID

   

步骤1：权限和工程配置

note

目前 TikTok 的事件上报仅支持 Android 端。

Android

用户权限

TikTok 需要添加 INTERNET 和 AD_ID 权限。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="com.google.android.gms.permission.AD_ID" />

工程配置

在 INTLConfig.ini 文件中添加以下配置：

[TikTok]
TIKTOK_EVENT_APPID = {TIKTOK_EVENT_APPID}
TIKTOK_EVENT_TT_APPID = {TIKTOK_EVENT_TT_APPID}

• 替换 {TIKTOK_EVENT_APPID} 为应用 ID，可以在 TikTok For Business 找到。
• 替换 {TIKTOK_EVENT_TT_APPID} 为 TikTok 应用 ID，可以在 TikTok For Business 找到。

步骤2：配置事件上报

TikTok SDK 会默认开启自动的事件追踪功能（包括应用安装，应用启动等）和客户端 ID（Android 为 Google 提供的广告 ID）采集功能。上报的数据一般只有事件名，也可以自行添加参数，在 管理端 可以看到上报数据的时间、设备系统、应用版本、值、参数信息。

自动报告事件

TikTok 事件：

事件	触发时机
LaunchApp	启动应用
InstallApp	首次启动应用
2DRetention	首次启动应用后的第二天再次启动应用

SDK 事件：

事件	触发时机
Registration	首次注册成功
Login	登录成功

手动报告事件

事件	触发时机
CreateRole	人物命名
CompleteTutorial	完成新手指南
Checkout	打开充值界面
Purchase	充值成功
Achieve Level	达成关卡
Unlock Achievement	解锁成就

有关 TikTok 事件报告的更多信息，请参见 支持的应用内事件列表。

步骤3：初始化分析模块

Unity

初始化分析模块，再调用 ReportEvent 开始 TikTok 上报数据。

Unreal Engine

初始化分析模块，再调用 ReportEvent 开始 TikTok 上报数据。

数据上报验收

管理端查看上报事件

caution

事件非实时上报，延迟为1小时以上。

进入 TikTok For Business，查看跟踪数据。

验收用例 1

• 子功能模块：Reporting
• 特性点：Event Reporting
• 测试点：TikTok 事件信息上报成功
• 前提条件：初始化分析模块
• 操作步骤/输入
  1. 请求 Report Event
  2. eventName = Report_Event, paramsDic-key1=k1, paramsDic-value1=v1, paramsDic-key2=k2, paramsDic-value2=v2, spChannels=TikTok
  3. 卸载安装 SDK 并启动游戏
  4. 管理端查看上报数据并导出 INSTALL 数据表
• 预期输出信息上报成功，检查如下：
  1. 管理端查看：
     1. 自定义事件：TikTok 可以查到上报自定义 Report_Event 事件数量加 1
     2. 安装事件：查看卸载安装 INSTALL 事件上报数量 +1（不清除设备只会上报一次）
  2. 导出数据验证：联系 [killuachen] 拉群导出日志来最终确认。
     1. 自定义事件：对应上报数据正确（管理端和导出数据可以对应上）install_time={installed_at} 比对，是不是安装时间。event_name={event_name} 自定义的事件。
     2. 安装事件：卸载安装 INSTALL 数据表安装 Installs 上报数量 +1（不清除设备只会上报一次） activity_kind={activity_kind} 会新增一个安装。

验收用例 2

• 子功能模块：ReportRevenue
• 特性点：TikTok 支付事件上报
• 测试点：请求 ReportRevenue 后查询上报（TikTok）
• 前提条件：网络连接正常
• 操作步骤/输入
  1. 请求 ReportRevenue
  2. eventName = （可自定义）, spChannels = TikTok, Currency = USD, Revenue = 100
  3. TikTok 查询上报事件
  4. DD平台 查询 AnalyticsReportRevenue 事件
• 预期输出信息上报成功，检查如下：
  1. TikTok 交付数据中查看 ReportRevenue 事件 +1。 ReportRevenue（revenue）事件金额 +100。
  2. 导出数据验证（2-4 小时）：导出数据包含收入事件，金额数据
  3. DD平台 成功查询 methodName 为 AnalyticsReportRevenue 与 method_id=715 事件上报。

常见问题

更多信息，请参见 常见问题。

错误码

更多信息，请参见 TikTok 帮助中心。