# iOS 隐私设置和配置

> 集成 SKAdNetwork 2.2，使用网络 ID 更新 app 的 Info.plist，启用归因，并实现 Apple 的 app Tracking Transparency (ATT) 提示词以符合 iOS 隐私要求。

LevelPlay SDK 与 iOS 隐私配置保持一致，支持 SKAdNetwork 和 Apple 的隐私清单。请遵循本文档，详细了解 LevelPlay 的方法和解决方案。

## 集成 app 以支持 Apple 的要求

1. 集成 LevelPlay SDK 7.9.0+
2. 使用 SKAdNetwork 标识符更新 plist
3. 启用 SKAdNetwork 归因
4. 针对 Apple Tracking Authorization 个性化您的 app 消息
5. 集成兼容的网络 SDK 和适配器版本

## 使用 SKAdNetwork 标识符更新 plist

使用与您合作的所有广告网络的网络 ID 更新 app 的 info.plist，从而允许广告服务出现在 app 中。

> **Important:**
>
> 在 LevelPlay SDK Unity 软件包的 8.8.0+ 版本中，可以在 LevelPlay Network Manager 中启用 SKAdNetwork IDs 功能，从而将所有安装的网络的所有 ID 自动添加到应用程序的 Info.plist 文件中。

\*\*IronSource SKAdNetwork ID：\*\*su67r6k2v3.skadnetwork

使用 [SKAdNetwork IDs Manager](/grow/levelplay/sdk/ios/skadnetwork-id-manager.md.md) 可获取所有 LevelPlay 聚合网络 ID 的更新列表。

