기술 자료

Unity Ads Monetization

버전:

Android API 참조

Unity Ads Monetization

버전:

Android 지원 중단 API들

Android용 Unity Ads SDK의 지원 중단된 클래스와 대체 및 제거 버전을 식별합니다.

읽는 시간 11분

최근 업데이트: 24일 전

Android 지원 중단 클래스들

다음 API 클래스들은 Unity Ads SDK 버전 4.19.0의 Android SDK에서 지원 중단 예정이거나 더 이상 사용되지 않습니다.

초기화

제거 예정인 API	해당 버전에서 사용 중단 예정	대신 사용할 항목	해당 버전에서 제거됨	지원 중단 사유
`UnityAds.initialize(context, gameId, isTesting, IUnityAdsInitializationListener)`	4.19.0	`UnityAds.initialize(InitializationConfiguration, InitializationListener)` `InitializationConfiguration.Builder(gameId)` (으)로 빌드됨	5.0.0	통합된 단일 메서드 리스너가 있는 빌더 기반 구성 API로 대체되었습니다. 미디에이션 정보는 이제 빌더를 통해 초기화 시점에 전달됩니다.
`IUnityAdsInitializationListener` 인터페이스 ( `onInitializationComplete()` / `onInitializationFailed(UnityAdsInitializationError, String)` )	4.19.0	`InitializationListener` (단일 `onInitializationComplete(@Nullable UnityAdsError)` 포함) — `null` 은(는) 성공을 의미함	5.0.0	두 개의 메서드로 구성된 델리게이트가 통합 `UnityAdsError` 모델과 일관되도록 단일 nullable-error 콜백으로 대체되었습니다.
`MediationMetaData` 클래스	4.19.0	`MediationInfo` — `new MediationInfo(name, sdkVersion, adapterVersion)` (으)로 생성되어 각 빌더의 `.withMediationInfo()` 를 통해 전달됨	5.0.0	변경 가능한 키-값 메타데이터 객체가 빌더 API에 직접 전달되는 변경 불가능한 유형의 값 객체로 대체되었습니다.
`MetaData` 클래스(개인정보 보호 및 미디에이션 키-값 쌍에 사용)	4.19.0	미디에이션 데이터에는 `MediationInfo` 을(를) 사용하고, 개인정보 보호에는 `UnityAds.setUserConsent()` , `setUserOptOut()` , `setNonBehavioral()` 을(를) 사용하세요	5.0.0	일반 문자열 키-값 메타데이터가 유형이 지정된 목적별 API로 대체되었습니다.
`UnityAds.UnityAdsInitializationError` 열거형	4.19.0	통합 `UnityAdsError` — `error.getCode()` (int) 및 `error.getMessage()` (String) 사용	5.0.0	작업별 오류 열거형이 모든 작업에서 표준화된 숫자 코드를 사용하는 통합 오류 유형으로 대체되었습니다.

인터스티셜 광고

사용

사용

제거 예정인 API	해당 버전에서 사용 중단 예정	대신 사용할 항목	해당 버전에서 제거됨	지원 중단 사유
`UnityAds.load(placementId, UnityAdsLoadOptions, IUnityAdsLoadListener)`	4.19.0	`InterstitialAd.load(LoadConfiguration, LoadListener<InterstitialAd>)` built via `LoadConfiguration.Builder(placementId)`	5.0.0	정적 일반 로드가 유형별 인스턴스 기반 로드 API로 대체되었습니다.
`IUnityAdsLoadListener` 인터페이스 ( `onUnityAdsAdLoaded` / `onUnityAdsFailedToLoad` )	4.19.0	`LoadListener<InterstitialAd>` 단일 `onAdLoaded(@Nullable InterstitialAd, @Nullable UnityAdsError)`	5.0.0	두 개의 메서드가 있는 리스너가 유형화된 광고 인스턴스도 전달하는 단일 nullable 오류 콜백으로 대체되었습니다.
`UnityAdsLoadOptions`	4.19.0	`LoadConfiguration.Builder(placementId)` `.withMediationInfo()` 및 `.withAdMarkup()`	5.0.0	변경 가능한 옵션 객체가 변경 불가능한 빌더 패턴 구성으로 대체되었습니다.
`UnityAdsLoadOptions.setObjectId(UUID)`	4.19.0	대체 항목 없음 — 객체 ID는 이제 SDK에서 내부적으로 관리합니다	5.0.0	수동 상관관계 ID는 더 이상 필요하지 않으며, SDK가 광고 인스턴스 추적을 내부적으로 처리합니다.
`UnityAds.show(activity, placementId, UnityAdsShowOptions, IUnityAdsShowListener)`	4.19.0	`interstitialAd.show(activity, ShowConfiguration, InterstitialShowListener)` 유지된 `InterstitialAd` 인스턴스에서 호출됨	5.0.0	전역 클래스의 정적 show가 로드된 광고 객체의 인스턴스 메서드로 대체되었습니다.
`IUnityAdsShowListener` 인터페이스(인터스티셜 광고) — `onUnityAdsShowStart` , `onUnityAdsShowClick` , `onUnityAdsShowComplete` , `onUnityAdsShowFailure`	4.19.0	`InterstitialShowListener` — `onStarted(InterstitialAd)` , `onClicked(InterstitialAd)` , `onCompleted(InterstitialAd, ShowFinishState)` , `onFailed(InterstitialAd, UnityAdsError)`	5.0.0	문자열 키 기반의 일반 show 리스너가 유형화된 광고 전용 리스너로 대체되었습니다. 콜백은 게재위치 ID 문자열 대신 광고 인스턴스를 수신합니다.
`UnityAdsShowOptions`	4.19.0	`ShowConfiguration.Builder().build()`	5.0.0	변경 가능한 옵션 객체가 변경 불가능한 빌더 패턴 구성으로 대체되었습니다.
`UnityAdsShowOptions.setObjectId()`	4.19.0	대체 항목 없음 — 객체 ID는 내부적으로 관리됩니다	5.0.0	수동 상관관계 ID는 더 이상 필요하지 않습니다.
`UnityAds.UnityAdsLoadError` 열거형	4.19.0	통합된 `UnityAdsError` 및 `getCode()` 와 `getMessage()`	5.0.0	작업별 오류 열거형이 통합 오류 유형으로 대체되었습니다.
`UnityAds.UnityAdsShowError` 열거형	4.19.0	통합 `UnityAdsError` 및 `getCode()` 와(과) `getMessage()`	5.0.0	작업별 오류 열거형이 통합 오류 유형으로 대체되었습니다.

