在现有 Pangle SDK 集成中配置应用事件报告

重要说明
TikTok 应用事件 SDK 的使用受 TikTok for Business 商业服务条款的约束。使用 TikTok 应用事件 SDK，即表示你还同意遵守 TikTok 商业产品（数据）条款，并且你不会与 TikTok 分享敏感数据。

如果你的应用中已安装 Pangle SDK，按照以下说明启用 TikTok 应用事件模块。Pangle SDK（7.7.0.0 及以上版本）是合并版 SDK，其中包含可作为模块彼此独立运行的 Pangle 广告变现 SDK 和 TikTok 应用事件 SDK。

Android 指南

更新现有构建依赖项并添加所需的库

将现有的 Pangle 广告变现 SDK 依赖项更新为最新版本。
在项目层级的 build.gradle 文件中，添加以下必要的仓库声明：

(code curl http)
// project/build.gradle
allprojects {
    repositories {
        google()
    }
}
(/code)

在应用层级的 build.gradle 文件中，添加所需库的 implementation 依赖项。

(code curl http)
// app/build.gradle
android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

dependencies {
    // Required for automatic event reporting and lifecycle tracking
    implementation 'androidx.lifecycle:lifecycle-process:2.3.1'
    implementation 'androidx.lifecycle:lifecycle-common-java8:2.3.1'

    // Required for automatic in-app purchase reporting
    implementation 'com.android.billingclient:billing:6.1.0'

    // Required for Play Store install referrer attribution
    implementation 'com.android.installreferrer:installreferrer:2.2'
}
(/code)

管理构建冲突

如果你的应用必须分别管理变现和应用事件报告的依赖项，在添加 JitPack 版本的 TikTok 应用事件 SDK 时，可能会遇到构建失败的情况。原因是应用事件 SDK 已包含在你的 Pangle SDK 版本中。
若想解决这个问题，首先需要在 Pangle 构建依赖项中排除捆绑模块：

(code curl http)
dependencies {
  implementation ('com.pangle.global:pag-sdk:8.1.0.3') {
      // Exclude the bundled App Events SDK
      exclude module: 'tiktok-business-android-sdk-comp'
  }
}
(/code)

接着，按照 Android 集成步骤中的说明，将应用事件 SDK 作为独立依赖项安装。
如果不需要将 SDK 作为独立依赖项安装，可按照以下说明进行操作。

配置并初始化 TikTok 应用事件 SDK 模块

按照快速入门中的说明生成并记录 TikTok 应用 ID 和应用密钥。Android 和 iOS 需要分别设置不同的值。
从 Android 集成步骤中 Add permissions 这一步开始，继续按照后续步骤操作。

配置广告收入报告

如果你不属于已通过 Pangle SDK 发送了广告收入事件的白名单客户，请按照应用内广告收入报告中的其余说明进行操作。
如果你已通过 Android Pangle SDK 发送了广告收入事件，可通过 TikTok 应用事件 SDK 返回现有的 adRevenueJson 对象。在移除任何现有 Pangle 广告变现 SDK 接口调用之前，请先测试这一新的报告方式，以免报告出现不一致。

(code curl http)
// Make sure the App Events SDK has been initialized before calling this
TTBaseEvent adRevenueInfo = TTAdRevenueEvent.newBuilder(adRevenueJson).build();
TikTokBusinessSdk.trackTTEvent(adRevenueInfo);

// After testing the new TikTokBusinessSdk interface, remove the existing PAGSdk interface
// REMOVEME
PAGSdk.setAdRevenue(adRevenueJson);
(/code)

iOS 指南

更新现有构建依赖项

将现有的 Pangle 广告变现 SDK 依赖项更新为最新版本。

管理构建冲突

如果你的应用必须分别管理变现和应用事件报告的依赖项，在安装 TikTok 应用事件 SDK 时，可能会遇到构建失败的情况。原因是应用事件 SDK 已包含在你的 Pangle SDK 版本中。
若想解决这个问题，需要在依赖项中明确声明 Pangle SDK 的子规格。这样，你的构建中将仅包含 Pangle 专有组件。

(code curl http)
# Podfile to only include the Pangle module
pod 'Ads-Global/PangleSDK'

# If you are using a mediation adapter for Pangle
pod 'Ads-Global-M/PangleSDK'
pod 'Ads-Global-M/Mediation'
(/code)

接着，按照 iOS 集成步骤中的说明，将应用事件 SDK 作为独立依赖项安装。
如果不需要将 SDK 作为独立依赖项安装，可按照以下说明进行操作。

配置并初始化 TikTok 应用事件 SDK 模块

按照快速入门中的说明生成并记录 TikTok 应用 ID 和应用密钥。Android 和 iOS 需要分别设置不同的值。
从 iOS 集成步骤中 Configure build settings 这一步开始，继续按照后续步骤操作。

配置广告收入报告

按照应用内广告收入报告中的说明进行操作。

Unity 说明

更新现有构建依赖项

将现有的 Pangle Unity 聚合插件更新为最新版本。

导入 TikTok 应用事件 SDK Unity 桥接

从 GitHub 仓库下载最新的 TikTokBusinessSDK.unitypackage。
在 Unity 中，前往 Assets > Import Package > Custom Package
选择已下载的 TikTokBusinessSDK.unitypackage
导入所有 unitypackage 文件，tiktok-business-android-sdk.aar 和 TikTokBusinessSDK.xcframework 除外。这可以确保正确使用聚合插件中的现有 TikTok 应用事件模块，并减小最终的构建大小。

配置并初始化 TikTok 应用事件 SDK 模块

按照快速入门中的说明生成并记录 TikTok 应用 ID 和应用密钥。Android 和 iOS 需要分别设置不同的值。
从 Unity 集成步骤中 Configure and initialize the SDK 这一步开始，继续按照后续步骤操作。

配置广告收入报告

按照应用内广告收入报告中的说明进行操作。
如果你已通过 Pangle Unity 聚合插件发送了广告收入事件，可通过 TikTok 应用事件 SDK 返回现有的 revenueInfo 对象。在移除任何现有 Unity 插件接口调用之前，请先测试这一新的报告方式，以免报告出现不一致。

(code curl http)
// Make sure the App Events SDK has been initialized before calling this
TikTokAdRevenueEvent adRevenueEvent = new TikTokAdRevenueEvent(revenueInfo);
TikTokBusinessSDK.TrackTTEvent(adRevenueEvent);

// After testing the new TikTokBusinessSDK interface, remove the existing PAGSDKHelper interface
// REMOVEME
PAGSDKHelper.SetAdRevenue(revenueInfo);
(/code)