TikTok AppLog

Important

Do not integrate on your own. The TikTok channel requires formal cooperation with TikTok before you can register an application and obtain the configuration required for integration. If you need to integrate, please consult your business contact first.

Player Network surfaces TikTok AppLog as a fire-and-forget event-reporting channel. The channel can report predefined lifecycle events (install, launch, register, login) and custom events directly to TikTok through the bundled TikTok SDK.

Supported platforms

AppLog is supported on:

• iOS
• Android

Enable switch

The feature is controlled by the following key in INTLConfig.ini:

[TikTok]
TIKTOK_TTGP_APP_LOG_ENABLE = true

Property	Value
Default	true
Supported platforms	Android, iOS
Required	No

If the switch is set to false, calls to SetCommonParams and ReportEvent return immediately without reporting any data.

Event types

Use the numeric event type values when calling ReportEvent.

Event	Value	Description
Install	1	First-time installation.
Launch	2	Application launch.
Register	3	User registration.
Login	4	User login.
Custom	5	A custom event with a name and JSON parameters.

SetCommonParams

Call SetCommonParams after the Player Network login succeeds and after the player logs in or binds TikTok. The SDK uses this call to attach identity and device context to every subsequent event.

The SDK resolves the following values automatically:

• TTGP openid — read from the internal mapping that is persisted when TikTok login or bind succeeds.
• Advertising ID — GAID on Android, IDFA on iOS, obtained from the device-info module.

You only need to pass the in-game profile:

Parameter	Required	Description
userId	No	In-game user ID. Pass an empty string if unavailable.
userNickName	No	In-game user nickname. Pass an empty string if unavailable.
userIcon	No	In-game user avatar URL. Pass an empty string if unavailable.

Unity

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

Unreal Engine

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

info

If no TikTok identity mapping exists when you call SetCommonParams, the TTGP openid defaults to "0". The event may still be accepted, but TikTok user attribution may be unavailable.

ReportEvent

ReportEvent is fire-and-forget. There is no result observer; reporting failures are logged internally.

For Custom events, provide eventName and an optional paramsJson string.

Unity

// Report a predefined login event
INTLAPI.TikTokTTGPAppLogReportEvent(4);

// Report a custom event
INTLAPI.TikTokTTGPAppLogReportEvent(
    eventType: 5,
    eventName: "CompleteTutorial",
    paramsJson: "{ \"level\": \"1\" }"
);

Unreal Engine

// Report a predefined login event
UINTLSDKAPI::TikTokTTGPAppLogReportEvent(4, TEXT(""), TEXT("{}"));

// Report a custom event
UINTLSDKAPI::TikTokTTGPAppLogReportEvent(
    5,
    TEXT("CompleteTutorial"),
    TEXT("{ \"level\": \"1\" }")
);

caution

Call SetCommonParams before you start reporting events. If ReportEvent is called before SetCommonParams, the SDK automatically calls SetCommonParams("", "", "") and logs a warning. The reported event is still sent, but user attribution may be incomplete.

Identity attribution behavior

AppLog relies on a mapping between the Player Network openid and the TikTok TTGP openid. The SDK creates this mapping automatically when:

• TikTok login succeeds.
• TikTok account binding succeeds.

The mapping is removed automatically when TikTok is unbound. If the mapping is missing, the TTGP openid falls back to "0" and TikTok user attribution may be unavailable.

Testing and troubleshooting

1. Confirm that TIKTOK_TTGP_APP_LOG_ENABLE is set to true in INTLConfig.ini.
2. Ensure the INTLTikTok plugin is included in the Android or iOS build.
3. Make sure Player Network login and TikTok login or bind have both succeeded before calling SetCommonParams.
4. Check the native device or editor logs for warnings from TikTokTTGPAppLog if events are not appearing.
5. Custom event parameters must be valid JSON. Invalid JSON is ignored, and the event is reported without parameters.

Legacy TikTok Business SDK analytics

The legacy TikTok Business SDK analytics path (TIKTOK_EVENT_APPID and TIKTOK_EVENT_TT_APPID) is still documented under Configure TikTok reporting. It is Android-only and separate from the AppLog channel described on this page.