跳到主要内容

配置 TikTok 上报

本文旨在介绍如何设置 TikTok 分析平台，让您的游戏可以直接将分析数据上报至 TikTok。

前提条件​

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

  1. 进入 TikTok For Business。

  2. 选择您的应用。

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

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

    图片: TikTok App ID

步骤1：权限和工程配置​

注意

目前 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）采集功能。上报的数据一般只有事件名，也可以自行添加参数，在 管理端 可以看到上报数据的时间、设备系统、应用版本、值、参数信息。

自动报告事件​

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

手动报告事件​

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

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

步骤3：初始化分析模块​

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

数据上报验收​

管理端查看上报事件​

警告

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

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

图片：验证 1 图片：验证 2

验收用例 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 渠道事件上报默认开启 Debug 模式。管理端数据的更新依赖于后台计算的实时性。一般情况下，几分钟到十几分钟可以完成更新，但是也有隔天更新的情况。如果半个小时内看不到数据更新，请隔天查看。

错误码​

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

最后于 更新