기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Unity Ads Monetization

SDK 4.20.0

지원 가능
​

Android API reference

Unity Ads Monetization

SDK 4.20.0

지원 가능
​

이 페이지는 선택한 언어로 제공되지 않습니다.
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.
읽는 시간 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
onAdExpired
method is called.
참고
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.

Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지
    • Symptoms

    • Causes

    • Resolution

    • Symptoms

    • Causes

    • Resolution

    • Symptoms

    • Causes

    • Resolution


이 페이지의 문제 보고