기술 자료

Unity Ads Monetization


iOS API 레퍼런스 - Swift

iOS API 레퍼런스 - Objective-C

Unity Ads Monetization


Unity Ads iOS SDK API 레퍼런스 - Objective-C

Unity Ads SDK 공용 API 레퍼런스에 액세스하여 Objective-C에서 iOS 앱의 광고 동작을 연동하고 제어하는 데 사용할 수 있는 클래스, 메서드 및 프로퍼티를 확인합니다.
읽는 시간 21분최근 업데이트: 22일 전

Unity Unity AdsUnity Ads ObjectiveObjective-CPI 이 레퍼런스 사용합니다.
이 API를 사용하기 전에 앱에서 수익화를 활성화할 수 있도록
UnityAds
라이브러리를 임포트했는지 확인합니다. 자세한 내용은 UnityAds 라이브러리 임포트를 참조하십시오.

클래스

UADSBannerAd

UADSBannerAd
클래스는 배너 광고의 로드 및 표시를 관리합니다.

load:completion:_

@interface UADSBannerAd : NSObject+ (void)load:(UADSBannerLoadConfiguration * _Nonnull)config 완료(void (^ _Nonnull)(UADSBannerAd * _Nullable, id<UnityAdsError> _Nullable)) 완료;@end
지정된 설정 배너 광고를 로드합니다.
배너가 로드될 때 호출되는

파라미터

설명

설정배너 광고 로드 옵션.
완료콜백. 로드되면 로드된 BannerAd 인스턴스 또는 로드에 실패하면 UnityAdsError를 반환합니다.

뷰

@interface UADSBannerAd : NSObject@property (비핵화, 읽기 전용, 강력함) UIView * _Nonnull 뷰;@end
배너 광고 인스턴스 대한 액세스, 접근 제공하는 view 프로퍼티. 이 프로퍼티 사용하여 앱의 기존 뷰 계층 구조 구조 내에서 원하는 위치에 배너 광고를 삽입합니다.

UADSBannerView

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
UADSBannerAd
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSBannerView
는 배너 광고를 로드하고 표시하기 위한 이전 클래스입니다.

UADSBannerViewDelegate

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
UADSBannerAdDelegate
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSBannerViewDelegate
는 배너 광고 이벤트를 처리하기 위한 이전의 위임자 프로토콜입니다.

UADSBannerLoadConfiguration

UADSBannerLoadConfiguration
클래스는 배너 광고를 로드하는 데 필요한 옵션을 캡슐화합니다. 여기에는 플레이스먼트 ID, 배너 크기, 선택적 광고 마크업, 선택적 위임자 및 추가 파라미터 지정이 포함됩니다.
@interface BannerLoadConfiguration : NSObject@properties (nonatomic, strong) NSString *placementId;@property (비핵화, 강력, nullable) NSString *adMarkup;@property (비자동, 할당) CGSize bannerSize;@properti (nonatomic, weak, nullable) id<UADSBannerAdDelegate> 델리게이트; @properti (nonatomic, strong, nullable) NSString *mediationAdUnitId; @properti (nonatomic, strong, nullable) MediationInfo *mediationInfo; @properti (nonatomic, strong) NSDictionary<nsstring *, nsstring *>*extras; @end ```</Tab></Tabs><Table><TableHeader><TableRow> <TableHeaderCell>**프로퍼티**</TableHeaderCell> <TableHeaderCell>**설명**</TableHeaderCell> <TableHeaderCell>**필수**</TableHeaderCell></TableRow></TableHeader><TableBody><TableRow> <TableCell>`placementId`</TableCell> <TableCell>Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.</TableCell> <TableCell>예</TableCell></TableRow><TableRow> <TableCell>`adMarkup`</TableCell> <TableCell>입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다.</TableCell> <TableCell>아니요</TableCell></TableRow><TableRow> <TableCell>`bannerSize`</TableCell> 배너 광고의 <TableCell>크기입니다.</TableCell> <TableCell>예</TableCell></TableRow><TableRow> <TableCell>`delegate`</TableCell> <TableCell>배너 광고 이벤트를 처리합니다.</TableCell> <TableCell>예</TableCell></TableRow><TableRow> <TableCell>`mediationAdUnitId`</TableCell> <TableCell>Mediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다.</TableCell> <TableCell>아니요</TableCell></TableRow><TableRow> <TableCell>`mediationInfo`</TableCell> <TableCell>Mediation 통합에 대한 세부 정보를 지정합니다.</TableCell> <TableCell>아니요</TableCell></TableRow><TableRow> <TableCell>`extras`</TableCell> <TableCell>추가 커스텀 키-값 페어.</TableCell> <TableCell>아니요</TableCell></TableRow></TableBody></Table>## UADSBannerLoadConfigurationBuilder##uadsbannerloadconfigurationbuilder`UADSBannerLoadConfigurationBuilder`를 사용하여 `UADSBannerLoadConfiguration` 클래스의 인스턴스를 생성하고 반환합니다.### initWithPlacementId:adMarkup:bannerSize:delegate##initwithplacementid:admarkup:bannersize:delegate<Tabs><Tab title="Objective-C">```objective-c- (nonnull 인스턴스 타입)initWithPlacementId:(NSString * _Nonnull)placementId bannerSize:(CGSize)bannerSize 델리게이트(id <UADSBannerAdDelegate> _Nonnull) 델리게이트;
새
BannerLoadConfigurationBuilder
인스턴스를 만듭니다.
배너 광고의

