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
UADSBannerAdload: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
UADSBannerViewUADSBannerViewDelegate
UADSBannerViewDelegateUADSBannerLoadConfiguration
UADSBannerLoadConfiguration@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프로퍼티 | 설명 | 필수 |
|---|---|---|
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 예 |
|
배너 광고의 크기입니다. | 예 |
| 배너 광고 이벤트를 처리합니다. | 예 |
다음 반환: 의 인스턴스.
UADSBannerLoadConfigurationBuilderwithAdMarkup:_
- AdMarkup(NSString * _Nonnull)과 함께 (nonnull 인스턴스 타입)adMarkup
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| adMarkup | 입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다. |
withMediationAdUnitId:_
- (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
Mediation 광고 유닛 ID를 에 추가합니다.
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| mediationAdUnitId | Mediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSBannerLoadConfigurationBuilderwithMediationInfo:_
- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
Mediation 정보를 에 추가합니다.
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| mediationInfo | Mediation 통합에 대한 세부 정보(이름, 버전, 어댑터 버전) |
다음 반환: 업데이트된 UADSBannerLoadConfigurationBuilder 인스턴스.
withExtras:_
- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
추가 키-값 파라미터를 에 추가합니다.
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| extras | 배너 로딩을 위한 커스텀 파라미터. |
다음 반환: 업데이트된 인스턴스.
UADSBannerLoadConfigurationBuilder빌드
- (UADSBannerLoadConfiguration * _Nonnull)빌드
빌드하고 인스턴스를 반환합니다.
UADSBannerLoadConfiguration다음 반환: 의 인스턴스.
UADSBannerLoadConfigurationUADSBannerLoadOptions
UADSBannerLoadOptionsUADSInitializationConfiguration
@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 프로젝트의 고유 식별자입니다. | 예 |
| | 테스트 모드를 활성화하거나 비활성화합니다. | 아니요 |
| | 로그 출력의 디테일 수준을 지정합니다. | 아니요 |
| | Mediation 통합에 대한 세부 정보를 지정합니다. | 아니요 |
| | 커스텀 설정을 위한 추가 키-값 쌍. | 아니요 |
UADSInitializationConfigurationBuilder
UADSInitConfigurationBuilderUADSInitializationConfigurationinitWithgameID:_
- (nonnull 인스턴스 타입)initWithGameId:(NSString * _Nonnull)gameId
새 인스턴스를 만듭니다.
UADSInitConfigurationBuilder파라미터 | 설명 |
|---|---|
| gameId | Unity Ads 관리 툴 또는 Unity 에디터에서 제공하는 게임의 고유 식별자입니다. |
다음 반환: 의 인스턴스.
UADSInitConfigurationBuilderwithTestMode:_
- (nonnull 인스턴스 타입) withTestMode:(BOOL)testMode
테스트 모드를 설정합니다.
파라미터 | 설명 |
|---|---|
| testMode | 테스트 모드를 표시하고 테스트 광고만 표시하려면 이 플래그를 |
다음 반환: 업데이트된 인스턴스.
UADSInitConfigurationBuilderwithLogLevel:_
- (nonnull 인스턴스 타입)LogLevel(열거형 UADSLogLevel)logLevel
로그에 포함된 세부 정보의 양을 None부터 Full 디버그 정보까지 정의하는 로그 레벨을 설정합니다.
파라미터 | 설명 |
|---|---|
| 레벨 | 로그 출력의 디테일 수준을 지정합니다. |
다음 반환: 업데이트된 인스턴스.
UADSInitConfigurationBuilderwithMediationInfo:_
- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
Mediation 정보를 설정합니다. 여기에는 Mediation 이름, 버전, 어댑터 버전 등 앱의 Mediation 통합에 대한 세부 정보가 포함됩니다.
파라미터 | 설명 |
|---|---|
| info | Mediation 통합에 대한 세부 정보를 지정합니다. |
다음 반환: 업데이트된 인스턴스.
UADSInitConfigurationBuilderwithExtras:_
- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
추가 파라미터를 설정합니다.
파라미터 | 설명 |
|---|---|
| extras | 커스텀 설정을 위한 추가 키-값 페어입니다. |
다음 반환: 업데이트된 인스턴스.
UADSInitConfigurationBuilder빌드
- (UADSInitializationConfiguration * _Nonnull)빌드
UADSInitializationConfiguration 인스턴스 빌드하고 반환합니다.
다음 반환: 의 인스턴스.
UADSInitializationConfigurationUADSInterstitialAd
UADSInterstitialAdload: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 | 광고 이벤트를 처리하기 위한 |
onAdExpired
광고 만료 시 트리거되는 콜백 등록합니다.
@interface UnityAd : NSObject@property (nonatomic, copy) void (^ _Nullable onAdExpired)(UnityAd * _Nonnull);@end
UADSLoadConfiguration
UADSLoadConfiguration@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프로퍼티 | 설명 | 필수 |
|---|---|---|
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 예 |
| 입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다. | 아니요 |
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. | 아니요 |
| Mediation 통합에 대한 세부 정보를 지정합니다. | 아니요 |
| 설정용 커스텀 키-값 쌍 추가. | 아니요 |
참고 adMarkup 프로퍼티 모든 입찰 구현에 필요합니다. 워터폴 구현의 경우 adMarkup을 null으로 설정할 수 있습니다. |
UADSLoadConfigurationBuilder
UADSLoadConfigurationBuilderUADSLoadConfigurationinitWithPlacementId:_
- - (nonnull instancetype)initWithPlacementId:(NSString * _Nonnull)placementId;
새 인스턴스를 만듭니다.
UADSLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. |
다음 반환: 의 인스턴스.
UADSLoadConfigurationBuilderwithAdMarkup:_
- AdMarkup(NSString * _Nonnull)과 함께 (nonnull 인스턴스 타입)adMarkup
UADSLoadConfigurationBuilder프로퍼티 | 설명 |
|---|---|
| 입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다. |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilderwithMediationAdUnitId:_
- (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
Mediation 광고 유닛 ID를 에 추가합니다.
UADSLoadConfigurationBuilder프로퍼티 | 설명 |
|---|---|
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilderwithMediationInfo:_
- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
Mediation 정보를 에 추가합니다.
UADSLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다(이름, 버전, 어댑터 버전). |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilderwithExtras:_
- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
추가 설정 키-값 쌍을 에 추가합니다.
UADSLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| extras | 광고 로딩을 위한 커스텀 파라미터의 사전. |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilder빌드
- (UADSLoadConfiguration * _Nonnull)빌드
빌드하고 인스턴스를 반환합니다.
UADSLoadConfiguration다음 반환: 의 인스턴스.
UADSLoadConfigurationUADSLoadOptions
UADSLoadOptionsUADSMediationInfo
Mediation 통합에 대한 세부 정보를 지정합니다.
@interface UADSMediationInfo : NSObject- (nonnull 인스턴스 타입)initWithName:(NSString * _Nonnull)name 버전:(NSString * _Nonnull) 버전 adapterVersion:(NSString * _Nonnull)adapterVersion@end
파라미터 | 설명 |
|---|---|
| name | 앱에 통합된 Mediation 플랫폼의 이름입니다. |
| 버전 | 앱에 통합된 Mediation SDK 버전입니다. |
| adapterVersion | Mediation 파트너를 위한 Unity Ads 어댑터 버전입니다. |
다음 반환: 의 인스턴스.
UADSMediationInfoUADSMediationMetaData
UADSMediationMetaDataUADSRewardedAd
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@interface UADSShowConfigurationBuilder : NSObject@property (nonatomic, weak, nullable) UIViewController *viewController;@property (nonatomic, strong, nullable) NSString *customRewardString;@property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;@end
선택적 추가 파라미터가 있는 새 인스턴스를 생성합니다.
UADSShowConfiguration프로퍼티 | 설명 | 필수 |
|---|---|---|
| 광고를 표시하는 데 사용된 보기 컨트롤러입니다. | 지원 안 함 |
| 광고 노출에 대한 커스텀 보상 식별자입니다. | 아니요 |
|
광고를 표시할 때 포함할 추가 키-값 파라미터입니다. 기본값은 빈 사전입니다. | 아니요 |
UADSShowConfigurationBuilder
UADSShowConfigurationBuilderUADSShowConfigurationinit
- (nonnull 인스턴스 타입)init;
새 인스턴스를 만듭니다.
UADSShowConfigurationBuilderwithViewController:_
- (nonnull 인스턴스 타입)와ViewController:(UIViewController * _Nonnull)viewController
광고를 표시할 뷰 컨트롤러 설정합니다.
파라미터 | 설명 |
|---|---|
| 광고를 표시하는 뷰 컨트롤러입니다. |
다음 반환: 업데이트된 인스턴스.
UADSShowConfigurationBuilderwithCustomRewardString:_
- (nonnull 인스턴스 타입)CustomRewardString(NSString * _Nonnull)과 함께 사용
광고 노출에 대한 커스텀 보상 식별자 설정합니다.
파라미터 | 설명 |
|---|---|
| 광고 노출에 대한 고유 보상 ID입니다. |
다음 반환: 업데이트된 인스턴스.
ShowConfigurationBuilderwithExtras:_
- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
광고를 표시할 때 추가 키-값 파라미터를 추가합니다.
파라미터 | 설명 |
|---|---|
| 광고 표시를 위한 커스텀 파라미터입니다. |
다음 반환: 업데이트된 인스턴스.
UADSShowConfigurationBuilder빌드
- (UADSShowConfiguration * _Nonnull)빌드
빌드하고 인스턴스를 반환합니다.
UADSShowConfiguration다음 반환: 의 인스턴스.
UADSShowConfigurationUADSShowOptions
UADSShowOptionsUADSTokenConfiguration
@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프로퍼티 | 설명 | 필수 |
|---|---|---|
| 광고 형식의 유형을 지정합니다(인터스티셜 광고, 보상형 광고, 배너). | 예 |
| Mediation 통합에 대한 세부 정보를 지정합니다. | 아니요 |
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. | 아니요 |
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 아니요 |
| 토큰이 배너 광고를 요청한 경우 배너 광고의 크기입니다. | 아니요 |
| 커스텀 설정을 위한 추가 키-값 쌍. | 아니요 |
UADSTokenConfigurationBuilder
UADSTokenConfigurationBuilderUADSTokenConfigurationinitWithAdFormat:_
- (nonnull 인스턴스 타입)initWithAdFormat:( 열거형 UADSAdFormat)adFormat
새 인스턴스를 만듭니다.
UADSTokenConfigurationBuilder파라미터 | 설명 |
|---|---|
| adFormat | 광고 유형(인터스티셜 광고, 보상형 광고, 배너)을 지정하는 AdFormat 인스턴스입니다. |
다음 반환: 의 인스턴스.
UADSTokenConfigurationBuilderwithMediationInfo:_
- (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)mediationInfo
Mediation 통합에 대한 세부 정보를 지정합니다.
파라미터 | 설명 |
|---|---|
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다. |
다음 반환: 업데이트된 인스턴스.
TokenConfigurationBuilderwithMediationAdUnitId:_
- (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
Mediation 광고 유닛 ID를 에 추가합니다.
TokenConfiguration프로퍼티 | 설명 |
|---|---|
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSTokenConfigurationBuilderwithPlacementId:_
- (nonnull 인스턴스 타입) withPlacementId:(NSString * _Nonnull)placementId
Unity 수익화 대시보드에 정의된 플레이스먼트 ID를 지정합니다.
파라미터 | 설명 |
|---|---|
| placementId | Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSTokenConfigurationBuilderwithBannerSize:_
- (nonnull 인스턴스 타입)와BannerSize:(CGSize)bannerSize
토큰이 배너 광고를 요청한 경우 배너 광고의 크기를 지정합니다.
파라미터 | 설명 |
|---|---|
| bannerSize | 토큰이 배너 광고를 요청한 경우 배너 광고의 크기입니다. |
다음 반환: 업데이트된 인스턴스.
UADSTokenConfigurationBuilderwithExtras:_
- (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
커스텀 설정 대한 추가 키-값 쌍을 지정합니다.
파라미터 | 설명 |
|---|---|
| extras | 커스텀 설정을 위한 추가 키-값 페어입니다. |
다음 반환: 업데이트된 인스턴스.
UADSTokenConfigurationBuilder빌드
- (UADSTokenConfiguration * _Nonnull)빌드
빌드하고 인스턴스를 반환합니다.
UADSTokenConfiguration다음 반환: 의 인스턴스.
UADSTokenConfigurationUnityAds
UnityAds초기화
initialize(_, completion:)
지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 차단 호출됩니다.
+ (void) initialize:(UADSInitializationConfiguration *) 설정 완료(void (^)(id<UnityAdsError>)) 완료;
파라미터 | 설명 |
|---|---|
| 설정 | SDK를 초기화하는 데 필요한 설정이 포함된 UADSInitializationConfiguration 오브젝트입니다. |
| 완료 | SDK 초기화가 완료되면 호출되는콜백입니다. 초기화에 실패하면 UnityAdsError를 반환합니다. |
GetToken
getToken(_, completion:)
제공된 에 따라 입찰 토큰을 가져와 완료 차단으로 전달합니다.
UADSTokenConfiguration+ (void) getToken(UADSTokenConfiguration *) 설정 완료(void (^)(NSString *)) 완료;
파라미터 | 설명 |
|---|---|
| 설정 | 광고 형식, Mediation 정보 및 기타 파라미터를 지정하는 |
| 완료 | 토큰이 성공적으로 페치되면 완료 차단을 호출하고 오류가 발생하면 null을 호출합니다. |
정적 변수
IsInitialized
Unity Ads SDK가 성공적으로 초기화되었는지 확인합니다.
+ (BOOL)이Initialized
다음 반환: 인 경우 Unity Ads가 성공적으로 초기화되었습니다.
truegetVersion
사용 중인 현재 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
UADSMetaDataUnityAdsInitializationDelegate
UnityAdsInitializationDelegateUnityAdsLoadDelegate
UnityAdsLoadDelegateUnityAdsShowDelegate
UnityAdsShowDelegate열거형
UADSAdFormat
Unity Ads 지원하는 다양한 타입의 광고 형식을 정의합니다.
typedef 열거형 { UADSAdFormatUnspecified = 0, UADSAdFormatInterstitial = 1, UADSAdFormatRewarded = 2, UADSAdFormatBanner = 3,} UADSAdFormat;
파라미터 | 설명 |
|---|---|
| UADSAdFormatUnspecified | 특정 광고 형식 없음. |
| UADSAdFormatInterstitial | 앱의 자연스러운 일시 정지 시 표시되는 전체 화면 광고입니다. |
| UADSAdFormatRewarded | 완료 후 사용자에게 보상을 부여하는 광고입니다. |
| UADSAdFormatBanner | 앱 레이아웃 내에 표시되는 직사각형 광고로, 일반적으로 화면 상단 또는 하단에 고정됩니다. |
UnityAdsAdFormat
UnityAdsAdFormatUADSLogLevel
Unity Ads 로깅 레벨을 정의합니다.
typedef 열거형 { UADSLogLevelDisabled = 0, UADSLogLevelError = 1, UADSLogLevelInfo = 2, UADSLogLevelDebug = 3,} UADSLogLevel;
파라미터 | 설명 |
|---|---|
| UADSLogLevelDisabled | 로그 출력 없음. |
| UADSLogLevelError | initi/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
메서드 | 설명 |
|---|---|
| 배너 광고가 표시될 때 호출됩니다(노출 기록). |
| 사용자가 배너 광고를 클릭했을 때 호출됩니다. |
| 배너가 표시되지 않는 경우 호출되며, 장애를 설명하는 |
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
메서드 | 설명 |
|---|---|
| 인터스티셜 광고 노출에 호출됩니다. |
| 인터스티셜 광고를 클릭했을 때 호출됩니다. |
|
광고 표시가 종료되면 호출됩니다. |
| 광고가 표시되지 않으면 호출되며, 실패를 설명하는 |
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
메서드 | 설명 |
|---|---|
| 보상형 광고 노출 시 호출됩니다. |
| 보상형 광고가 클릭되면 호출됩니다. |
|
광고 표시가 종료되면 호출됩니다. |
| 광고가 표시되지 않으면 호출되며, 실패를 설명하는 |
| 유저가 광고에서 보상을 얻을 때 호출됩니다. |
UnityAdsError
@protocol UnityAdsError@property (비개형, 읽기 전용) NSInteger 코드;@property (nonatomic, readonly, copy) NSString * _Nonnull 메시지;@end
파라미터 | 설명 |
|---|---|
| code | |
| 메시지 |
UADSBannerErrorCode
UADSBannerErrorCodeUnityAdsInitializationError
UnityAdsInitializationErrorUnityAdsLoadError
UnityAdsLoadErrorUnityAdsShowError
UnityAdsShowError