# iOS 사용 중단 예정 API > 지원이 사용 중단 예정 iOS용 Unity Ads SDK 클래스와 대체 및 제거 버전을 식별. ## iOS 사용 중단 예정 클래스##ios-deprecated-classes 다음 API 클래스는 Unity Ads SDK 버전 4.19.0용 iOS SDK에서 지원이 사용 중단 예정 더 이상 사용되지 않습니다. ### 초기화##initialization | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **사용 중단 사유** | | ------------------------------------------------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------- | --------------------------------------------------------------------------------- | | `UADSMediationMetaData` | 4.19.0 | `UADSMediationInfo` — `initWithName:version:adapterVersion:`로 초기화 | 5.0.0 | 빌더 기반 초기화 API에서 사용되는 입력된 `UADSMediationInfo` 값 오브젝트로 대체됨. | | `[UnityAds setDebugMode:]` | 4.19.0 | `[UADSInitializationConfigurationBuilder withLogLevel:]`를 통해 `UADSLogLevel` 설정(예: `UADSLogLevelDebug`) | 5.0.0 | 부울 디버그 모드 토글은 초기화 설정 빌더에 설정된 4단계의 `UADSLogLevel`로 대체되므로 로그 작성을 더 세밀하게 제어할 수 있습니다. | | `[UnityAds initialize:]` 및 모든 과부하(`initializationDelegate:`, `testMode:`, `testMode:initializationDelegate:`) | 4.19.0 | `[UnityAds initialize:[builder build] completion:^(id error){…}]` 사용 `UADSInitializationConfigurationBuilder` | 5.0.0 | 델리게이트 대신 완료 차단으로 빌더 패턴 초기화 API로 교체되었습니다. | | `UnityAdsInitializationDelegate` 프로토콜 | 4.19.0 | 새로운 `[UnityAds initialize:completion:]` 방법에 완료 차단 `^(id error)` 전달 | 5.0.0 | 대리 기반 초기화 콜백을 완료 블록으로 대체하여 간편하고 인라인 오류 처리를 수행합니다. | ### 인터스티셜 광고##interstitial-ads | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **사용 중단 사유** | | ------------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------- | --------------- | --------------------------------------------------------------------- | | `[UnityAds load:options:loadDelegate:]`(인터스티셜 광고) | 4.19.0 | `[UADSInterstitialAd load:[빌더 빌드 완료:^(UADSInterstitialAd *ad, id error){...}]` | 5.0.0 | UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되며, 결과는 완료 차단을 통해 전달됩니다. | | `UnityAdsLoadDelegate` 프로토콜(인터스티셜 광고) | 4.19.0 | 전달 `[UADSInterstitialAd load:completion:]` | 5.0.0 | 인스턴스 기반 광고 로딩 API에서 콜백을 완료 블록으로 대체합니다. | | `UADSLoadOptions.adMarkup`(인터스티셜 광고) | 4.19.0 | `[UADSLoadConfigurationBuilder withAdMarkup:]` | 5.0.0 | 변경 가능 프로퍼티가 변경되지 않는 빌더 패턴 설정으로 대체되었습니다. | | `UADSLoadOptions.objectId`(인터스티셜 광고) | 4.19.0 | 교체 없음 — 이제 오브젝트 ID가 SDK에서 내부적으로 관리됩니다 | 5.0.0 | 매뉴얼 상관 관계 ID는 더 이상 필요하지 않습니다. SDK는 내부적으로 광고 인스턴스 트래킹을 처리합니다. | | `[UnityAds show:placementId:options:showDelegate:]`(인터스티셜 광고) | 4.19.0 | `UADSInterstitialAd` 인스턴스의 `[self.interstitialAd show:[builder build] delegate:delegate]` | 5.0.0 | UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되었습니다. | | `UnityAdsShowDelegate` 프로토콜(인터스티셜 광고) | 4.19.0 | `UADSInterstitialShowDelegate` 와 `showDidStart:``showDidClick:`, `showDidComplete:with:`, `showDidFail:error:` | 5.0.0 | 일반적인 show 델리게이트는 플레이스먼트 ID 문자열이 아닌 광고 인스턴스를 전달하는 광고 유형별 델리게이트로 대체됩니다. | | `UADSShowOptions.objectId`(인터스티셜 광고) | 4.19.0 | 교체 없음 — 이제 오브젝트 ID가 SDK에서 내부적으로 관리됩니다 | 5.0.0 | 매뉴얼 상관 관계 ID는 더 이상 필요하지 않습니다. SDK는 내부적으로 광고 인스턴스 트래킹을 처리합니다. | | `UADSShowOptions`(인터스티셜 광고) | 4.19.0 | `UADSShowConfigurationBuilder` — 사용 `withViewController:` | 5.0.0 | 변경할 수 있는 옵션 오브젝트가 변경할 수 없는 빌더 패턴 show 설정으로 대체되었습니다. | ### 보상형 광고##rewarded-ads | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **사용 중단 사유** | | ------------------------------------------------------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------- | ----------------------------------------------------------------------------------------- | | `[UnityAds load:options:loadDelegate:]` (보상형 광고) | 4.19.0 | `[UADSRewardedAd load:[빌더 빌드 완료:^(UADSRewardedAd *ad, id error){...}]` | 5.0.0 | UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되며, 결과는 완료 차단을 통해 전달됩니다. | | `UnityAdsLoadDelegate` 프로토콜(보상형 광고) | 4.19.0 | 전달 `[UADSRewardedAd load:completion:]` | 5.0.0 | 인스턴스 기반 광고 로딩 API에서 콜백을 완료 블록으로 대체합니다. | | `UADSLoadOptions.adMarkup` (보상형 광고) | 4.19.0 | `[UADSLoadConfigurationBuilder withAdMarkup:]` | 5.0.0 | 변경 가능 프로퍼티가 변경되지 않는 빌더 패턴 설정으로 대체되었습니다. | | `UADSLoadOptions.objectId` (보상형 광고) | 4.19.0 | 교체 없음 — 이제 오브젝트 ID가 SDK에서 내부적으로 관리됩니다 | 5.0.0 | 매뉴얼 상관 관계 ID는 더 이상 필요하지 않습니다. SDK는 내부적으로 광고 인스턴스 트래킹을 처리합니다. | | `[UnityAds show:placementId:options:showDelegate:]` (보상형 광고) | 4.19.0 | `UADSRewardedAd` 인스턴스의 `[self.rewardedAd show:[builder build] delegate:delegate]` | 5.0.0 | UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되었습니다. | | `UnityAdsShowDelegate` 프로토콜(보상형 광고) | 4.19.0 | 전용 `showDidReceiveReward:` 콜백이 있는 `UADSRewardedShowDelegate` | 5.0.0 | 보상형 광고별 콜백으로 전용 보상 콜백으로 대체된 일반 쇼 콜백. | | `UADSShowOptions.objectId` (보상형 광고) | 4.19.0 | 교체 없음 — 이제 오브젝트 ID가 SDK에서 내부적으로 관리됩니다 | 5.0.0 | 매뉴얼 상관 관계 ID는 더 이상 필요하지 않습니다. SDK는 내부적으로 광고 인스턴스 트래킹을 처리합니다. | | `UADSPlayerMetaData` (`-setServerId:`) | 4.19.0 | `[UADSShowConfigurationBuilder withCustomRewardString:]` 로 `-[UADSRewardedAd show:delegate:]``UADSShowConfiguration` 전달됨 | 5.0.0 | 메타데이터 기반 서버 측 보상 확인 ID는 빌더 기반 광고 오브젝트 API와 일치하는 show 설정의 입력된 `customRewardString`로 대체됩니다. | | `kUnityShowCompletionStateCompleted`, `kUnityShowCompletionStateSkipped` | 4.19.0 | `UADSShowFinishStateCompleted`, `UADSShowFinishStateSkipped` | 5.0.0 | 상수는 통합 `UADSShowFinishState` 유형의 일부로 이름이 변경되었습니다. | | `UnityAdsShowCompletionState` | 4.19.0 | `UADSShowFinishState` | 5.0.0 | 새 인스턴스 기반 광고 API와 일관성을 위해 열거형 타입 이름이 변경되었습니다. | ### 배너 광고##banner-ads | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **사용 중단 사유** | | ---------------------------------------------------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------- | | `UADSBannerView` | 4.19.0 | `UADSBannerAd` — `.view` 프로퍼티를 통해 보기 액세스, 접근하여 계층 구조에 추가합니다. | 5.0.0 | 직접 보기 클래스가 새 광고 오브젝트 모델과 일치하는 프로퍼티를 통해 액세스할 수 있는 광고 인스턴스 오브젝트로 대체됨. | | `UADSBannerViewDelegate` 프로토콜 | 4.19.0 | `UADSBannerAdDelegate` 와 `bannerImpression:``bannerDidClick:`, `bannerDidFailShow:error:` | 5.0.0 | 뷰 레벨 델리게이트가 광고 오브젝트 델리게이트로 대체되었습니다. 로드 결과가 `load(_:completion:)` 완료핸들러로 이동하며, `bannerViewDidLeaveApplication:`는 교체 없이 제거됩니다. | | `bannerViewDidLoad:` 켜짐 `UADSBannerViewDelegate` | 4.19.0 | 로드 결과는 이제 `UADSBannerAd.load(_:completion:)` 완료 차단을 통해 전달됩니다. 델리게이트 콜백 | 5.0.0 | 로드 알림이 델리게이트 밖으로 이동하여 새로운 인터스티셜 광고 및 보상형 광고 로딩 패턴과 일치하는 로드 완료 차단으로 이동했습니다. | | `bannerViewDidLeaveApplication:` 켜짐 `UADSBannerViewDelegate` | 4.19.0 | 대체 메서드/프로퍼티 | 5.0.0 | 콜백이 제거되었으며 새 에 상응하지 않습니다`UADSBannerAdDelegate`. | | `[[UADSBannerView alloc] initWithPlacementId:size:]` + `[banner loadWithOptions:]` | 4.19.0 | `[UADSBannerAd load:[builder build] completion:^(UADSBannerAd *ad, id error){…}]` via `UADSBannerLoadConfigurationBuilder` | 5.0.0 | 생성자 + 별도의 부하 방법은 빌더 설정과 완성 차단이 있는 통합 정적 부하로 대체되어 새로운 인터스티셜 광고 및 보상형 광고 부하 패턴과 일치합니다. | | `UADSBannerLoadOptions` | 4.19.0 | `UADSBannerLoadConfigurationBuilder`를 통해 제작된 `UADSBannerLoadConfiguration` | 5.0.0 | 배너별 변경 가능한 로드 옵션 오브젝트가 변경되지 않는 빌더 패턴 설정으로 대체되었습니다. | | `UADSLoadOptions.adMarkup`(배너) | 4.19.0 | `[UADSBannerLoadConfigurationBuilder withAdMarkup:]` | 5.0.0 | 변경 가능 프로퍼티가 변경되지 않는 빌더 패턴 설정으로 대체되었습니다. | | `UADSLoadOptions.objectId`(배너) | 4.19.0 | 대체 사항 없음 — 이제 오브젝트 ID가 SDK에서 내부적으로 관리됩니다 | 5.0.0 | 매뉴얼 상관 관계 ID는 더 이상 필요하지 않습니다. SDK는 내부적으로 광고 인스턴스 트래킹을 처리합니다. | ### 토큰 컬렉션(입찰)##token-collection-(bidding) | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **사용 중단 사유** | | --------------------------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `+[UnityAds getToken]`, `+[UnityAds getToken:]`, `+[UnityAds getTokenWith:completion:]` | 4.19.0 | `+[UnityAds getToken:completion:]` | 5.0.0 | 무축 게터, 완료 전용 게터, 레거시 `UnityAdsTokenConfiguration` 과부하가 모두 `UADSTokenConfigurationBuilder`를 통해 빌드된 타입이 지정된 `UADSTokenConfiguration`를 사용하는 단일 엔트리 포인트로 대체됩니다. | | `UnityAdsTokenConfiguration` + `[UnityAdsTokenConfiguration newWithAdFormat:]` | 4.19.0 | `UADSTokenConfigurationBuilder` — `initWithAdFormat:`, `withMediationInfo:`, 선택적으로 `withBannerSize:` | 5.0.0 | 설정 오브젝트를 빌더로 대체하여 Mediation 정보와 배너 크기를 일관된 패턴에 포함시킬 수 있습니다. | | `UnityAdsAdFormat` 열거형 | 4.19.0 | `UADSAdFormatBanner`, `UADSAdFormatInterstitial`, `UADSAdFormatRewarded` 값이 있는 `UADSAdFormat` 열거형 | 5.0.0 | 네임스페이스가 새로운 `UADS` 프리픽스 API 표면과 일치하도록 열거형 이름이 변경되었습니다. | ### 개인정보##privacy | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **사용 중단 사유** | | ------------------------------ | -------------------- | -------------------------------------------------------- | --------------- | ------------------------------------------------------ | | `UADSMetaData` | 4.19.0 | `[UnityAds setUserConsent:]` | 5.0.0 | 문자열 키-값 개인정보 보호 메타데이터가 정적 메서드로 대체됨. | | `UADSMetaData`(CCPA) | 4.19.0 | `[UnityAds setUserOptOut:]` — 사용자가 거부한 경우 전달 `YES`(비 판매) | 5.0.0 | 문자열 키-값 개인정보 보호 메타데이터가 명시적 거부 시맨틱이 있는 정적 메서드로 대체되었습니다. | | `UADSMetaData` (COPPA, 자식 지향법) | 4.19.0 | `[UnityAds setNonBehavioral:]` | 5.0.0 | 비동작/컨텍스트 광고 제어를 위한 명시적 부울 API로 대체된 개인정보 보호 모드 문자열입니다. | ### 오류 처리##error-handling | **제거 예정인 API** | **해당 버전에서 사용 중단 예정** | **대신 사용할 항목** | **해당 버전에서 제거됨** | **사용 중단 사유** | | ----------------------------- | -------------------- | ---------------------------------------------------------------------------------- | --------------- | ---------------------------------------------------- | | `UnityAdsInitializationError` | 4.19.0 | 통합된 `id` protocol with `.code` (NSInteger) and `.message`(NSString) | 5.0.0 | 일반적인 작업별 오류 열거형이 표준화된 숫자 코드로 통합된 오류 프로토콜로 대체됨. | | 열거형 `UnityAdsLoadError` | 4.19.0 | 통합 `id` 프로토콜 | 5.0.0 | 수작당 개별 오류 열거형을 표준화된 숫자 코드가 있는 통합 오류 프로토콜로 대체한다. | | `UnityAdsShowError` 열거형 | 4.19.0 | 통합 `id` 프로토콜 | 5.0.0 | 수작당 개별 오류 열거형이 표준화된 숫자 코드가 있는 통합 오류 프로토콜로 대체되었습니다. | | `UADSBannerErrorCode` 열거형 | 4.19.0 | 통합 `id` 프로토콜 | 5.0.0 | 배너별 오류 열거형은 모든 광고 유형에서 사용되는 동일한 통합 오류 프로토콜로 대체되었습니다. |