프로퍼티

설명

필수

placementId
Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.예
bannerSize
크기입니다. 예
delegate
배너 광고 이벤트를 처리합니다.예
다음 반환:
UADSBannerLoadConfigurationBuilder
의 인스턴스.

withAdMarkup:_

- AdMarkup(NSString * _Nonnull)과 함께 (nonnull 인스턴스 타입)adMarkup
UADSBannerLoadConfigurationBuilder
에 adMarkup을 추가합니다.

파라미터

설명

adMarkup입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다.

withMediationAdUnitId:_

- (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
Mediation 광고 유닛 ID를
UADSBannerLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

mediationAdUnitIdMediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다.
다음 반환: 업데이트된
UADSBannerLoadConfigurationBuilder
인스턴스.

withMediationInfo:_

- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
Mediation 정보를
UADSBannerLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

mediationInfoMediation 통합에 대한 세부 정보(이름, 버전, 어댑터 버전)
다음 반환: 업데이트된 UADSBannerLoadConfigurationBuilder 인스턴스.

withExtras:_

- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
추가 키-값 파라미터를
UADSBannerLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

extras배너 로딩을 위한 커스텀 파라미터.
다음 반환: 업데이트된
UADSBannerLoadConfigurationBuilder
인스턴스.

빌드

- (UADSBannerLoadConfiguration * _Nonnull)빌드
빌드하고
UADSBannerLoadConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSBannerLoadConfiguration
의 인스턴스.

UADSBannerLoadOptions

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신에
UADSBannerLoadConfiguration
및
UADSBannerLoadConfigurationBuilder
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSBannerLoadOptions
는 배너 로드 옵션을 지정하기 위한 이전 클래스입니다.

UADSInitializationConfiguration

@interface UADSInitializationConfiguration: NSObject@property (nonatomic, strong) NSString *gameId;@property (nonatomic, assign) BOOL isTestModeEnabled;@property (nonatomic, assign) UADSLogLevel logLevel;@property (nonatomic, strong, nullable) UADSMediationInfo *mediationInfo;@property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;@end
UADSInitializationConfiguration
클래스는 Unity Ads SDK를 초기화하는 데 필요한 앱에 대한 필수 정보로 구성된 오브젝트를 생성합니다.

프로퍼티

유형

설명

필수

gameId
NSString *
Unity 프로젝트의 고유 식별자입니다.예
isTestModeEnabled
BOOL
테스트 모드를 활성화하거나 비활성화합니다.아니요
logLevel
UADSLogLevel
로그 출력의 디테일 수준을 지정합니다.아니요
mediationInfo
UADSMediationInfo * _Nullable
Mediation 통합에 대한 세부 정보를 지정합니다.아니요
extras
NSDictionary&lt;NSString *, NSString *&gt; *
커스텀 설정을 위한 추가 키-값 쌍.아니요

UADSInitializationConfigurationBuilder

UADSInitConfigurationBuilder
를 사용하여
UADSInitializationConfiguration
클래스의 인스턴스를 생성하고 반환합니다.

initWithgameID:_

- (nonnull 인스턴스 타입)initWithGameId:(NSString * _Nonnull)gameId
새
UADSInitConfigurationBuilder
인스턴스를 만듭니다.

파라미터

설명

gameIdUnity Ads 관리 툴 또는 Unity 에디터에서 제공하는 게임의 고유 식별자입니다.
다음 반환:
UADSInitConfigurationBuilder
의 인스턴스.

withTestMode:_

- (nonnull 인스턴스 타입) withTestMode:(BOOL)testMode
테스트 모드를 설정합니다.

파라미터

설명

testMode테스트 모드를 표시하고 테스트 광고만 표시하려면 이 플래그를
true
로 설정합니다.
다음 반환: 업데이트된
UADSInitConfigurationBuilder
인스턴스.

withLogLevel:_

- (nonnull 인스턴스 타입)LogLevel(열거형 UADSLogLevel)logLevel
로그에 포함된 세부 정보의 양을 None부터 Full 디버그 정보까지 정의하는 로그 레벨을 설정합니다.

파라미터

설명

레벨로그 출력의 디테일 수준을 지정합니다.
다음 반환: 업데이트된
UADSInitConfigurationBuilder
인스턴스.

withMediationInfo:_

- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
Mediation 정보를 설정합니다. 여기에는 Mediation 이름, 버전, 어댑터 버전 등 앱의 Mediation 통합에 대한 세부 정보가 포함됩니다.

파라미터

설명

infoMediation 통합에 대한 세부 정보를 지정합니다.
다음 반환: 업데이트된
UADSInitConfigurationBuilder
인스턴스.

withExtras:_

- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
추가 파라미터를 설정합니다.

파라미터

설명

extras커스텀 설정을 위한 추가 키-값 페어입니다.
다음 반환: 업데이트된
UADSInitConfigurationBuilder
인스턴스.

빌드

- (UADSInitializationConfiguration * _Nonnull)빌드
UADSInitializationConfiguration 인스턴스 빌드하고 반환합니다.
다음 반환:
UADSInitializationConfiguration
의 인스턴스.

UADSInterstitialAd

UADSInterstitialAd
클래스는 인터스티셜 광고의 로드 및 표시를 관리합니다.

load:completion:_

@interface UADSInterstitialAd : NSObject+ (void)load:(UADSLoadConfiguration * _Nonnull)설정 완료(void (^ _Nonnull)(UADSInterstitialAd * _Nullable, id<UnityAdsError> _Nullable)) 완료;@end
지정된 설정 인터스티셜 광고 광고를 로드합니다.
로드 프로세스가 완료되면 호출되는

파라미터

설명

설정광고 로딩 옵션이 포함된 UADSLoadConfiguration 인스턴스입니다.
완료콜백입니다. UADSInterstitialAd 인스턴스 또는 오류를 반환합니다.

show:delegate:_

@interface UADSInterstitialAd : NSObject- (void)show:(UADSShowConfiguration * _Nullable)설정 델리게이트(id <UADSInterstitialShowDelegate> _Nonnull) 델리게이트;@end
로드된 인터스티셜 광고 광고를 표시합니다.

파라미터

설명

설정광고 표시를 위한 선택적 설정입니다.
delegate광고 이벤트를 처리하기 위한
UADSInterstitialShowDelegate
준수 대리인.

onAdExpired

광고 만료 시 트리거되는 콜백 등록합니다.
@interface UnityAd : NSObject@property (nonatomic, copy) void (^ _Nullable onAdExpired)(UnityAd * _Nonnull);@end

UADSLoadConfiguration

UADSLoadConfiguration
클래스는 Unity Ads 로드에 필요한 옵션을 캡슐화합니다. 여기에는 플레이스먼트 ID, 선택적 광고 마크업, 추가 파라미터 지정이 포함됩니다.
@interface UADSLoadConfiguration: NSObject@property (nonatomic, strong) NSString *placementId;@property (nonatomic, strong, nullable) NSString *adMarkup;@property (nonatomic, strong, nullable) NSString *mediationAdUnitId;@property (nonatomic, strong, nullable) UADSMediationInfo *mediationInfo;@property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;@end
새
UADSLoadConfiguration
인스턴스를 만듭니다.

프로퍼티

설명

필수

placementId
Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.예
adMarkup
입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다.아니요
mediationAdUnitId
Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다.아니요
mediationInfo
Mediation 통합에 대한 세부 정보를 지정합니다.아니요
extras
설정용 커스텀 키-값 쌍 추가.아니요
참고 adMarkup 프로퍼티 모든 입찰 구현에 필요합니다. 워터폴 구현의 경우 adMarkup을 null으로 설정할 수 있습니다.

UADSLoadConfigurationBuilder

UADSLoadConfigurationBuilder
를 사용하여
UADSLoadConfiguration
클래스의 인스턴스를 생성하고 반환합니다.

initWithPlacementId:_

- - (nonnull instancetype)initWithPlacementId:(NSString * _Nonnull)placementId;
새
UADSLoadConfigurationBuilder
인스턴스를 만듭니다.

파라미터

설명

placementId
Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.
다음 반환:
UADSLoadConfigurationBuilder
의 인스턴스.

withAdMarkup:_

- AdMarkup(NSString * _Nonnull)과 함께 (nonnull 인스턴스 타입)adMarkup
UADSLoadConfigurationBuilder
에 adMarkup을 추가합니다.

프로퍼티

설명

adMarkup
입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다.
다음 반환: 업데이트된
UADSLoadConfigurationBuilder
인스턴스.

withMediationAdUnitId:_

- (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
Mediation 광고 유닛 ID를
UADSLoadConfigurationBuilder
에 추가합니다.

프로퍼티

설명

mediationAdUnitId
Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다.
다음 반환: 업데이트된
UADSLoadConfigurationBuilder
인스턴스.

withMediationInfo:_

- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
Mediation 정보를
UADSLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

mediationInfoMediation 통합에 대한 세부 정보를 지정합니다(이름, 버전, 어댑터 버전).
다음 반환: 업데이트된
UADSLoadConfigurationBuilder
인스턴스.

withExtras:_

- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
추가 설정 키-값 쌍을
UADSLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

extras광고 로딩을 위한 커스텀 파라미터의 사전.
다음 반환: 업데이트된
UADSLoadConfigurationBuilder
인스턴스.

빌드

- (UADSLoadConfiguration * _Nonnull)빌드
빌드하고
UADSLoadConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSLoadConfiguration
의 인스턴스.

UADSLoadOptions

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
UADSLoadConfigurationBuilder
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSLoadOptions
는 광고 로드 옵션을 지정하기 위한 이전 클래스입니다.

UADSMediationInfo

Mediation 통합에 대한 세부 정보를 지정합니다.
@interface UADSMediationInfo : NSObject- (nonnull 인스턴스 타입)initWithName:(NSString * _Nonnull)name 버전:(NSString * _Nonnull) 버전 adapterVersion:(NSString * _Nonnull)adapterVersion@end

파라미터

설명

name앱에 통합된 Mediation 플랫폼의 이름입니다.
버전앱에 통합된 Mediation SDK 버전입니다.
adapterVersionMediation 파트너를 위한 Unity Ads 어댑터 버전입니다.
다음 반환:
UADSMediationInfo
의 인스턴스.

UADSMediationMetaData

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
UADSMediationInfo
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSMediationMetaData
는 Mediation 파트너 정보를 전달하기 위한 이전 클래스입니다.

UADSRewardedAd

UADSRewardedAd 클래스 보상형 광고 광고의 로드와 표시를 관리합니다.

load:completion:_

+ (void)load:(UADSLoadConfiguration * _Nonnull)설정 완료(void (^ _Nonnull)(UADSRewardedAd * _Nullable, id<UnityAdsError> _Nullable)) 완료;
지정된 옵션으로 보상형 광고 광고를 로드합니다.
광고 로딩이 끝나면 호출되는

파라미터

설명

설정광고 로딩 옵션이 포함된 UADSLoadConfiguration 인스턴스입니다.
완료콜백입니다. 성공하면 UADSRewardedAd 인스턴스, 로드에 실패하면 UnityAdsError를 반환합니다.

show:delegate:_

- (void)show:(UADSShowConfiguration * _Nullable)설정 델리게이트(id <UADSRewardedShowDelegate> _Nonnull) 델리게이트;
로드된 보상형 광고 광고를 표시합니다.

파라미터

설명

설정광고 표시를 위한 선택적 설정입니다.
delegate보상형 광고 이벤트를 처리하는 대리인.

onAdExpired

광고 만료 시 트리거되는 콜백 등록합니다.
@interface UnityAd : NSObject@property (nonatomic, copy) void (^ _Nullable onAdExpired)(UnityAd * _Nonnull);@end

UADSShowConfiguration

UADSShowConfiguration
클래스는 Unity Ads를 표시할 때 키-값 페어 형태로 전달할 추가 파라미터를 지정합니다.
@interface UADSShowConfigurationBuilder : NSObject@property (nonatomic, weak, nullable) UIViewController *viewController;@property (nonatomic, strong, nullable) NSString *customRewardString;@property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;@end
선택적 추가 파라미터가 있는 새
UADSShowConfiguration
인스턴스를 생성합니다.
광고를 표시할 때 포함할

프로퍼티

설명

필수

viewController
광고를 표시하는 데 사용된 보기 컨트롤러입니다.지원 안 함
customRewardString
광고 노출에 대한 커스텀 보상 식별자입니다.아니요
extras
추가 키-값 파라미터입니다. 기본값은 빈 사전입니다. 아니요

UADSShowConfigurationBuilder

UADSShowConfigurationBuilder
를 사용하여
UADSShowConfiguration
클래스의 인스턴스를 생성하고 반환합니다.

init

- (nonnull 인스턴스 타입)init;
새
UADSShowConfigurationBuilder
인스턴스를 만듭니다.

withViewController:_

- (nonnull 인스턴스 타입)와ViewController:(UIViewController * _Nonnull)viewController
광고를 표시할 뷰 컨트롤러 설정합니다.

파라미터

설명

viewController
광고를 표시하는 뷰 컨트롤러입니다.
다음 반환: 업데이트된
UADSShowConfigurationBuilder
인스턴스.

withCustomRewardString:_

- (nonnull 인스턴스 타입)CustomRewardString(NSString * _Nonnull)과 함께 사용
광고 노출에 대한 커스텀 보상 식별자 설정합니다.

파라미터

설명

customRewardString
광고 노출에 대한 고유 보상 ID입니다.
다음 반환: 업데이트된
ShowConfigurationBuilder
인스턴스.

withExtras:_

- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
광고를 표시할 때 추가 키-값 파라미터를 추가합니다.

파라미터

설명

extras
광고 표시를 위한 커스텀 파라미터입니다.
다음 반환: 업데이트된
UADSShowConfigurationBuilder
인스턴스.

빌드

- (UADSShowConfiguration * _Nonnull)빌드
빌드하고
UADSShowConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSShowConfiguration
의 인스턴스.

UADSShowOptions

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
UADSShowConfigurationBuilder
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSShowOptions
는 광고 표시 옵션을 지정하기 위한 이전 클래스입니다.

UADSTokenConfiguration

@interface UADSTokenConfiguration : NSObject@property (nonatomic, assign) AdFormat UADSAdFormat;@property (nonatomic, strong, nullable) UADSMediationInfo *mediationInfo;@property (nonatomic, strong, nullable) NSString *mediationAdUnitId;@property (nonatomic, strong, nullable) NSString *placementId;@property (nonatomic, assign) CGSize bannerSize;@property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;@end
UADSTokenConfiguration
인터페이스는 입찰 토큰을 얻기 위해 필요한 필수 정보로 구성된 오브젝트를 생성합니다.

프로퍼티

설명

필수

adFormat
광고 형식의 유형을 지정합니다(인터스티셜 광고, 보상형 광고, 배너).예
mediationInfo
Mediation 통합에 대한 세부 정보를 지정합니다.아니요
mediationAdUnitId
Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다.아니요
placementId
Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.아니요
bannerSize
토큰이 배너 광고를 요청한 경우 배너 광고의 크기입니다.아니요
extras
커스텀 설정을 위한 추가 키-값 쌍.아니요

UADSTokenConfigurationBuilder

UADSTokenConfigurationBuilder
를 사용하여
UADSTokenConfiguration
클래스의 인스턴스를 생성하고 반환합니다.

initWithAdFormat:_

- (nonnull 인스턴스 타입)initWithAdFormat:( 열거형 UADSAdFormat)adFormat
새
UADSTokenConfigurationBuilder
인스턴스를 만듭니다.

파라미터

설명

adFormat광고 유형(인터스티셜 광고, 보상형 광고, 배너)을 지정하는 AdFormat 인스턴스입니다.
다음 반환:
UADSTokenConfigurationBuilder
의 인스턴스.

withMediationInfo:_

- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)mediationInfo
Mediation 통합에 대한 세부 정보를 지정합니다.

파라미터

설명

mediationInfoMediation 통합에 대한 세부 정보를 지정합니다.
다음 반환: 업데이트된
TokenConfigurationBuilder
인스턴스.

withMediationAdUnitId:_

- (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
Mediation 광고 유닛 ID를
TokenConfiguration
에 추가합니다.

프로퍼티

설명

mediationAdUnitId
Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다.
다음 반환: 업데이트된
UADSTokenConfigurationBuilder
인스턴스.

withPlacementId:_

- (nonnull 인스턴스 타입) withPlacementId:(NSString * _Nonnull)placementId
Unity 수익화 대시보드에 정의된 플레이스먼트 ID를 지정합니다.

파라미터

설명

placementIdUnity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.
다음 반환: 업데이트된
UADSTokenConfigurationBuilder
인스턴스.

withBannerSize:_

- (nonnull 인스턴스 타입)와BannerSize:(CGSize)bannerSize
토큰이 배너 광고를 요청한 경우 배너 광고의 크기를 지정합니다.

파라미터

설명

bannerSize토큰이 배너 광고를 요청한 경우 배너 광고의 크기입니다.
다음 반환: 업데이트된
UADSTokenConfigurationBuilder
인스턴스.

withExtras:_

- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
커스텀 설정 대한 추가 키-값 쌍을 지정합니다.

파라미터

설명

extras커스텀 설정을 위한 추가 키-값 페어입니다.
다음 반환: 업데이트된
UADSTokenConfigurationBuilder
인스턴스.

빌드

- (UADSTokenConfiguration * _Nonnull)빌드
빌드하고
UADSTokenConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSTokenConfiguration
의 인스턴스.

UnityAds

UnityAds
클래스는 SDK의 기본 엔트리 포인트로 사용되는 정적 클래스입니다. 초기화, 토큰 검색, 개인정보 보호 동의 등을 처리하고 전역 SDK 프로퍼티에 대한 액세스, 접근 제공합니다.

초기화

initialize(_, completion:)

지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 차단 호출됩니다.
+ (void) initialize:(UADSInitializationConfiguration *) 설정 완료(void (^)(id<UnityAdsError>)) 완료;
SDK 초기화가 완료되면 호출되는

파라미터

설명

설정SDK를 초기화하는 데 필요한 설정이 포함된 UADSInitializationConfiguration 오브젝트입니다.
완료콜백입니다. 초기화에 실패하면 UnityAdsError를 반환합니다.

GetToken

getToken(_, completion:)

제공된
UADSTokenConfiguration
에 따라 입찰 토큰을 가져와 완료 차단으로 전달합니다.
+ (void) getToken(UADSTokenConfiguration *) 설정 완료(void (^)(NSString *)) 완료;

파라미터

설명

설정광고 형식, Mediation 정보 및 기타 파라미터를 지정하는
UADSTokenConfiguration
오브젝트입니다.
완료토큰이 성공적으로 페치되면 완료 차단을 호출하고 오류가 발생하면 null을 호출합니다.

정적 변수

IsInitialized

Unity Ads SDK가 성공적으로 초기화되었는지 확인합니다.
+ (BOOL)이Initialized
다음 반환:
true
인 경우 Unity Ads가 성공적으로 초기화되었습니다.

getVersion

사용 중인 현재 Unity Ads SDK 버전을 결정합니다.
+ (NSString *)getVersion
다음 반환: 현재 설치된 Unity Ads SDK 버전입니다.

userIdentifier

앱의 각 사용자 대한 고유한 ID를 설정합니다.
@objc 공용 정적 var userIdentifier: 문자열 {...}

개인정보

setUserConsent()

맞춤형 광고에 대한 사용자 동의 옵션을 표시합니다.
+ (void)setUserConsent:(BOOL)consentGranted;

setUserOptOut()

사용자에게 데이터 컬렉션 및 맞춤형 광고를 거부할 수 있는 옵션을 제공합니다.
+ (void)setUserOptOut:(BOOL)optOut;

setNonBehavioral()

문맥(비맞춤형) 광고 표시를 활성화합니다.
+ (void)setNonBehavioral:(BOOL)nonBehavioral;

UADSMetaData

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
UnityAds
(
setUserConsent:
,
setUserOptOut:
,
setNonBehavioral:
)에 입력된 개인정보 보호 방법을 사용합니다. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSMetaData
는 GDPR 및 기타 개인정보 보호 관련 플래그를 설정하기 위한 이전 클래스입니다.

UnityAdsInitializationDelegate

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신에 완료 차단과
UnityAds initialize:completion:
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UnityAdsInitializationDelegate
는 SDK 초기화 콜백의 이전 델리게이트 프로토콜입니다.

UnityAdsLoadDelegate

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신에
UADSInterstitialAd load:completion:
또는
UADSRewardedAd load:completion:
가 있는 완성 차단을 사용합니다. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UnityAdsLoadDelegate
는 광고 로딩 콜백의 이전 델리게이트 프로토콜입니다.

UnityAdsShowDelegate

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신에
UADSInterstitialShowDelegate
또는
UADSRewardedShowDelegate
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UnityAdsShowDelegate
는 광고 쇼 콜백의 이전 델리게이트 프로토콜입니다.

열거형

UADSAdFormat

Unity Ads 지원하는 다양한 타입의 광고 형식을 정의합니다.
typedef 열거형 { UADSAdFormatUnspecified = 0, UADSAdFormatInterstitial = 1, UADSAdFormatRewarded = 2, UADSAdFormatBanner = 3,} UADSAdFormat;

파라미터

설명

UADSAdFormatUnspecified특정 광고 형식 없음.
UADSAdFormatInterstitial앱의 자연스러운 일시 정지 시 표시되는 전체 화면 광고입니다.
UADSAdFormatRewarded완료 후 사용자에게 보상을 부여하는 광고입니다.
UADSAdFormatBanner앱 레이아웃 내에 표시되는 직사각형 광고로, 일반적으로 화면 상단 또는 하단에 고정됩니다.

UnityAdsAdFormat

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
UADSAdFormat
를 사용하십시오. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UnityAdsAdFormat
는 광고 형식 유형의 이전 열거형입니다.

UADSLogLevel

Unity Ads 로깅 레벨을 정의합니다.
typedef 열거형 { UADSLogLevelDisabled = 0, UADSLogLevelError = 1, UADSLogLevelInfo = 2, UADSLogLevelDebug = 3,} UADSLogLevel;

파라미터

설명

UADSLogLevelDisabled로그 출력 없음.
UADSLogLevelErroriniti/load/show 작업에서 중요한 오류와 오류만 기록합니다.
UADSLogLevelInfo주요 운영 이벤트(예: 초기화 시작/완료, 로드 시작/완료, 시작/완료 표시, 토큰 생성)를 기록합니다.
UADSLogLevelDebug모든 정보와 네트워크 요청 및 내부 오류와 같은 상세한 내부 작업을 기록합니다.

UADSShowFinishState

광고가 표시된 후의 종료 상태를 나타냅니다.
typedef 열거형 { UADSShowFinishStateSkipped = 0, UADSShowFinishStateCompleted = 1,} UADSShowFinishState

파라미터

설명

UADSShowFinishStateSkipped사용자가 광고가 끝나기 전에 광고를 닫거나 건너뛰었습니다.
UADSShowFinishStateCompleted광고는 끝까지 재생.

프로토콜

UADSBannerAdDelegate

@protocol UADSBannerAdDelegate <NSObject>- (void)bannerImpression:(UADSBannerAd * _Nonnull) 배너;- (void)bannerDidClick:(UADSBannerAd * _Nonnull) 배너;- (void)bannerDidFailShow:(UADSBannerAd * _Nonnull)배너 오류:(id<UnityAdsError> _Nonnull)오류;@end

메서드

설명

bannerImpression:
배너 광고가 표시될 때 호출됩니다(노출 기록).
bannerDidClick:
사용자가 배너 광고를 클릭했을 때 호출됩니다.
bannerDidFailShow:error:
배너가 표시되지 않는 경우 호출되며, 장애를 설명하는
UnityAdsError
가 표시됩니다.

UADSInterstitialShowDelegate

@protocol UADSInterstitialShowDelegate <NSObject>- (void)showDidStart:(UADSInterstitialAd * _Nonnull)unityAd;- (void)showDidClick:(UADSInterstitialAd * _Nonnull)unityAd;- (void)showDidComplete:(UADSInterstitialAd * _Nonnull)unityAd와:( 열거형 UADSShowFinishState)finishState;- (void)showDidFail:(UADSInterstitialAd * _Nonnull)unityAd error:(id<UnityAdsError> _Nonnull)error;@end
광고 표시가 종료되면

메서드

설명

showDidStart:
인터스티셜 광고 노출에 호출됩니다.
showDidClick:
인터스티셜 광고를 클릭했을 때 호출됩니다.
showDidComplete:with:
호출됩니다.
UADSShowFinishState
(
skipped
또는
completed
)를 제공합니다.
showDidFail:error:
광고가 표시되지 않으면 호출되며, 실패를 설명하는
UnityAdsError
가 표시됩니다.

UADSRewardedShowDelegate

@protocol UADSRewardedShowDelegate <NSObject>- (void)showDidStart:(UADSRewardedAd * _Nonnull)unityAd;- (void)showDidClick:(UADSRewardedAd * _Nonnull)unityAd;- (void)showDidComplete:(UADSRewardedAd * _Nonnull)unityAd와:( 열거형 UADSShowFinishState)finishState;- (void)showDidFail:(UADSRewardedAd * _Nonnull)unityAd error:(id<UnityAdsError> _Nonnull)error;- (void)showDidReceiveReward:(UADSRewardedAd * _Nonnull)unityAd;@end
광고 표시가 종료되면

메서드

설명

showDidStart:
보상형 광고 노출 시 호출됩니다.
showDidClick:
보상형 광고가 클릭되면 호출됩니다.
showDidComplete:with:
호출됩니다.
UADSShowFinishState
(
skipped
또는
completed
)를 제공합니다.
showDidFail:error:
광고가 표시되지 않으면 호출되며, 실패를 설명하는
UnityAdsError
가 표시됩니다.
showDidReceiveReward:
유저가 광고에서 보상을 얻을 때 호출됩니다.

UnityAdsError

@protocol UnityAdsError@property (비개형, 읽기 전용) NSInteger 코드;@property (nonatomic, readonly, copy) NSString * _Nonnull 메시지;@end

파라미터

설명

code
메시지

UADSBannerErrorCode

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
id<UnityAdsError>
프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UADSBannerErrorCode
는 배너별 오류 코드의 이전 열거형입니다.

UnityAdsInitializationError

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
id<UnityAdsError>
프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UnityAdsInitializationError
는 초기화 오류 유형의 이전 열거형입니다.

UnityAdsLoadError

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
id<UnityAdsError>
프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UnityAdsLoadError
는 광고 로드 오류 유형의 이전 열거형입니다.

UnityAdsShowError

경고
4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정
대신
id<UnityAdsError>
프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 iOS 사용 중단 예정 API를 참조하십시오.
UnityAdsShowError
는 광고 표시 오류 유형의 이전 열거형입니다.