# 排查 SDK 加载错误

> 解决在广告请求过程中加载广告时可能出现的常见问题。

当 Unity Ads SDK 无法获取广告内容时，会出现这些错误。如果广告服务未成功加载，则无法显示广告，因此广告请求不会被填充。使用本指南可以快速识别和修复加载广告时可能发生的问题。

**2 - Request timed out:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[2] Unity Ads SDK 广告加载失败：请求超时。请检查网络连接，稍后重试。
```此报错消息表示广告加载失败，因为 Unity Ads SDK 向 Unity 服务器发出的广告加载请求未在预期时间内收到响应。### Causes导致此报错的常见原因包括：- 网络连接薄弱（例如，wi-fi 薄弱或离线设备）
- 临时网络延时
- 服务器响应延时### Resolution要解决此问题，请确保您的设备具有可靠的互联网连接，并稍后再次尝试加载广告。**52100 - No ad fill available for the requested placement:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52100] Unity Ads SDK 广告加载失败：请求放置/位置没有可用的广告填充。
```此报错消息表示广告加载失败，因为 Unity Ads 网络无法完成广告填充。### Causes报错的原因可能是 Unity Ads 网络无法完成广告填充。> **Note:**
>
> 不能保证时间广告请求都会填满。填充率取决于地区、广告系列可用性和广告市场价格，可能会随时间波动。### Resolution如果没有广告填充并且广告无法加载，请稍后尝试重新加载广告。如果您看到 Unity Ads 的填充率始终很低，请考虑[设置 app-ads.txt 文件](/monetization/dashboard/app-ads-txt/set-up-app-ads-txt.md.md)（或确认其配置正确）。许多广告合作伙伴只会为正确实现了`app-ads.txt`文件的游戏出价。制定此标准是为了打击欺诈行为并提高广告市场的透明度。您还可以使用 Unity LevelPlay 或其他聚合合作伙伴来提高填充率。有关增加收入的其他指导，请联系您的帐户经理或 [Unity 支持](https://support-ads.unity.com/s/ContactUs)。**52101 - Unity Ads SDK is not initialized:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52101] Unity Ads SDK 广告加载失败：Unity Ads SDK 未初始化。在加载广告服务之前初始化 SDK。
```此报错消息表示广告加载失败，因为在尝试加载之前未初始化 SDK。### Causes导致此报错的常见原因包括：- 加载广告之前未调用 SDK 初始化方法
- SDK 初始化失败，导致加载方法从未运行### Resolution要解决此问题，请确保在加载广告之前已成功初始化 Unity Ads SDK。**52102 - Placement not found:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52102] Unity Ads SDK 广告加载失败：未找到放置/位置。使用 Unity Ads Monetization（变现）后台中的正确放置/位置 ID。
```此报错消息表示广告加载失败，因为代码中使用的放置/位置 ID 与为 Unity Ads 项目定义的任何放置/位置不匹配。### Causes导致此报错的常见原因包括：- 放置/位置 ID 区分大小写或拼写错误
- 从未在 Monetization 后台中添加放置/位置
- 广告放置/位置存在，但适用于其他平台（例如，在测试 Android 构建本时加载 iOS 放置/位置）
- 将游戏 ID 用于另一个 app，因此广告位不对应### Resolution要解决此问题，请确认广告放置/位置存在并在 Unity Ads Monetization（变现）后台中处于激活状态，确保使用正确的指定的于平台的广告放置/位置 ID，并仔细检查拼写和大小写区分。如果最近添加了新的放置/位置，请重新启动 app 或清除 SDK 缓存。如果最近更改了放置/位置 ID，请执行干净的重新构建以确保更新更改。> **Note:**
>
> 广告位是根据项目和平台定义的。验证游戏 ID 和放置/位置 ID 是否属于同一 Monetization 后台配置。**52103 - Internal protocol error:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52103] Unity Ads SDK 广告加载失败：发生内部协议报错。稍后重试。
```此报错消息表示广告加载失败，因为 SDK 在与 Unity 的广告服务器通信时遇到意外或格式错误的响应。### Causes导致此报错的常见原因包括：- 服务服务器应格式错误或不完整
- SDK 无法解析后端的协议
- 后端网关问题### Resolution要解决此问题，请确保稳定的网络连接，避免使用可以修改或截断 HTTP 响应的 VPN，并重试加载广告。如果报错仍然存在，请捕获详细日志并与 [Unity 支持部门](https://support-ads.unity.com/s/ContactUs)共享以供后端审查。**52104 - Placement ID mismatch (type or format):**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52104] Unity Ads SDK 广告加载失败：放置/位置 ID 与广告格式或放置/位置类型不匹配。在 Unity Ads Monetization（变现）后台中检查放置/位置设置。
```此报错消息表示广告加载失败，因为指定的放置/位置 ID 配置为与请求的广告格式或放置/位置类型不同的广告格式或类型。### Causes导致此报错的常见原因包括：- 对放置/位置使用错误的广告格式（例如，调用为奖励放置/位置 ID 加载插页广告服务的方法）
- 使用错误的广告放置/位置类型（例如，瀑布流广告放置/位置用于竞价）
- 将错误的后台配置设置为与预期不同的广告类型
- 平台不匹配，放置/位置类型可能正确，但属于另一个平台
- 在控制面板中引用已删除或修改的放置/位置### Resolution要解决此问题，请确保在 Unity Ads Monetization（变现）后台中，广告放置/位置的广告格式与您正在使用的 API 调用相匹配，并确保加载正确的指定的于平台的广告放置/位置 ID。**52105 - Network error:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52105] Unity Ads SDK 广告加载失败：发生网络报错。请检查网络连接，稍后重试。
```此报错消息表示广告加载失败，因为 Unity Ads SDK 在尝试加载广告时无法建立或维护与 Unity 广告投放服务器的网络连接。### Causes导致此报错的常见原因包括：- 无互联网连接（或设备离线或处于飞机模式）
- 正在使用的 VPN 阻挡 Unity Ads 域
- 设备无法解析 Unity Ads 终端### Resolution要解决此问题，请确保设备具有稳定的互联网连接，禁用所有 VPN，并在确认网络可用性后重试加载广告。**52106 - Insufficient storage space on device:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52106] Unity Ads SDK 广告加载失败：设备上的存储空间不足。释放空间，然后重试。
```此报错消息表示广告加载失败，因为设备耗尽了可用存储空间，导致 SDK 无法缓存临时广告资源或将临时广告资源写入磁盘。### Causes导致此报错的常见原因包括：- 您的设备没有可用存储容量
- 即使设备有空间，App 的本地数据目录或缓存也已满### Resolution要解决此问题，请释放设备上的存储空间或清除 app 的缓存数据，然后尝试再次加载广告。**52107 - Internal error while parsing ad response:**### Symptoms尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：```xml
[52107] Unity Ads SDK 广告加载失败：解析广告响应时发生内部报错。
```此报错消息表示广告加载失败，因为 Unity Ads SDK 在处理来自 Unity 服务器的广告响应时遇到内部解析报错。### Causes导致此报错的常见原因包括：- 服务服务器应格式错误不完整、被截断或格式不正确
- 读取广告元数据时 SDK 的解析器失败
- 过时的 SDK 用于较新的协议
- VPN 可能阻挡 Unity Ads 域### Resolution要解决此问题，请确保稳定的网络连接，避免使用限制性防火墙或 VPN，然后稍后再尝试重新加载广告。如果报错仍然存在，请捕获详细日志并与 [Unity 支持部门](https://support-ads.unity.com/s/ContactUs)共享以供后端审查。