기술 자료

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

Introduction to Unity Ads error handling

Review how and where to see Unity Ads SDK error messages to begin troubleshooting your monetization setup.
읽는 시간 1분
최근 업데이트: 한 달 전

The Unity Ads SDK provides structured error handling to help developers identify and debug issues that occur during initialization, ad loading, or ad showing. When an operation fails, the SDK returns a
UnityAdError
object that contains both an error code and an error message describing what went wrong.
By default, these errors are returned through the SDK’s public API, but aren’t automatically printed to your development environment’s console. If you want to see them in your logs, you can either use the Unity Ads SDK APIs or set up your own logging method.
참고
In production, the recommended best practice is to route Unity Ads SDK errors through your existing logging for easier monitoring and debugging.

How to display errors

There are a couple of ways to display Unity Ads SDK error messages during development and testing. You can set SDK-generated logs or log error callbacks manually.

Use the LogLevel API

With Unity Ads SDK version 4.18.0, you can set the SDK’s internal log level to control how much information displays in the console about an error. This lets you automatically surface warnings, errors, or verbose debug output from the Unity Ads SDK without adding custom print statements.
Review the LogLevel API reference and the different log verbosity levels you can set for your Kotlin and Java, Swift, or Objective-C project.

Set up your own logging method

You can also manually log SDK errors returned through callbacks using your preferred logging method by following these steps:
  1. Handle the SDK’s error callbacks.
  2. Retrieve the error code and error message from the returned object.
  3. Print or log the error using your own logging mechanism.

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

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

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

  • 보고 있는 페이지
    • How to display errors

      • Use the LogLevel API

      • Set up your own logging method


이 페이지의 문제 보고
​
​