# 新的 Unity Ads 隐私 API 中的主要更改

> 本指南介绍 LevelPlay 聚合用户和直接 Unity Ads 集成如何升级到新的 Beta 版隐私 API，概述 API 更改以及要使用哪些新的 Beta API。

> **Note:**
>
> Unity Ads SDK 隐私 API 的最新版本处于测试版。从当前版本到下一版本，其功能和文档可能会有所更改。

Unity Ads SDK 4.17.0 在 Beta 版中引入了新的公共隐私 API，目前只能通过 LevelPlay 聚合适配器使用。本指南适用于将 Unity Ads SDK 4.17.0 直接与 LevelPlay 聚合适配器集成的开发者。

## 升级到 Unity Ads SDK 4.17.0##upgrade-to-unity-ads-sdk-4.17.0

1. **LevelPlay mediation users**

   如果您是使用 LevelPlay 聚合适配器的 LevelPlay 聚合用户，则所有隐私和同意处理都直接通过适配器进行管理。建议的最佳做法是查看并遵循平台（[Android](/grow/levelplay/sdk/android/regulation-advanced-settings.md)、[iOS](/grow/levelplay/sdk/ios/regulation-advanced-settings.md)、[Unity](/grow/levelplay/sdk/unity/regulation-advanced-settings.md)、[Adobe Air](/grow/levelplay/sdk/adobe/additional-settings.md)、[Flutter](/grow/levelplay/sdk/flutter/regulation-advanced-settings.md) 或 [React Native](/grow/levelplay/sdk/react/regulation-advanced-settings.md)）的 LevelPlay 隐私法规高级设置文档。

   如果您的集成在适当的情况下[正确设置了同意标志](set-consent-signal-mappings)，则无需您执行进一步操作。

2. **Direct Unity Ads integrations using Metadata APIs**

   如果您的集成使用 Unity Ads Metadata API、Unity Consent（Unity 默认认回回退私解决方案）或两者的组合，则必须在聚合 SDK 中设置正确的同意信号。

   如果未完成此操作，您的同意信号可能会被忽略。这意味着 app 可能不会遵循用户的隐私选择。

> **Important:**
>
> 从 SDK 版本 4.17.0 开始，测试版隐私 API 针对每个隐私框架强制执行一个授权信号，即针对选择加入隐私框架的选择加入同意信号`setUserConsent`或针对选择退出隐私框架的选择退出信号`setUserOptOut`。请参阅[设置正确的同意信号映射](set-consent-signal-mappings)以了解哪种方法适合哪种隐私框架。不会应用来自不适用 API 的信号，并且框架的默认行为仍然特效。
>
> 您有责任确保已审查并满足[先决条件](prerequisite-conditions)，并在启用开发者同意时使用最新版本的 Unity Ads SDK。

## 正在改变什么##whats-changing

请查看下表以确定必须更新哪些元数据隐私 API 方法才能使用新的 Beta 版隐私 API。

| **以前的隐私 API**              | **改用新的隐私 API**     | **描述**                                                                   |
| -------------------------- | ------------------ | ------------------------------------------------------------------------ |
| `gdpr.consent`             | `setUserConsent`   | 涵盖[选入框架](use-beta-privacy-apis#opt-in-consent-api)的同意。                   |
| `privacy.consent`          | `setUserOptOut`    | 涵盖[退出框架](use-beta-privacy-apis#opt-out-signal-api)的同意。                   |
| `user.nonbehavioral`       | `setNonBehavioral` | 涵盖[年龄限制框架](use-beta-privacy-apis#age-restricted-users-specification)的同意。 |
| `pipl.consent`             | 不适用                | 应删除已弃用的 API。                                                             |
| `privacy.useroveragelimit` | 不适用                | 应删除已弃用的 API。                                                             |

请参阅有关实现指南的[使用新 Beta 版隐私 API](use-beta-privacy-apis)。