Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Ads Monetization

SDK 4.20.0

Supported
​

Android API reference

Unity Ads Monetization

SDK 4.20.0

Supported
​

Android developer guides
​
​
Android developer guide
  • Introduction to the Android SDK
  • Integration requirements
  • Install the Unity Ads SDK for Android
  • Initialize the SDK in Android
  • Implement interstitial ads in Android
  • Implement rewarded ads in Android
  • Implement banner ads in Android
Troubleshoot your integration
  • Test your Unity Ads integration
  • Unity Ads SDK troubleshooting guide
  • Introduction to Unity Ads SDK error handling
  • Troubleshoot SDK initialization errors
  • Troubleshoot SDK load errors
  • Troubleshoot SDK show errors
  • Unity Ads SDK error codes reference
Android developer APIs
  • Android SDK API reference - Kotlin and Java
  • Unity Ads SDK API deprecation policy
  • Android deprecated classes
  1. Unity Ads SDK Android developer monetization
  2. Unity Ads SDK integration guide for Android developers
  3. Unity Ads troubleshooting guide

Troubleshoot SDK show errors

Solve common issues that might occur while displaying an ad during an ad request.
Read time 1 minute
Last updated a month 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.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Symptoms

    • Causes

    • Resolution

    • Symptoms

    • Causes

    • Resolution

    • Symptoms

    • Causes

    • Resolution


Report a problem with this page