强化数据回传

强化数据回传（SDK 1.4.0 及以上版本可用）会通过应用事件 SDK 自动收集应用内页面信息，例如元数据和按钮点击信息。此功能当前处于封测阶段，仅限部分客户使用，目标是最终提升广告投放效果并实现信号自动化方面的改进。如需了解更多详情，参见商务帮助中心文章。

我们提供 3 种启用或禁用该功能的方法，你可以根据需求进行选择：

|控制类型{20%}|接口{20%}|用途{40%}|范围{20%}|
|---|---|---|---|
|前端开关|TikTok 事件管理工具|在所有设备上启用或禁用该功能。可使用该功能直接修改设置，无需发布新版本的应用。<br><br>优先于客户端全局开关，并遵从客户端的低性能标记（如有）。|全局|
|客户端全局开关|SDK 配置|在所有设备上禁用该功能。需发布新版本的应用才能更改此设置。<br><br>优先级次于前端开关（服务器端设置具有优先级）。|全局|
|客户端低性能标记|SDK 配置|针对低性能设备优化功能的性能（如有自定义设备分级逻辑）。<br><br>当启用全局开关时强制执行。|特定设备|

1. 事件管理工具前端开关

可在事件管理工具中，从应用的“设置”选项卡访问该开关。可在 TikTok 事件管理工具中动态启用/禁用该功能，无需重新编译和重新发布应用。此开关优先于全局禁用标记，并遵从低性能设备标记。此开关也强制优先考虑服务器端设置。首次部署 SDK 时，该开关的初始状态将与客户端的设置保持一致。在事件管理工具中做出的任何进一步更改，都将覆盖客户端的设置。

2. 客户端全局开关

在 SDK 配置中添加这一设置，可在所有设备上全局禁用该功能。如果你希望完全关闭这项功能，而不考虑设备类型或运行时条件，请使用此设置。

Android

(code curl http)
TTConfig ttConfig = new TTConfig(getApplicationContext(), "YOUR_APP_SECRET")
    .setAppId("YOUR_APP_ID")
    .setTTAppId("YOUR_TIKTOK_APP_ID")
    .disableAutoEnhancedDataPostbackEvent() // Disable Enhanced data postback

TikTokBusinessSdk.initializeSdk(ttConfig);
(/code)

iOS

(code curl http)
// Swift
guard let config = TikTokConfig(accessToken: "YOUR_APP_SECRET", appId: "YOUR_APP_ID", tiktokAppId: "YOUR_TIKTOK_APP_ID") else {
    return true
}
// Add this line to disable Enhanced data postback
config.disableAutoEnhancedDataPostbackEvent()

TikTokBusiness.initializeSdk(config)
(/code)

(code curl http)
// Objective-C
TikTokConfig *config = [TikTokConfig configWithAccessToken:@"YOUR_APP_SECRET" appId:@"YOUR_APP_ID" tiktokAppId:@"YOUR_TIKTOK_APP_ID"];
// Add this line to disable Enhanced data postback
[config disableAutoEnhancedDataPostbackEvent];

[TikTokBusiness initializeSdk:config];
(/code)

Unity

(code curl http)
// C#
TikTokConfig config = new TikTokConfig("YOUR_IOS_APP_SECRET", "YOUR_IOS_APP_ID", "YOUR_IOS_TIKTOK_APP_ID", "YOUR_ANDROID_APP_SECRET", "YOUR_ANDROID_APP_ID", "YOUR_ANDROID_TIKTOK_APP_ID");
// Add this line to disable Enhanced data postback
config.DisableEnhancedDataPostbackTrack();

TikTokBusinessSDK.InitializeSdk(config);
(/code)

3. 客户端低性能设备标记

在 SDK 配置中添加此设置，仅为标记为低性能的设备优化性能。如果你有自定义逻辑来为设备性能分类，并希望这项功能默认开启，但在性能受限的设备上禁用，请使用此设置。

Android

(code curl http)
TTConfig ttConfig = new TTConfig(getApplicationContext(), "YOUR_APP_SECRET")
    .setAppId("YOUR_APP_ID")
    .setTTAppId("YOUR_TIKTOK_APP_ID")
    .setIsLowPerformanceDevice(true); // Optimise feature performance on this device only

TikTokBusinessSdk.initializeSdk(ttConfig);
(/code)

iOS

(code curl http)
// Swift
guard let config = TikTokConfig(accessToken: "YOUR_APP_SECRET", appId: "YOUR_APP_ID", tiktokAppId: "YOUR_TIKTOK_APP_ID") else {
    return true
}
// Add this line to optimise feature performance on this device only
config.setIsLowPerformanceDevice(true)

TikTokBusiness.initializeSdk(config)
(/code)

(code curl http)
// Objective-C
TikTokConfig *config = [TikTokConfig configWithAccessToken:@"YOUR_APP_SECRET" appId:@"YOUR_APP_ID" tiktokAppId:@"YOUR_TIKTOK_APP_ID"];
// Add this line to optimise feature performance on this device only
[config setIsLowPerformanceDevice:YES];

[TikTokBusiness initializeSdk:config];
(/code)

Unity

(code curl http)
// C#
TikTokConfig config = new TikTokConfig("YOUR_IOS_APP_SECRET", "YOUR_IOS_APP_ID", "YOUR_IOS_TIKTOK_APP_ID", "YOUR_ANDROID_APP_SECRET", "YOUR_ANDROID_APP_ID", "YOUR_ANDROID_TIKTOK_APP_ID");
// Add this line to optimise feature performance on this device only
config.SetIsLowPerformanceDevice(true);

TikTokBusinessSDK.InitializeSdk(config);
(/code)