条款和隐私政策流程

本页中，您将了解如何使用 MAX 条款和隐私政策流程来提示用户接受使用条款和隐私政策。

配合 Google UMP 使用时，AppLovin MAX SDK 符合 TCF v2 的要求： MAX SDK 可以接收许可字符串和 AC 字符串，并按照 TCF v2 许可中的描述，将 TCF v2 许可字符串/状态转发至 mediated network。

如果您不使用 Google UMP 作为您的 CMP（无论是通过 AppLovin 的自动化流程还是其他方式），您必须确保您选择的 CMP 支持您集成的 mediated network。

如果您不使用 CMP，则必须继续按照 GDPR 及其他地区的许可和其他适用标记中的描述设置 AppLovin SDK 的二进制许可标记。

Google UMP 自动化

AppLovin MAX SDK 实现了 Google UMP 的自动化集成。 您无需手动集成 Google UMP。 这是一项完全可选的设置，AppLovin 会为您说明如何启用该 Google UMP 集成。 下面是此流程的可视化呈现：

1. MAX SDK 初始化。
2. 地区合规性检查：AppLovin 确定用户是否位于 GDPR 地区。如果是，MAX SDK 就会显示 Google UMP。
3. (仅限 iOS) 如果未配置 Google UMP 展示 ATT 弹窗，或用户未看到 Google UMP 流程，则 MAX SDK 会展示 MAX ATT 弹窗。
4. MAX SDK 调用您的初始化完成回传，告知您可以开始加载广告了。

启用 Google UMP

在 AdMob dashboard 上启用 Google CMP

您必须先在 AdMob dashboard 中创建并发布 Google GDPR 信息，才能在 MAX 许可流程中显示 Google GDPR 表单。 为此：

1. 访问 apps.admob.com 并登录您的 AdMob 账户。
   • 如果您尚未完成，请将应用添加至 AdMob dashboard。
2. 点击 Privacy & messaging。
3. 点击 GDPR。
4. 点击 Create message。 GDPR message 页面打开。
5. 选择要向哪些应用显示消息：
   1. 点击 Select apps。
   2. 选择所需的应用。
   3. 点击 Save。
6. 选择消息的显示语言。
7. 在 User consent options 部分，选择 Consent or Manage options。