请参阅 Apple 的 SKAdNetwork [文档](https://developer.apple.com/documentation/storekit/skadnetwork)以了解更多信息。

## 在应用程序中启用 SKAdNetwork 归因

更新代码以支持 SKAdNetwork 归因，如果决定在其他应用中发布归因信息，则允许 app 发送归因信息。

更新 app 代码以使用 `registerAppForAdNetworkAttribution` 或 `updateConversionValue(_:)` 报告 Apple

您可以在 Apple 的[文档](https://developer.apple.com/documentation/storekit/skadnetwork?language=objc)中名为“The advertisinged app's responsibilities are to”的部分下阅读更多信息。

## 请求跟踪授权

在 iOS 14 中，Apple 引入了隐私和广告跟踪的新机制：[app Tracking Transparency (ATT) 提示词](https://developer.apple.com/app-store/user-privacy-and-data-use/)。

如果要请求用户授权访问 app 相关数据，请确保在 app 的[信息属性列表](https://developer.apple.com/documentation/bundleresources/information_property_list) (info.plist) 中包含 NSUserTrackingUsageDescription 密钥。

您可以使用您的个人消息更新 `<string> </string>` 部分，以便在 ATT 提示词中向用户显示。

```xml
<key>NSUserTrackingUsageDescription</key>
<string>在此处</string>您的个性化消息
```

在[此处](https://developer.apple.com/documentation/bundleresources/information_property_list/nsusertrackingusagedescription)了解有关 Apple NSUserTrackingUsageDescription 的更多信息。

## 隐私清单支持

LevelPlay SDK 7.9.0+ 集成了一个隐私清单文件，其中概述了 ironSource 广告服务使用的 API。为了符合 [Apple 的新隐私清单框架](https://developer.apple.com/news/?id=3d8a9yyh)，必须在应用程序中包含此文件。

### 必需原因 API

Apple 引入了一组应在隐私清单文件中声明的 [API](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api)，以及使用这些 API 的相关原因。

> **Important:**
>
> 我们了解在检测第三方 SDK 的隐私清单方面存在问题。Apple 目前正在进行修复，正在等待您的回复。要避免这些检测问题，请参阅以下步骤。

您可以在此处找到 LevelPlay SDK 使用的 API 及其推理。为了避免检测问题，您可以手动将它们添加到 [PrivacyInfo.xcprivacy](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files#4284009) 文件中，或复制以下代码片段并将其粘贴到 PrivacyInfo.xcprivacy 文件中。

| 部分                                                                                                                                         | API 类型                                   | 原因     |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- | ------ |
| [磁盘空间 API](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api#4278393) | NSPrivacyAccessedAPICategoryDiskSpace    | E174.1 |
| [用户默认 API](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api#4278401) | NSPrivacyAccessedAPICategoryUserDefaults | CA92.1 |

```xml
<key>NSPrivacyAccessedAPITypes</key>
   <array>
      <dict>
         <key>NSPrivacyAccessedAPIType</key>
         <string>NSPrivacyAccessedAPICategoryDiskSpace</string>
         <key>NSPrivacyAccessedAPITypeReasons</key>
         <array>
            <string>E174.1</string>
         </array>
      </dict>
      <dict>
         <key>NSPrivacyAccessedAPIType</key>
         <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
         <key>NSPrivacyAccessedAPITypeReasons</key>
         <array>
            <string>CA92.1</string>
         </array>
      </dict>
   </array>
```

### LevelPlay 和聚合网络的支持

LevelPlay 的网络 SDK 和支持隐私清单的适配器版本：

| **网络名称**         | **所需原因 API**                                                                            | **iOS 适配器版本** | **Unity 适配器版本** |
| ---------------- | --------------------------------------------------------------------------------------- | ------------- | --------------- |
| ironSource       | UserDefaults：CA92.1 DiskSpace：E174.1                                                    | -             | -               |
| AppLovin         | 用户默认 - CA92.1                                                                           | 4.3.44        | 4.3.48          |
| APS              | 用户默认 - CA92.1                                                                           | 4.3.12        | 4.3.10          |
| BidMachine       | UserDefaults：CA92.1 DiskSpace：E174.1 文件时间戳 - C617.1                                     | 4.3.7         | 4.3.7           |
| Chartboost       | 用户默认值 - CA92.1 文件时间戳 - C617.1                                                           | 4.3.17        | 4.3.21          |
| CSJ              | SystemBootTime:35F9.1 UserDefaults：CA92.1 DiskSpace：7D9E.1、E174.1 文件时间戳 - C617.1        | 4.3.3         | 4.3.3           |
| Google           | SystemBootTime:35F9.1 UserDefaults:CA92.1 DiskSpace:E174.1                              | 4.3.53        | 4.3.60          |
| 数字涡轮机/纤维         | 用户默认 - CA92.1                                                                           | 4.3.33        | 4.3.41          |
| HyprMX           | UserDefaults - CA92.1                                                                   | 4.3.5         | 4.3.7           |
| InMobi           | DiskSpace - E174.1 UserDefaults - CA92.1                                                | 4.3.22        | 4.3.27          |
| Liftoff Monetize | DiskSpace - E174.1 UserDefaults - CA92.1                                                | 4.3.34        | 4.3.42          |
| Meta             | UserDefaults:CA92.1  SystemBootTime:35F9.1  FileTimestamp:C617.1                        | 4.3.44        | 4.3.62          |
| Mintegral        | DiskSpace - E174.1 FileTimestamp - C617.1 NSUserDefaults - CA92.1                       | 4.3.23        | 4.3.26          |
| Pangle           | UserDefaults:CA92.1 SystemBootTime:35F9.1 FileTimestamp:C617.1 DiskSpace:7D9E.1, E174.1 | 4.3.28        | 4.3.32          |
| Smaato           | UserDefaults:CA92.1  SystemBootTime:35F9.1  FileTimestamp:C617.1                        | 4.3.13        | 4.3.13          |
| SuperAwesome     | DiskSpace - E174.1 NSUserDefaults -                                                     | 4.1.10        | 4.1.11          |
| UnityAds         | FileTimestamp - C617.1 DiskSpace - E174.1 UserDefaults - CA92.1                         | 4.3.37        | 4.3.37          |

> **Note:**
>
> 网络的 SDK 清单支持基于网络的报告。
