TikTok AppLog

Important

请勿自行接入。TikTok 渠道需与 TikTok 侧建立正式合作后方可注册应用、获取用于接入的配置。如需接入，请先咨询业务接口人。

Player Network 将 TikTok AppLog 作为一个即发即弃（fire-and-forget）的事件上报通道。该通道可以通过集成的 TikTok SDK 直接向 TikTok 上报预定义生命周期事件（安装、启动、注册、登录）以及自定义事件。

支持的平台

AppLog 支持：

• iOS
• Android

启用开关

该功能通过 INTLConfig.ini 中的以下配置项控制：

[TikTok]
TIKTOK_TTGP_APP_LOG_ENABLE = true

属性	值
默认值	true
支持平台	Android、iOS
是否必填	否

若开关设为 false，调用 SetCommonParams 和 ReportEvent 会立即返回，不会上报任何数据。

事件类型

调用 ReportEvent 时请使用数值类型。

事件	值	说明
安装	1	首次安装。
启动	2	应用启动。
注册	3	用户注册。
登录	4	用户登录。
自定义	5	自定义事件，需传入事件名与 JSON 参数。

SetCommonParams

请在 Player Network 登录成功，并且玩家完成 TikTok 登录或绑定后调用 SetCommonParams。SDK 会在此调用中附加身份与设备上下文到后续事件。

SDK 会自动解析以下值：

• TTGP openid — 从 TikTok 登录或绑定成功时持久化的内部映射中读取。
• 广告 ID — Android 上为 GAID，iOS 上为 IDFA，从设备信息模块获取。

你只需传入游戏内用户信息：

参数	是否必填	说明
userId	否	游戏内用户 ID。无则传空字符串。
userNickName	否	游戏内用户昵称。无则传空字符串。
userIcon	否	游戏内用户头像 URL。无则传空字符串。

Unity

INTLAPI.TikTokTTGPAppLogSetCommonParams(
    userId: playerId,
    userNickName: playerNickname,
    userIcon: playerAvatarUrl
);

Unreal Engine

UINTLSDKAPI::TikTokTTGPAppLogSetCommonParams(
    playerId,
    playerNickname,
    playerAvatarUrl
);

info

如果调用 SetCommonParams 时还没有 TikTok 身份映射，TTGP openid 会回退为 "0"。事件仍可能被接收，但 TikTok 用户归因可能不可用。

ReportEvent

ReportEvent 是即发即弃接口，没有结果回调，上报失败仅在内部日志中记录。

对于 Custom 事件，需提供 eventName 与可选的 paramsJson 字符串。

Unity

// 上报预定义登录事件
INTLAPI.TikTokTTGPAppLogReportEvent(4);

// 上报自定义事件
INTLAPI.TikTokTTGPAppLogReportEvent(
    eventType: 5,
    eventName: "CompleteTutorial",
    paramsJson: "{ \"level\": \"1\" }"
);

Unreal Engine

// 上报预定义登录事件
UINTLSDKAPI::TikTokTTGPAppLogReportEvent(4, TEXT(""), TEXT("{}"));

// 上报自定义事件
UINTLSDKAPI::TikTokTTGPAppLogReportEvent(
    5,
    TEXT("CompleteTutorial"),
    TEXT("{ \"level\": \"1\" }")
);

caution

请在开始上报事件前先调用 SetCommonParams。如果先调用 ReportEvent，SDK 会自动以 SetCommonParams("", "", "") 回退并记录警告。事件仍会被发送，但用户归因可能不完整。

身份归因行为

AppLog 依赖 Player Network openid 与 TikTok TTGP openid 之间的映射。以下情况会自动创建该映射：

• TikTok 登录成功。
• TikTok 账号绑定成功。

解绑 TikTok 时会自动移除映射。如果映射缺失，TTGP openid 会回退为 "0"，TikTok 用户归因可能不可用。

测试与故障排查

1. 确认 INTLConfig.ini 中 TIKTOK_TTGP_APP_LOG_ENABLE 设为 true。
2. 确认 Android 或 iOS 构建中已包含 INTLTikTok 插件。
3. 在调用 SetCommonParams 前，确保 Player Network 登录和 TikTok 登录或绑定均已成功。
4. 如果事件未出现，请查看设备或编辑器日志中 TikTokTTGPAppLog 相关警告。
5. 自定义事件参数必须是合法 JSON。非法 JSON 会被忽略，事件将不带参数上报。

旧版 TikTok Business SDK 统计

旧版 TikTok Business SDK 统计路径（TIKTOK_EVENT_APPID 与 TIKTOK_EVENT_TT_APPID）仍记录在 配置 TikTok 上报。该路径仅支持 Android，与本页描述的 AppLog 通道相互独立。