文档

Unity Ads 变现


Android API 参考

Unity Ads 变现


Troubleshoot SDK 显示的错误

解决在广告请求期间展示广告时可能出现的常见问题。
阅读时间1 分钟最后更新于 1 个月前

当 Unity Ads SDK 无法获取要显示的广告内容时,会出现这些错误。如果无法成功显示广告服务,则无法完成广告请求。使用本指南可以快速识别和修复展示广告时可能发生的问题。

Symptoms

尝试使用 Unity Ads SDK 展示广告时,会返回以下报错消息:
[52200] Unity Ads SDK 广告展示失败:该广告已过期。加载新广告。
此报错消息表示广告在发出展示请求之前已过期。

Causes

报错的常见原因是加载和显示广告之间花费的时间过长。

Resolution

要解决此问题,请在调用
onAdExpired
方法后加载新广告。
注意
请考虑添加回退逻辑以避免将来出现此报错。如果广告失败并报错,则自动触发器重新加载广告。

Symptoms

尝试使用 Unity Ads SDK 展示广告时,会返回以下报错消息:
[52201] Unity Ads SDK 广告展示失败:已在展示广告。等待当前广告完成,然后再显示新广告。
此报错消息表示已显示另一个插页式或奖励广告。

Causes

导致此报错的常见原因包括:
  • app 连续两次快速调用 show 方法(例如,双击“Watch ad”按钮会触发两个 show 请求)
  • app 在触发上一个完成回调之前触发另一个广告展示
  • 尝试并行显示两个不同的广告服务(例如,尝试在插页式广告仍然可见时显示奖励广告)

Resolution

要解决此问题,请确保插页式广告和奖励广告服务一时间只显示一个广告。
注意
请考虑添加回退逻辑以避免将来出现此报错。等待当前广告完成并触发其回调,然后再次调用 show 方法。

Symptoms

尝试使用 Unity Ads SDK 展示广告时,会返回以下报错消息:
[52202] Unity Ads SDK 广告展示失败:发生内部报错。
此报错消息表示 Unity Ads SDK 在尝试显示广告时遇到意外的内部故障。

Causes

导致此报错的常见原因包括:
  • 渲染失败
  • 缺少广告素材资源
  • 广告数据损坏

Resolution

要解决此问题,请确保 SDK 已完全初始化并处于最新状态,然后尝试重新加载并显示新广告。
如果报错仍然存在,请捕获详细日志并与 Unity 支持部门共享以供后端审查。