# Android 지원 중단 API들 > Android용 Unity Ads SDK의 지원 중단된 클래스와 대체 및 제거 버전을 식별합니다. ## Android 지원 중단 클래스들##android-deprecated-classes 다음 API 클래스들은 Unity Ads SDK 버전 4.19.0의 Android SDK에서 지원 중단 예정이거나 더 이상 사용되지 않습니다. ### 초기화##initialization | **제거 예정인 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 | 작업별 오류 열거형이 모든 작업에서 표준화된 숫자 코드를 사용하는 통합 오류 유형으로 대체되었습니다. | ### 인터스티셜 광고##interstitial-ads | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **지원 중단 사유** | | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------------------------------------------------------------- | | `UnityAds.load(placementId, UnityAdsLoadOptions, IUnityAdsLoadListener)` | 4.19.0 | `InterstitialAd.load(LoadConfiguration, LoadListener)` built via `LoadConfiguration.Builder(placementId)` | 5.0.0 | 정적 일반 로드가 유형별 인스턴스 기반 로드 API로 대체되었습니다. | | `IUnityAdsLoadListener` 인터페이스 (`onUnityAdsAdLoaded` / `onUnityAdsFailedToLoad`) | 4.19.0 | `LoadListener` 단일 `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 | 작업별 오류 열거형이 통합 오류 유형으로 대체되었습니다. | ### 보상형 광고##rewarded-ads | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **지원 중단 사유** | | ------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------- | | `UnityAds.load(placementId, UnityAdsLoadOptions, IUnityAdsLoadListener)` | 4.19.0 | `RewardedAd.load(LoadConfiguration, LoadListener)` built via `LoadConfiguration.Builder(placementId)` | 5.0.0 | 정적 일반 로드가 유형별 인스턴스 기반 로드 API로 대체되었습니다. | | `IUnityAdsLoadListener` 인터페이스 | 4.19.0 | `LoadListener` 단일 `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` 콜백을 사용해야 합니다. | ### 배너 광고##banner-ads | **제거 예정인 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`; 노출(`onImpression`), 클릭 수(`onClicked`) 및 표시 실패(`onFailedToShow`)를 위한 `BannerShowListener` | 5.0.0 | 단일 결합 리스너가 별도의 로드 및 표시 리스너로 분할되었습니다. `onBannerLeftApplication`은(는) 대체 없이 제거되었습니다. | | `BannerView.load(UnityAdsLoadOptions)` | 4.19.0 | `BannerAd.load(BannerConfiguration, LoadListener)`을(를) 통해 빌드되었습니다`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`에 대응하는 기능이 없습니다. | ### 개인정보##privacy | **제거 예정인 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로 대체되었습니다. | ### 오류 처리##error-handling | **제거 예정인 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 | 배너별 오류 유형이 모든 광고 형식에서 사용되는 동일한 통합 오류로 대체되었습니다. |