Troubleshoot SDK show errors
Solve common issues that might occur while displaying an ad during an ad request.
阅读时间1 分钟最后更新于 1 个月前
These errors occur when the Unity Ads SDK can't fetch ad content to display. If ads can't be successfully displayed, the ad request can't be completed. Use this guide to quickly identify and fix issues that might occur when showing an ad.
Symptoms
When you try to show an ad using the Unity Ads SDK, the following error message is returned:
[52200] Unity Ads SDK ad show failed : The ad has expired. Load a new ad.
This error message indicates that the ad expired before a show request was made.
Causes
The common reason for this error is that too much time passed between loading and showing an ad.
Resolution
To resolve this issue, load a new ad after the method is called.
onAdExpired注意
Consider adding fallback logic to avoid this error in the future. If an ad fails with this error, trigger a fresh ad load automatically.
Symptoms
When you try to show an ad using the Unity Ads SDK, the following error message is returned:
[52201] Unity Ads SDK ad show failed : An ad is already being shown. Wait until the current ad finishes before showing a new one.
This error message indicates that another interstitial or rewarded ad is already being displayed.
Causes
Common reasons for this error include:
- The app calls the show method twice in rapid succession (for example, a double tap on the "Watch ad" button triggers two show requests)
- The app triggers another ad show before the previous one's completion callback fires
- You try to show two different ads in parallel (for example, trying to show a rewarded ad while an interstitial ad is still visible)
Resolution
To resolve this issue, ensure only one ad is shown at a time for interstitial and rewarded ads.
注意
Consider adding fallback logic to avoid this error in the future. Wait for the current ad to finish and its callback to fire before calling the show method again.
Symptoms
When you try to show an ad using the Unity Ads SDK, the following error message is returned:
[52202] Unity Ads SDK ad show failed : Internal error occurred.
This error message indicates that the Unity Ads SDK encountered an unexpected internal failure while attempting to display an ad.
Causes
Common reasons for this error include:
- Rendering failure
- Missing creative assets
- Corrupted ad data
Resolution
To resolve this issue, ensure the SDK is fully initialized and up-to-date, then try reloading and showing a new ad.
If the error persists, capture detailed logs and share them with Unity Support for backend review.