기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Unity Ads Monetization

SDK 4.19.0

지원 가능
​

iOS API 레퍼런스 - Swift

iOS API 레퍼런스 - Objective-C

Unity Ads Monetization

SDK 4.19.0

지원 가능
​
iOS developer guides
​
​
iOS 개발자 가이드
  • iOS SDK 연동 가이드
  • Unity Ads 개인정보 보호 가이드
  • Unity Ads SDK 문제 해결 가이드
  • iOS 개발자 API 참조 - Swift
  • iOS 개발자 API 레퍼런스 - Objective-C
  • iOS 사용 중단 예정 API
  1. Unity Ads SDK iOS 개발자 수익화
  3. iOS 개발자용 Unity Ads SDK 연동 가이드
  5. iOS 개발자 API 참조

iOS 사용 중단 예정 API

지원이 사용 중단 예정 iOS용 Unity Ads SDK 클래스와 대체 및 제거 버전을 식별.
읽는 시간 13분
최근 업데이트: 5시간 전

iOS 사용 중단 예정 클래스

다음 API 클래스는 Unity Ads SDK 버전 4.19.0용 iOS SDK에서 지원이 사용 중단 예정 더 이상 사용되지 않습니다.

초기화

제거 예정인 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<UnityAdsError> error){…}]
사용 
UADSInitializationConfigurationBuilder
5.0.0델리게이트 대신 완료 차단으로 빌더 패턴 초기화 API로 교체되었습니다.
UnityAdsInitializationDelegate
프로토콜		4.19.0새로운 
[UnityAds initialize:completion:]
방법에 완료 차단 
^(id<UnityAdsError> error)
전달		5.0.0대리 기반 초기화 콜백을 완료 블록으로 대체하여 간편하고 인라인 오류 처리를 수행합니다.

인터스티셜 광고

완료 차단

제거 예정인 API

해당 버전에서 사용 중단 예정

대신 사용할 항목

해당 버전에서 제거됨

사용 중단 사유

[UnityAds load:options:loadDelegate:]
(인터스티셜 광고)		4.19.0
[UADSInterstitialAd load:[빌더 빌드 완료:^(UADSInterstitialAd *ad, id<UnityAdsError> error){...}]
5.0.0UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되며, 결과는 완료 차단을 통해 전달됩니다.
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.0UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되었습니다.
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 설정으로 대체되었습니다.

보상형 광고

완료 차단

제거 예정인 API

해당 버전에서 사용 중단 예정

대신 사용할 항목

해당 버전에서 제거됨

사용 중단 사유

[UnityAds load:options:loadDelegate:]
(보상형 광고)		4.19.0
[UADSRewardedAd load:[빌더 빌드 완료:^(UADSRewardedAd *ad, id<UnityAdsError> error){...}]
5.0.0UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되며, 결과는 완료 차단을 통해 전달됩니다.
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.0UnityAds의 클래스 메서드가 로드된 광고 오브젝트의 인스턴스 메서드로 대체되었습니다.
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와 일관성을 위해 열거형 타입 이름이 변경되었습니다.

배너 광고

없음

제거 예정인 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<UnityAdsError> 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는 내부적으로 광고 인스턴스 트래킹을 처리합니다.

토큰 컬렉션(입찰)

UADSTokenConfigurationBuilder
구성의
사용

제거 예정인 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 표면과 일치하도록 열거형 이름이 변경되었습니다.

개인정보

키 
gdpr.consent
가 있는
키 
privacy.consent
가 있는
주요 
user.nonBehavioral
가 있는

제거 예정인 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로 대체된 개인정보 보호 모드 문자열입니다.

오류 처리

열거형

제거 예정인 API

해당 버전에서 사용 중단 예정

대신 사용할 항목

해당 버전에서 제거됨

사용 중단 사유

UnityAdsInitializationError
 4.19.0 통합된 
id<UnityAdsError>
protocol with 
.code
(NSInteger) and 
.message
(NSString)		 5.0.0 일반적인 작업별 오류 열거형이 표준화된 숫자 코드로 통합된 오류 프로토콜로 대체됨.
열거형 
UnityAdsLoadError
4.19.0통합 
id<UnityAdsError>
프로토콜		5.0.0수작당 개별 오류 열거형을 표준화된 숫자 코드가 있는 통합 오류 프로토콜로 대체한다.
UnityAdsShowError
열거형		4.19.0통합 
id<UnityAdsError>
프로토콜		5.0.0수작당 개별 오류 열거형이 표준화된 숫자 코드가 있는 통합 오류 프로토콜로 대체되었습니다.
UADSBannerErrorCode
열거형		4.19.0통합 
id<UnityAdsError>
프로토콜		5.0.0배너별 오류 열거형은 모든 광고 유형에서 사용되는 동일한 통합 오류 프로토콜로 대체되었습니다.
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

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

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

  • 보고 있는 페이지

    • iOS 사용 중단 예정 클래스

      • 초기화

      • 인터스티셜 광고

      • 보상형 광고

      • 배너 광고

      • 토큰 컬렉션(입찰)

      • 개인정보

      • 오류 처리

이 페이지의 문제 보고