排查 SDK 加载错误
解决在广告请求过程中加载广告时可能出现的常见问题。
阅读时间1 分钟最后更新于 1 个月前
当 Unity Ads SDK 无法获取广告内容时，会出现这些错误。如果广告服务未成功加载，则无法显示广告，因此广告请求不会被填充。使用本指南可以快速识别和修复加载广告时可能发生的问题。
Symptoms
尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：
[52100] Unity Ads SDK 广告加载失败：请求放置/位置没有可用的广告填充。
此报错消息表示广告加载失败，因为 Unity Ads 网络无法完成广告填充。
Causes
报错的原因可能是 Unity Ads 网络无法完成广告填充。
注意
不能保证时间广告请求都会填满。填充率取决于地区、广告系列可用性和广告市场价格，可能会随时间波动。
Resolution
如果没有广告填充并且广告无法加载，请稍后尝试重新加载广告。
如果您看到 Unity Ads 的填充率始终很低，请考虑设置 app-ads.txt 文件（或确认其配置正确）。许多广告合作伙伴只会为正确实现了文件的游戏出价。制定此标准是为了打击欺诈行为并提高广告市场的透明度。您还可以使用 Unity LevelPlay 或其他聚合合作伙伴来提高填充率。
app-ads.txt有关增加收入的其他指导，请联系您的帐户经理或 Unity 支持。
Symptoms
尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：
[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，请执行干净的重新构建以确保更新更改。
注意
广告位是根据项目和平台定义的。验证游戏 ID 和放置/位置 ID 是否属于同一 Monetization 后台配置。
Symptoms
尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：
[52103] Unity Ads SDK 广告加载失败：发生内部协议报错。稍后重试。
此报错消息表示广告加载失败，因为 SDK 在与 Unity 的广告服务器通信时遇到意外或格式错误的响应。
Causes
导致此报错的常见原因包括：
- 服务服务器应格式错误或不完整
- SDK 无法解析后端的协议
- 后端网关问题
Resolution
要解决此问题，请确保稳定的网络连接，避免使用可以修改或截断 HTTP 响应的 VPN，并重试加载广告。
如果报错仍然存在，请捕获详细日志并与 Unity 支持部门共享以供后端审查。
Symptoms
尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：
[52104] Unity Ads SDK 广告加载失败：放置/位置 ID 与广告格式或放置/位置类型不匹配。在 Unity Ads Monetization（变现）后台中检查放置/位置设置。
此报错消息表示广告加载失败，因为指定的放置/位置 ID 配置为与请求的广告格式或放置/位置类型不同的广告格式或类型。
Causes
导致此报错的常见原因包括：
- 对放置/位置使用错误的广告格式（例如，调用为奖励放置/位置 ID 加载插页广告服务的方法）
- 使用错误的广告放置/位置类型（例如，瀑布流广告放置/位置用于竞价）
- 将错误的后台配置设置为与预期不同的广告类型
- 平台不匹配，放置/位置类型可能正确，但属于另一个平台
- 在控制面板中引用已删除或修改的放置/位置
Resolution
要解决此问题，请确保在 Unity Ads Monetization（变现）后台中，广告放置/位置的广告格式与您正在使用的 API 调用相匹配，并确保加载正确的指定的于平台的广告放置/位置 ID。
Symptoms
尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：
[52105] Unity Ads SDK 广告加载失败：发生网络报错。请检查网络连接，稍后重试。
此报错消息表示广告加载失败，因为 Unity Ads SDK 在尝试加载广告时无法建立或维护与 Unity 广告投放服务器的网络连接。
Causes
导致此报错的常见原因包括：
- 无互联网连接（或设备离线或处于飞机模式）
- 正在使用的 VPN 阻挡 Unity Ads 域
- 设备无法解析 Unity Ads 终端
Resolution
要解决此问题，请确保设备具有稳定的互联网连接，禁用所有 VPN，并在确认网络可用性后重试加载广告。
Symptoms
尝试使用 Unity Ads SDK 加载广告时，会返回以下报错消息：
[52107] Unity Ads SDK 广告加载失败：解析广告响应时发生内部报错。
此报错消息表示广告加载失败，因为 Unity Ads SDK 在处理来自 Unity 服务器的广告响应时遇到内部解析报错。
Causes
导致此报错的常见原因包括：
- 服务服务器应格式错误不完整、被截断或格式不正确
- 读取广告元数据时 SDK 的解析器失败
- 过时的 SDK 用于较新的协议
- VPN 可能阻挡 Unity Ads 域
Resolution
要解决此问题，请确保稳定的网络连接，避免使用限制性防火墙或 VPN，然后稍后再尝试重新加载广告。
如果报错仍然存在，请捕获详细日志并与 Unity 支持部门共享以供后端审查。