8. 在 Targeting 部分选择 Everywhere。
9. 点击 Continue。 Edit message 页面打开。
10. 在 Message name 字段，输入一个描述性的消息名称，以便以后识别该消息。 该名称仅出现在 Privacy & messaging 页面，对用户不可见。
11. 选择 Styling 选项卡。
    1. 在 Global 部分，设置 Secondary color 为白色 (#ffffff)。
    2. 在 Buttons 部分，设置 Secondary color 为灰色 (#6e6e6e)。
12. 点击 Publish。

自定义广告合作伙伴列表

在默认的 GDPR 信息中，Google 可能不会显示您的所有 ad network 合作伙伴。 如果未能纳入这些 network，您的广告收入可能会受到负面影响。 请按照本节中的步骤操作，确保 GDPR 消息中显示所有广告合作伙伴。

1. 打开 GDPR settings 页面。
2. 点击 Review your ad partners 部分的编辑图标。
3. 选择 Automatically include commonly used ad partners 或 Do not automatically include commonly used ad partners。 Then select all the network that you integrated into your app.

1. 点击 Confirm。
2. 点击 GDPR settings 页面底部的 Save。

启用 MAX 条款和隐私政策流程

按照以下步骤启用条款和隐私政策流程：

1. 在 Unity 中，选择 AppLovin > Integration Manager。 此时会显示 AppLovin Integration Manager 对话框。
2. 在 Privacy Settings 中勾选 Enable MAX Terms and Privacy Policy Flow。
3. 您必须添加 Privacy Policy URL 和基本 User Tracking Usage Description 的值。 AppLovin Integration Manager 将使用默认值为您填充英文（基本）User Tracking Usage Description 以及该描述的各种本地化版本。
4. 您还可以选择性地设置 Terms of Service URL，以及是否 Show Terms and Privacy Policy Flow when in GDPR Regions（默认处于禁用状态）。
5. 关闭 AppLovin Integration Manager 对话框。

将应用提交至 App Store Connect 进行审核时，您必须告知审核员您只为 iOS 14.5+ 启用了 App Tracking Transparency 框架权限请求。 请在 Review Notes 部分注明此信息。 如果您不这样做，Apple 可能会拒绝您的构建版本。

集成

初始化 SDK 时，SDK 会显示许可请求流程。 用户完成流程时，SDK 会调用您的初始化完成回传。

如果您要在 MMP 集成中设置用户 ID，请在设置 AppLovin 用户 ID 的位置进行设置。 以下代码片段以 Adjust 为例。 请参阅 Adjust 文档，了解如何初始化 Adjust 以及如何设置用户 ID。

MaxSdkCallbacks.OnSdkInitializedEvent += (MaxSdk.SdkConfiguration sdkConfiguration) = {

  // You can check app transparency tracking authorization in sdkConfiguration.AppTrackingStatus for Unity Editor and iOS targets.
  // Initialize other third-party SDKs; do not initialize mediated advertising SDKs (MAX does that for you). Not following this step will result in noticeable integration issues.

  // Initialize the Adjust SDK inside the AppLovin SDK's initialization callback
  string adjustAppToken = "«your-Adjust-app-token»";
  AdjustEnvironment adjustEnvironment = AdjustEnvironment.Sandbox or AdjustEnvironment.Production;
  AdjustConfig config = new AdjustConfig(adjustAppToken, adjustEnvironment);
  Adjust.start(config);

  // Start loading ads
};
MaxSdk.SetUserId("«user-ID»");
Adjust.addSessionCallbackParameter("«your-user-ID-key»", "«user-ID»");
MaxSdk.InitializeSdk();

本地化 NSUserTrackingUsageDescription

AppLovin MAX Unity plugin 包含一组默认的用户跟踪用途描述。 如果您想覆盖这些设置，请在 Integration Manager 中勾选 Override Default User Tracking Usage Description 设置并输入您的描述。

向现有用户显示 GDPR 流程

AppLovin 建议您允许 GDPR 地区的现有用户重新进入 GDPR 流程。 通常，用户可以在应用的设置部分通过管理现有隐私设置（Manage Existing Privacy Settings）选项来执行此操作。 如果用户位于 GDPR 地区，您可以有条件地显示该设置选项。 要确定这一点，请使用 SDK API MaxSdk.GetSdkConfiguration().ConsentFlowUserGeography。 当 ConsentFlowUserGeography 为 ConsentFlowUserGeography.Gdpr 时，表示用户位于 GDPR 地区。

当用户点击管理现有隐私设置（或其等效选项）时，调用 MaxSdk.CmpService.ShowCmpForExistingUser()。 该操作会重置用户现有的许可信息。

using UnityEngine;
using AppLovinMax.Internal.API;

public class MyGame
{
  private void LoadAndShowCmpFlow()
  {
    var cmpService = MaxSdk.CmpService;

    cmpService.ShowCmpForExistingUser(error =>
    {
      if (null == error)
      {
        // The CMP alert was shown successfully.
      }
    });
  }
}

测试

如果您想在 GDPR 地区之外测试 Google CMP，请在 Integration Manager 中将 Debug User Geography 设置为 GDPR，如下所示：

然后，在初始化 MAX SDK 之前，将测试设备的哈希 ID 设置为 SDK 的额外参数。 当应用在设备上运行时，Google CMP SDK 会记录此测试设备的哈希 ID。 通过以下调用设置测试设备的哈希 ID：

MaxSdk.SetExtraParameter("google_test_device_hashed_id", "«your-test-device-hashed-ID»")

使用 Mediation Debugger 测试 Google UMP 集成

验证安装

在 MAX Mediation Debugger 的 Privacy 部分下，CMP (Consent Management Platform) 行显示已集成的 Google 认证 CMP SDK 的名称。 如果集成了 Google UMP SDK，则会显示 “Google consent management solutions” 作为名称。

验证 IAB TCF 参数

如果您选择 CMP (Consent Management Platform) 行，可以检查 IAB TCF 参数 IABTCF_gdprApplies、IABTCF_TCString 和 IABTCF_AddtlConsent。 对于后两者，您可以点击该行来复制或分享其值。

验证缺失 network

在 CMP CONFIGURATION 部分，可以验证 Google UMP 配置中集成或缺失的 network。 这是 MAX 可用的所有 network 的详尽列表。 您可以忽略应用中未集成的任何 network。

在您的 CMP 流程中，您必须列出您在应用中集成的 network。 要检查是否缺失了其中某些 network，并修复此问题：

1. 完成 CMP 流程，向所有 network 授予许可。
2. 打开 Mediation Debugger。 Mediation Debugger 会解析 TC 和 AC 字符串并显示两个列表：
   1. 您在 CMP 流程中列出的已集成 network
   2. 可能需要添加的缺失 network（在 CMP CONFIGURATION 部分的 Configured CMP Networks 下）
3. 您会在 MISSING ATP NETWORKS 或 MISSING TCF VENDORS 列表中看到缺失的 network。 如果其中有您集成到应用中的 network：
   1. 返回您的 CMP dashboard。 将缺失的 network 添加到 GDPR 消息所覆盖的 network 中。 （请参阅自定义广告合作伙伴列表了解如何在 Google 的 Unified Consent Flow 中执行此操作。）
   2. 重启应用。

重复这些步骤，直到确认您已将您的所有 network 包含在 CMP 流程中。

验证 mediated network 许可状态

要查看所有 network 的许可状态，请展开 Mediation Debugger 的 Network Consent Statuses 部分。 Mediation Debugger 会解析 TC 字符串并显示所有 network 的许可状态。 此外还会显示从 Google UMP 生成 of AC 字符串中解析出的 AppLovin 许可状态。