보상형 광고

포함

제거 예정인 API	해당 버전에서 사용 중단 예정	대신 사용할 항목	해당 버전에서 제거됨	지원 중단 사유
`UnityAds.load(placementId, UnityAdsLoadOptions, IUnityAdsLoadListener)`	4.19.0	`RewardedAd.load(LoadConfiguration, LoadListener<RewardedAd>)` built via `LoadConfiguration.Builder(placementId)`	5.0.0	정적 일반 로드가 유형별 인스턴스 기반 로드 API로 대체되었습니다.
`IUnityAdsLoadListener` 인터페이스	4.19.0	`LoadListener<RewardedAd>` 단일 `onAdLoaded(@Nullable RewardedAd, @Nullable UnityAdsError)` 로	5.0.0	두 개의 메서드 리스너가 유형이 지정된 광고 인스턴스를 전달하는 단일 nullable-error 콜백으로 대체되었습니다.
`UnityAds.show(activity, placementId, UnityAdsShowOptions, IUnityAdsShowListener)`	4.19.0	`rewardedAd.show(activity, ShowConfiguration, RewardedShowListener)` 유지된 `RewardedAd` 인스턴스에서 호출됨	5.0.0	전역 클래스의 정적 show가 로드된 광고 객체의 인스턴스 메서드로 대체되었습니다.
`IUnityAdsShowListener` 인터페이스 — `UnityAdsShowCompletionState.COMPLETED` 내부의 `onUnityAdsShowComplete` 을(를) 확인하여 보상 결정	4.19.0	`RewardedShowListener` 전용 `onRewarded(RewardedAd)` 콜백 및 `onStarted` , `onClicked` , `onCompleted(RewardedAd, ShowFinishState)` , `onFailed(RewardedAd, UnityAdsError)`	5.0.0	보상 자격에 대한 완료 상태 확인이 전용 보상 콜백으로 대체되었습니다. 참고: `onCompleted` 은(는) `onRewarded` 이후에도 계속 실행됩니다.
`UnityAds.UnityAdsShowCompletionState` 열거형 ( `COMPLETED` , `SKIPPED` )	4.19.0	`ShowFinishState` 열거형; 보상 로직이 `RewardedShowListener.onRewarded()` (으)로 이동되었습니다.	5.0.0	일관성을 위해 열거형 이름이 변경되었습니다. 보상 부여 로직은 완료 상태를 검사하는 대신 전용 `onRewarded` 콜백을 사용해야 합니다.

