Unity Ads Android SDK API 레퍼런스 - Kotlin 및 Java
Unity Ads SDK 공개 API 레퍼런스에 액세스하여 Kotlin 및 Java에서 Android 앱의 광고 동작을 연동하고 제어하는 데 사용할 수 있는 클래스, 메서드, 프로퍼티를 확인합니다.
읽는 시간 29분최근 업데이트: 18일 전
Android 애플리케이션에 Unity Ads를 연동할 때 Java 및 Kotlin용 Unity Ads Android SDK API 레퍼런스를 사용하세요.
이 API를 사용하기 전에 앱에서 Monetization을 활성화하기 위해 라이브러리를 가져왔는지 확인하세요. 자세한 내용은 UnityAds 라이브러리 가져오기를 참조하세요.
UnityAds클래스
BannerAd
BannerAdBannerLoadConfiguration
BannerAd파라미터 | 설명 | 필수 |
|---|---|---|
| 배너 배치에 대한 고유 식별자입니다. | 예 |
| 광고의 | 예 |
| 입찰 시나리오를 위한 광고 마크업입니다. | 아니요 |
| 중재 파트너 정보입니다. | 아니요 |
| 성과 추적을 위해 중재에서 사용합니다. | 아니요 |
| 추가 키-값 매개변수 맵입니다. | 아니요 |
| 배너 수명 주기 이벤트를 처리하기 위한 BannerShowListener입니다. | 아니요 |
val bannerLoadConfiguration = BannerLoadConfiguration.Builder("banner_placement", bannerSize) .withAdMarkup("ad_markup") .withMediationInfo(mediationInfo) .withMediationAdUnitId("mediation_ad_unit_id") .withExtras(mapOf("key" to "value")) .withListener(bannerListener) .build()
BannerLoadConfiguration.Builder
BannerLoadConfiguration생성자
Builder(placementId: String, bannerSize: BannerSize)
파라미터 | 설명 | 필수 |
|---|---|---|
| 배너 배치에 대한 고유 식별자입니다. | 예 |
| 광고의 | 예 |
다음을 반환:: 새 인스턴스.
BannerLoadConfiguration.Builder빌더 메서드
메서드 | 파라미터 | 필수 | 다음을 반환 | 설명 |
|---|---|---|---|---|
| | | | 광고 마크업을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 중재 정보를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 중재 광고 단위를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 추가 맵을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 표시 리스너를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| 없음 | | | 구성된 매개변수로 |
val bannerLoadConfiguration = BannerLoadConfiguration.Builder("banner_placement", bannerSize) .withAdMarkup("ad_markup") .withMediationInfo(mediationInfo) .withMediationAdUnitId("mediation_ad_unit_id") .withExtras(mapOf("key" to "value")) .withListener(bannerListener) .build()
load()
지정된 BannerLoadConfiguration으로 배너 광고를 로드합니다.
파라미터 | 설명 | 필수 |
|---|---|---|
| 배너별 로딩 옵션을 포함하는 | 예 |
| 로딩이 완료되면 호출되는 | 예 |
반환값: (void) - 즉시 반환되는 비동기 메서드입니다. 결과는 콜백을 통해 제공됩니다.
UnitBannerLoadListenerval bannerSize = BannerSize(320, 50)val loadConfig = BannerLoadConfiguration.Builder("banner_placement", bannerSize).build()BannerAd.load(loadConfig, { bannerAd, error -> if (bannerAd != null) { // 배너가 성공적으로 로드되었습니다. 이제 뷰 계층 구조에 추가할 수 있습니다. this.bannerAd = bannerAd } else { // 로드 오류 처리 }})
view
배너 광고 인스턴스에 대한 액세스를 제공하는 뷰 속성입니다. 이 속성을 사용하여 앱의 기존 뷰 계층 구조 내 원하는 위치에 배너 광고를 삽입하십시오.
반환값: (nullable View) - 배너 광고를 포함하는 Android View이며, 광고가 성공적으로 로드되지 않은 경우 null을 반환합니다.
View?// 'bannerAd'가 로드된 BannerAd 인스턴스라고 가정합니다.// 'adPlaceholder'가 광고를 표시하려는 레이아웃의 ViewGroup(예: LinearLayout, FrameLayout)이라고 가정합니다.bannerAd.view?.let { adPlaceholder.addView(it)}
BannerView
BannerViewBannerView.IListener
BannerView.IListenerBannerSize
배너 광고의 크기를 나타내는 데이터 클래스입니다.
파라미터 | 설명 | 필수 |
|---|---|---|
| 픽셀 단위의 배너 너비입니다. | 예 |
| 픽셀 단위의 배너 높이입니다. | 예 |
val bannerSize = BannerSize(320, 50)
UnityBannerSize
UnityBannerSizeInitializationConfiguration
SDK 초기화를 위한 모든 설정을 포함하는 클래스입니다. 이 클래스의 인스턴스는 을(를) 사용하여 생성됩니다.
Builder파라미터 | 설명 | 필수 |
|---|---|---|
| Unity Ads Monetization 대시보드에서 제공하는 고유 게임 식별자입니다. | 예 |
| 테스트 모드를 활성화하는 불리언 값입니다. true로 설정하면 테스트 광고만 표시됩니다. 기본값은 거짓입니다. | 아니요 |
| 로그 출력의 세부 정보 수준을 지정합니다. | 아니요 |
| 중재 파트너에 대한 정보가 포함된 객체입니다. | 아니요 |
| 고급 구성을 위한 추가 키-값 매개변수 맵입니다. | 아니요 |
InitializationConfiguration.Builder
InitializationConfiguration생성자
Builder(gameId: 문자열)
파라미터 | 설명 | 필수 |
|---|---|---|
| Unity Ads Monetization 대시보드에서 제공하는 고유 게임 식별자입니다. | 예 |
다음을 반환:: 새 인스턴스.
InitializationConfiguration.Builder빌더 메서드
메서드 | 파라미터 | 필수 | 다음을 반환 | 설명 |
|---|---|---|---|---|
| | | | 테스트 모드를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 로그 수준을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 중재 정보를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 추가 맵을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| 없음 | | | 구성된 매개변수로 |
val config = InitializationConfiguration.Builder("YOUR_GAME_ID") .withTestMode(true) .withLogLevel(LogLevel.DEBUG) .withMediationInfo(mediationInfo) .withExtras(mapOf("key" to "value")) .build()
initialize()
지정된 구성으로 Unity Ads SDK를 초기화합니다. 은(는) 초기화가 성공 또는 실패로 완료될 때 호출됩니다.
InitializationListener파라미터 | 설명 | 필수 |
|---|---|---|
| SDK를 초기화하는 데 필요한 설정이 포함된 | 지원 안 함 |
| | 아니요 |
반환값: (void) - 즉시 반환되는 비동기 메서드입니다. 결과는 콜백을 통해 제공됩니다.
UnitInitializationListener@OptIn(UnityAdsExperimental::class)fun initializeUnityAds(context: 컨텍스트) { val config = InitializationConfiguration.Builder("YOUR_GAME_ID") .withTestMode(true) .build() val listener = InitializationListener { error -> if (error == null) { // Initialization successful } else { // Handle initialization error } } UnityAds.initialize(config, listener)}
InterstitialAd
InterstitialAdload()
지정된 LoadConfiguration으로 인터스티셜 광고를 로드합니다.
파라미터 | 설명 | 필수 |
|---|---|---|
| 광고 로드 옵션을 포함하는 | 지원 안 함 |
| 로드가 완료되었을 때 호출되는 | 아니요 |
InterstitialAd.load(loadConfig, {interstitialAd, error -> if (interstitialAd != null) { // 광고 로드 성공, 표시 준비 완료 this.interstitialAd = interstitialAd } else { // 로드 오류 처리 }})
show()
이전에 로드된 인터스티셜 광고를 표시합니다.
파라미터 | 설명 | 필수 |
|---|---|---|
| 광고 표시 옵션을 포함하는 | 지원 안 함 |
| 광고 수명 주기 이벤트를 처리하기 위한 선택적 | 아니요 |
반환값: (void) - 이 메서드는 광고 표시 프로세스를 시작한 후 즉시 반환됩니다. 수명 주기 이벤트는 콜백을 통해 제공됩니다.
UnitShowListenerinterstitialAd.show(showConfig, interstitialShowListener)
LoadConfiguration
InterstitialAdRewardedAd파라미터 | 설명 | 필수 |
|---|---|---|
| Unity 수익화 대시보드에서 찾을 수 있는 광고 게재 위치의 고유 식별자. | 예 |
| 입찰 시나리오를 위한 광고 마크업. | 아니요 |
| 미디에이션 파트너 정보. | 아니요 |
| 성과 추적을 위해 미디에이션에서 사용됩니다. | 아니요 |
| 추가 키-값 매개변수 맵입니다. | 아니요 |
val loadConfiguration = LoadConfiguration.Builder("interstitial_placement") .withAdMarkup("ad_markup") .withMediationInfo(mediationInfo) .withMediationAdUnitId("mediation_ad_unit_id") .withExtras(mapOf("key" to "value")) // 이 메서드를 여러 번 호출하면 이전 값이 재정의됩니다. .build()
LoadConfiguration.Builder
LoadConfiguration생성자
Builder(placementId: 문자열)
파라미터 | 설명 | 필수 |
|---|---|---|
| Unity 수익화 대시보드에서 찾을 수 있는 광고 게재 위치의 고유 식별자. | 예 |
다음을 반환: 새 인스턴스입니다.
LoadConfiguration.Builder빌더 메서드
메서드 | 파라미터 | 필수 | 다음을 반환: | 설명 |
|---|---|---|---|---|
| | 지원 안 함 | | 광고 마크업을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | 아니요 | | 미디에이션 정보를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | 아니요 | | 미디에이션 광고 단위 ID를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | 아니요 | | 추가 맵을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| 없음 | 아니요 | | 구성된 매개변수로 |
UnityAdsLoadOptions
UnityAdsLoadOptionsMediationInfo
사용 중인 미디에이션 파트너에 대한 정보가 포함된 클래스입니다.
파라미터 | 설명 | 필수 |
|---|---|---|
| 미디에이션 파트너의 이름입니다. | 예 |
| 미디에이션 파트너 SDK의 버전입니다. | 예 |
| 미디에이션 파트너용 Unity Ads 어댑터 버전입니다. | 예 |
val mediationInfo = MediationInfo("partner_name", "1.2.3", "4.5.6")
MediationMetaData
MediationMetaDataRewardedAd
RewardedAdload()
지정된 으로 보상형 동영상 광고를 로드합니다.
LoadConfiguration파라미터 | 설명 | 필수 |
|---|---|---|
| 광고 로드 옵션을 포함하는 | 예 |
| 로드가 완료되면 호출되어 RewardedAd 인스턴스나 오류를 제공하는 | 예 |
RewardedAd.load(loadConfig, { rewardedAd, error -> if (rewardedAd != null) { // 광고 로드 성공, 표시 준비 완료 this.rewardedAd = rewardedAd } else { // 로드 오류 처리 }})
show()
이전에 로드된 보상형 광고를 표시합니다.
파라미터 | 설명 | 필수 |
|---|---|---|
| 광고 표시 옵션을 포함하는 | 예 |
| 사용자 보상 콜백을 포함한 광고 이벤트를 처리하기 위한 선택적 | 예 |
반환값: (void) - 이 메서드는 광고 표시 프로세스를 시작한 후 즉시 반환됩니다. 수명 주기 이벤트는 콜백을 통해 제공됩니다.
UnitShowListenerrewardedAd.show(showConfig, rewardedAdShowListener)
ShowConfiguration
InterstitialAdRewardedAd파라미터 | 설명 | 필수 |
|---|---|---|
| 완료를 추적하는 데 사용됩니다. | 지원 안 함 |
| 광고를 표시할 때 전달되는 추가 키-값 매개변수의 맵입니다. | 아니요 |
val showConfiguration = ShowConfiguration.Builder().withCustomRewardString("custom_reward_string").withExtras(mapOf("key" to "value")).build()
ShowConfiguration.Builder
ShowConfiguration생성자
Builder()
다음을 반환: 새 인스턴스입니다.
ShowConfiguration.Builder빌더 메서드
메서드 | 파라미터 | 필수 | 다음을 반환: | 설명 |
|---|---|---|---|---|
| | | | 사용자 지정 보상 문자열을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 추가 항목 맵을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| 없음 | | | 구성된 매개변수로 |
UnityAdsShowOptions
UnityAdsShowOptionsTokenConfiguration
입찰 토큰을 생성하기 위한 설정을 포함하는 클래스입니다.
파라미터 | 설명 | 필수 |
|---|---|---|
| 토큰을 생성할 AdFormat(예: | 예 |
| 미디에이션 파트너에 대한 정보를 포함하는 객체입니다. | 아니요 |
| 추가 키-값 매개변수의 맵입니다. | 아니요 |
val tokenConfig = TokenConfiguration.Builder(AdFormat.REWARDED) .withMediationInfo(mediationInfo) .withExtras(extras) .build()
TokenConfiguration.Builder
TokenConfiguration생성자
Builder(adFormat: AdFormat)
파라미터 | 설명 | 필수 |
|---|---|---|
| 토큰을 생성할 광고 형식(예: | 예 |
다음을 반환:: 새 인스턴스입니다.
TokenConfiguration.Builder빌더 메서드
메서드 | 파라미터 | 필수 | 다음을 반환: | 설명 |
|---|---|---|---|---|
| | | | 중재 정보를 설정하고 체이닝을 위해 빌더를 반환합니다. |
| | | | 추가 맵을 설정하고 체이닝을 위해 빌더를 반환합니다. |
| 없음 | | | 구성된 매개변수로 |
getToken
제공된 을(를) 기반으로 입찰 토큰을 가져와 토큰 리스너에 전달합니다.
TokenConfiguration파라미터 | 설명 | 필수 |
|---|---|---|
| 광고 형식, 중재 정보 및 기타 매개변수를 지정하는 | 예 |
| 토큰을 성공적으로 가져오면 토큰과 함께 호출되고, 오류가 발생하면 null과 함께 호출되는 리스너입니다. | 예 |
다음을 반환: (void) - 즉시 반환되는 비동기 메서드입니다. 결과는 콜백을 통해 제공됩니다.
UnitTokenListenerUnityAds.getToken(tokenConfig, listener)
UnityAds
UnityAds 클래스는 SDK의 기본 진입점 역할을 하는 정적 클래스입니다. 이 클래스는 초기화, 토큰 검색을 처리하며 전역 SDK 속성에 대한 액세스를 제공합니다.
정적 변수
isInitialized
Unity Ads SDK가 성공적으로 초기화되었는지 여부를 결정하는 부울 속성입니다.
반환값: Unity Ads SDK가 성공적으로 초기화된 경우 true입니다.
val isInitialized = UnityAds.isInitialized
version
현재 Unity Ads SDK 버전을 반환하는 문자열 속성입니다.
다음을 반환:: 현재 설치된 Unity Ads SDK 버전입니다.
val sdkVersion = UnityAds.version
userIdentifier
앱의 각 사용자에 대한 고유 ID를 나타내는 문자열 속성입니다.
다음을 반환:: 현재 값입니다.
UnityAds.userIdentifier = "my-user-id"
개인정보
다음 메서드를 사용하여 개인정보 보호 및 사용자 동의 플래그를 설정하고 지원되는 개인정보 보호 규정을 준수하십시오.
setUserConsent()
개인 맞춤형 광고에 대한 사용자의 옵트인 선택 사항을 표시합니다.
setUserOptOut()
사용자에게 데이터 수집 및 개인 맞춤형 광고 수신 거부 옵션을 제공합니다.
setNonBehavioral()
문맥 기반(비개인 맞춤형) 광고 표시를 활성화합니다.
UnityAds.userConsent = trueUnityAds.userOptOut = falseUnityAds.nonBehavioral = false
MetaData
MetaDataUnityAdsError
class UnityAdsError internal constructor( val code: Int, val message: 문자열)
Unity Ads에서 오류가 발생할 경우 public에서 반환되는 예외입니다.
파라미터 | 설명 |
|---|---|
| 오류와 관련된 메시지입니다. |
| 오류에 대한 코드입니다. |
BannerErrorCode
BannerErrorCodeBannerErrorInfo
BannerErrorInfoUnityAds.UnityAdsInitializationError
UnityAds.UnityAdsInitializationErrorUnityAds.UnityAdsLoadError
UnityAds.UnityAdsLoadErrorUnityAds.UnityAdsShowError
UnityAds.UnityAdsShowError인터페이스
BannerLoadListener
BannerAdBannerAd메서드 서명
fun interface BannerLoadListener { fun onBannerLoaded(bannerAd: BannerAd?, error: UnityAdsError?)}
메서드 | 매개변수 | 설명 |
|---|---|---|
| | 배너 광고 로드 요청이 완료되면 호출됩니다. 매개변수 중 정확히 하나는 null이 아닙니다. |
val bannerLoadListener = BannerLoadListener { bannerAd, error -> if (bannerAd != null) { // 배너 로드 성공 this.bannerAd = bannerAd // 뷰 계층 구조에 banner.view를 추가합니다 } else { // 로드 오류 처리 Log.e(\"UnityAds\", \"Banner load failed: ${error?.message}\") }}
BannerShowListener
BannerAd메서드 서명
interface BannerShowListener { fun onBannerShown(bannerAd: BannerAd) fun onBannerClicked(bannerAd: BannerAd) fun onBannerFailedToShow(bannerAd: BannerAd, error: UnityAdsError)}
메서드 | 매개변수 | 설명 |
|---|---|---|
| | 배너 광고가 화면에 성공적으로 표시되면 호출됩니다. |
| | 사용자가 배너 광고를 클릭했을 때 호출됩니다. |
| | 배너 광고 표시가 실패하면 호출됩니다. |
val bannerShowListener = object : BannerShowListener { override fun onBannerShown(bannerAd: BannerAd) { Log.d(\"UnityAds\", \"배너 표시됨\") } override fun onBannerClicked(bannerAd: BannerAd) { Log.d("UnityAds", "Banner clicked") } override fun onBannerFailedToShow(bannerAd: BannerAd, error: UnityAdsError) { Log.e(\"UnityAds\", \"배너 표시 실패: ${error.message}\") }}
InitializationListener
SDK 초기화 상태에 대한 콜백을 수신하기 위한 인터페이스입니다. 이 리스너는 SDK 초기화 프로세스가 완료되면 호출됩니다.
메서드 서명
fun interface InitializationListener { fun onInitializationComplete(error: UnityAdsError?)}
메서드 | 매개변수 | 설명 |
|---|---|---|
| | SDK 초기화가 완료되면 호출됩니다. error가 null이면 초기화가 성공한 것입니다. |
val listener = InitializationListener { error -> if (error == null) { Log.d("UnityAds", "SDK가 성공적으로 초기화되었습니다.") } else { Log.e("UnityAds", "SDK 초기화 실패: ${error.message}") }}
IUnityAdsInitializationListener
IUnityAdsInitializationListenerInterstitialLoadListener
InterstitialAdInterstitialAd메서드 서명
fun interface InterstitialLoadListener { fun onInterstitialLoaded(interstitialAd: InterstitialAd?, error: UnityAdsError?)}
메서드 | 매개변수 | 설명 |
|---|---|---|
| | 전면 광고 로드 요청이 완료되면 호출됩니다. 매개변수 중 정확히 하나는 null이 아닙니다. |
val interstitialLoadListener = InterstitialLoadListener { interstitialAd, error -> if (interstitialAd != null) { // 전면 광고가 성공적으로 로드됨 this.interstitialAd = interstitialAd // 이제 광고를 표시할 수 있습니다 } else { // 로드 오류 처리 Log.e("UnityAds", "전면 광고 로드 실패: ${error?.message}") }}
RewardedLoadListener
RewardedAdRewardedAd메서드 서명
fun interface RewardedLoadListener { fun onRewardedLoaded(rewardedAd: RewardedAd?, error: UnityAdsError?)}
메서드 | 파라미터 | 설명 |
|---|---|---|
| | 보상형 광고 로드 요청이 완료되면 호출됩니다. 파라미터 중 하나는 반드시 null이 아닙니다. |
val rewardedLoadListener = RewardedLoadListener { rewardedAd, error -> if (rewardedAd != null) { // 보상형 광고 로드 성공 this.rewardedAd = rewardedAd // 이제 광고를 표시할 수 있습니다 } else { // 로드 오류 처리 Log.e(\"UnityAds\", \"Rewarded ad load failed: ${error?.message}\") }}
IUnityAdsLoadListener
IUnityAdsLoadListenerShowListener
ShowAdRewardedAd메서드 서명
interface ShowListener<T> { fun onStarted(unityAd: T) fun onClicked(unityAd: T) fun onCompleted(unityAd: T, 상태: ShowFinishState) fun onFailed(unityAd: T, 오류: UnityAdsError)}interface InterstitialShowListener : ShowListener<InterstitialAd>// Specialized listener for RewardedAd with reward callbackinterface RewardedShowListener : ShowListener<RewardedAd> { fun onRewarded(unityAd: RewardedAd)}
메서드 | 파라미터 | 설명 |
|---|---|---|
| | 광고가 화면에 표시되기 시작할 때 호출됩니다. |
| | 사용자가 광고를 클릭할 때 호출됩니다. |
| | 광고 표시가 완료될 때 호출됩니다. 보상형 광고의 경우, |
| | 광고 표시에 실패할 때 호출됩니다. |
| | 사용자가 보상형 광고를 끝까지 시청하여 보상을 획득했을 때 호출됩니다. |
val interstitialListener = object : InterstitialShowListener { override fun onStarted(unityAd: InterstitialAd) { // 작업 수행 } override fun onClicked(unityAd: InterstitialAd) { // Do something } override fun onCompleted(unityAd: InterstitialAd, 상태: ShowFinishState) { // Do something } override fun onFailed(unityAd: InterstitialAd, error: UnityAdsError) { // Do something }}val rewardedListener = object : RewardedShowListener { override fun onStarted(unityAd: RewardedAd) { // Do something } override fun onClicked(unityAd: RewardedAd) { // Do something } override fun onCompleted(unityAd: RewardedAd, 상태: ShowFinishState) { // Do something } override fun onFailed(unityAd: RewardedAd, 오류: UnityAdsError) { // Do something } override fun onRewarded(unityAd: RewardedAd) { // Do something }}
IUnityAdsShowListener
IUnityAdsShowListenerTokenListener
getToken메서드 서명
fun interface TokenListener { fun onTokenReady(token: String?)}
메서드 | 파라미터 | 설명 |
|---|---|---|
| | 토큰 요청이 완료되면 호출됩니다. 토큰은 입찰을 위해 미디에이션 파트너의 SDK로 전달되어야 합니다. |
val listener = TokenListener { token -> if (token != null) { // 토큰을 미디에이션 파트너의 SDK로 전달하십시오 Log.d("UnityAds", "토큰 수신됨: $token") } else { // 토큰 검색 실패 처리 Log.e(\"UnityAds\", \"토큰 검색 실패\") }}
onAdExpired
InterstitialAdRewardedAd메서드 서명
// On InterstitialAdvar onAdExpired: AdExpiredListener?// On RewardedAdvar onAdExpired: AdExpiredListener?fun interface AdExpiredListener { fun onAdExpired(ad: T) // T는 InterstitialAd 또는 RewardedAd입니다.}
파라미터 | 설명 |
|---|---|
| (필수) 광고가 만료될 때 만료된 광고 인스턴스를 수신하는 함수입니다. |
반환값: (void) - 이 메서드는 콜백을 등록하고 즉시 반환합니다.
Unit// For InterstitialAdinterstitialAd.onAdExpired = AdExpiredListener { ad -> // 광고 만료 처리 - 새 광고 로드 Log.d(\"UnityAds\", \"전면 광고가 만료되었습니다\") // 새 광고 로드}// For RewardedAdrewardedAd.onAdExpired = AdExpiredListener { ad -> // Handle ad expiration - load a new ad Log.d(\"UnityAds\", \"보상형 광고가 만료되었습니다\") // Load a new ad}
열거형
AdFormat
다양한 광고 형식에 대해 정의된 열거형입니다.
값 | 설명 |
|---|---|
| 앱의 자연스러운 전환 시점에 표시되는 전체 화면 광고로, 몇 초 후에 건너뛸 수 있습니다. |
| 사용자가 인앱 보상을 받기 위해 옵트인하여 시청하는 전체 화면 광고입니다. |
| 일반적으로 화면 상단이나 하단에 화면의 일부를 차지하는 광고입니다. |
LogLevel
다양한 로그 상세 수준에 대한 열거형입니다.
값 | 설명 |
|---|---|
| Unity Ads와 관련된 로그를 출력하지 않습니다. |
| 기본 수준입니다. 표준 통합 및 수명 주기 메시지를 표시합니다. |
| 디버깅 목적으로 상세한 로그를 표시합니다. |
| 초기화/로드/표시 작업에서 발생하는 필수 오류와 개발자가 주의해야 할 치명적인 실패입니다. |
ShowFinishState
광고가 표시된 후의 최종 상태를 설명하는 열거형입니다.
값 | 설명 |
|---|---|
| 사용자가 광고가 끝나기 전에 건너뛰었습니다. |
| 광고를 끝까지 시청했습니다. |
UnityAds.UnityAdsShowCompletionState
UnityAds.UnityAdsShowCompletionState