Documentation

Unity Ads Monetization

iOS API reference - Swift

iOS API reference - Objective-C

Unity Ads Monetization

Troubleshoot SDK show errors

Solve common issues that might occur while displaying an ad during an ad request.
Read time 1 minuteLast updated a day ago
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 
onAdExpired
method is called.
Note
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.
Note
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.