제거 예정인 API	해당 버전에서 사용 중단 예정	대신 사용할 항목	해당 버전에서 제거됨	지원 중단 사유
`BannerView` 클래스 ( `com.unity3d.services.banners` )	4.19.0	`BannerAd` 클래스 ( `com.unity3d.ads` ) — Android `View` 은(는) `ad.getView()` 을(를) 통해 검색됩니다.	5.0.0	직접 뷰 클래스가 새로운 광고 객체 모델과 일관되게 게터를 통해 뷰에 액세스하는 광고 인스턴스 객체로 대체되었습니다.
`BannerView.IListener` 인터페이스 — `onBannerLoaded` , `onBannerFailedToLoad` , `onBannerShown` , `onBannerClick` , `onBannerLeftApplication`	4.19.0	두 개의 별도 리스너: 로드 결과( `onAdLoaded` )를 위한 `LoadListener<BannerAd>` ; 노출( `onImpression` ), 클릭 수( `onClicked` ) 및 표시 실패( `onFailedToShow` )를 위한 `BannerShowListener`	5.0.0	단일 결합 리스너가 별도의 로드 및 표시 리스너로 분할되었습니다. `onBannerLeftApplication` 은(는) 대체 없이 제거되었습니다.
`BannerView.load(UnityAdsLoadOptions)`	4.19.0	`BannerAd.load(BannerConfiguration, LoadListener<BannerAd>)` 을(를) 통해 빌드되었습니다 `BannerConfiguration.Builder(placementId, BannerSize, BannerShowListener)`	5.0.0	생성자 + 별도의 로드 메서드가 전면 광고 및 보상형 광고와 일관되게 빌더 구성이 포함된 통합 정적 로드로 대체되었습니다.
`UnityBannerSize` 클래스	4.19.0	`BannerSize` 클래스 — 적응형 크기 조정(고정 및 인라인)도 지원합니다	5.0.0	네임스페이스 일관성을 위해 이름이 변경되었습니다. 새 클래스는 적응형 배너 크기 지원도 추가합니다.
`BannerErrorCode` / `BannerErrorInfo`	4.19.0	`UnityAdsError` 을(를) `getCode()` 및 `getMessage()` 와(과) 통합	5.0.0	배너 전용 오류 유형이 모든 광고 형식에서 사용되는 통합 오류 유형으로 대체되었습니다.
`onBannerLeftApplication` `BannerView.IListener` 의 콜백	4.19.0	대체 메서드/프로퍼티 없음	5.0.0	콜백이 제거되었으며 새로운 `BannerShowListener` 에 대응하는 기능이 없습니다.

개인정보

제거 예정인 API	해당 버전에서 사용 중단 예정	대신 사용할 항목	해당 버전에서 제거됨	지원 중단 사유
`MetaData` (키 `"gdpr.consent"` 포함)	4.19.0	`UnityAds.setUserConsent(boolean)`	5.0.0	문자열 키-값 개인정보 보호 메타데이터가 유형이 지정된 정적 메서드로 대체되었습니다. `context` 은(는) 더 이상 필요하지 않습니다.
`MetaData` (키 `"privacy.consent"` 포함) (CCPA)	4.19.0	`UnityAds.setUserOptOut(boolean)` — 사용자가 수신 거부(판매 금지)한 경우 `true` 을(를) 전달하세요	5.0.0	문자열 키-값 개인정보 보호 메타데이터가 명시적 수신 거부 의미 체계를 갖춘 유형이 지정된 정적 메서드로 대체되었습니다.
`MetaData` (키 `"user.nonBehavioral"` 포함) (COPPA(아동 온라인 프라이버시 보호법))	4.19.0	`UnityAds.setNonBehavioral(false)`	5.0.0	개인정보 보호 모드 문자열이 비행동/문맥 광고 제어를 위한 명시적 불리언 API로 대체되었습니다.

오류 처리

제거 예정인 API	해당 버전에서 사용 중단 예정	대신 사용할 항목	해당 버전에서 제거됨	지원 중단 사유
`UnityAds.UnityAdsLoadError` 열거형 ( `NO_FILL` , `INTERNAL_ERROR` , `INVALID_ARGUMENT` , `TIMEOUT` , `INITIALIZE_FAILED` )	4.19.0	통합 `UnityAdsError` — `error.getCode()` (int) 및 `error.getMessage()` (String)을(를) 사용하세요. 코드 52100 = 채우기 없음; 52101 = 초기화되지 않음; 52102/52104 = 잘못된 구성; 2 = 시간 초과.	5.0.0	작업별 로드 오류 열거형이 표준화된 숫자 코드를 사용하는 통합 오류 유형으로 대체되었습니다.
`UnityAds.UnityAdsShowError` 열거형 ( `NOT_INITIALIZED` , `NOT_READY` , `VIDEO_PLAYER_ERROR` , `INVALID_ARGUMENT` , `NO_CONNECTION` , `ALREADY_SHOWING` , `INTERNAL_ERROR` )	4.19.0	통합 `UnityAdsError` ( `getCode()` 및 `getMessage()` 포함)	5.0.0	작업별 표시 오류 열거형이 표준화된 숫자 코드를 사용하는 통합 오류 유형으로 대체되었습니다.
`BannerErrorCode` 열거형 / `BannerErrorInfo` 클래스	4.19.0	통합 `UnityAdsError` 및 `getCode()` `getMessage()`	5.0.0	배너별 오류 유형이 모든 광고 형식에서 사용되는 동일한 통합 오류로 대체되었습니다.