Unity Ads iOS SDK API 레퍼런스 - Swift
Unity Ads SDK 공용 API 레퍼런스에 액세스하여 Swift에서 iOS 앱의 광고 동작을 연동하고 제어하는 데 사용할 수 있는 클래스, 메서드 및 프로퍼티를 확인합니다.
읽는 시간 22분최근 업데이트: 25일 전
Unity Unity AdsUnity Ads Android SDK API 이 레퍼런스 사용합니다.
이 API를 사용하기 전에 앱에서 수익화를 활성화할 수 있도록 라이브러리를 임포트했는지 확인합니다. 자세한 내용은 UnityAds 라이브러리 임포트를 참조하십시오.
UnityAds클래스
UADSBannerAd
UADSBannerAdload(:완료)
공용 클래스 UADSBannerAd: NSOobject { 공용 정적 기능 로드(_ 설정: UADSBannerLoadConfiguration, 완료: @escaping(UADSBannerAd?, UnityAdsError?) -> Void)}
지정된 설정 배너 광고를 로드합니다.
파라미터 | 설명 |
|---|---|
| 설정 | 배너 광고 로드 옵션. |
| 완료 | 배너가 로드될 때 호출되는콜백. 로드되면 로드된 UADSBannerAd 인스턴스 또는 로드에 실패하면 UnityAdsError를 반환합니다. |
onAdExpired
공용 var onAdExpired: ((UADSBannerAd) -> Void)?
광고 만료 시 트리거되는 콜백. 로드된 배너 광고가 만료되고 더 이상 유효하지 않으면 이 프로퍼티 알림을 받도록 설정합니다.
뷰
공용 클래스 UADSBannerAd: UIView { 공용 var view: UIView}
배너 광고 인스턴스 대한 액세스, 접근 제공하는 view 프로퍼티. 이 프로퍼티 사용하여 앱의 기존 뷰 계층 구조 구조 내에서 원하는 위치에 배너 광고를 삽입합니다.
UADSBannerView
UADSBannerViewUADSBannerViewDelegate
UADSBannerViewDelegateUADSBannerLoadConfiguration
UADSBannerLoadConfiguration공용 클래스 UADSBannerLoadConfiguration: NSOobject { @objc public private(set) var placementId: 문자열 @objc public private(set) var adMarkup: 문자열? @objc 공용 private(set) var bannerSize: CGSize @objc 공용 private(set) var delegate: UADSBannerAdDelegate @objc public private(set) var mediationAdUnitId: 문자열? @objc public private(set) var mediationInfo: UADSMediationInfo? @objc 공용 private(set) var extras: [문자열: 문자열]}
프로퍼티 | 설명 | 필수 |
|---|---|---|
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 예 |
| 입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다. | 아니요 |
|
배너 광고의 크기입니다. | 예 |
| 배너 광고 이벤트를 처리합니다. | 예 |
| Mediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다. | 아니요 |
| Mediation 통합에 대한 세부 정보를 지정합니다. | 아니요 |
| 추가 커스텀 키-값 페어. | 아니요 |
UADSBannerLoadConfigurationBuilder
UADSBannerLoadConfigurationBuilderUADSBannerLoadConfigurationinit(placementId, bannerSize, delegate)
public init(placementId: 문자열 bannerSize: CGSize, delegate: UADSBannerAdDelegate)
새 인스턴스를 만듭니다.
UADSBannerLoadConfigurationBuilder프로퍼티 | 설명 | 필수 |
|---|---|---|
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 예 |
|
배너 광고의 크기입니다. | 예 |
| 배너 광고 이벤트를 처리합니다. | 예 |
다음 반환: 의 인스턴스.
UADSBannerLoadConfigurationBuilderwith(adMarkup:)_
public func with(adMarkup: 문자열) -> 자체
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| adMarkup | 입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다. |
다음 반환: 업데이트된 인스턴스.
UADSBannerLoadConfigurationBuilderwith(mediationAdUnitId:)_
public func with(mediationAdUnitId: 문자열) -> 자체
Mediation 광고 유닛 ID를 에 추가합니다.
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| mediationAdUnitId | Mediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSBannerLoadConfigurationBuilderwith(mediationInfo:)_
public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 정보를 에 추가합니다.
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| mediationInfo | Mediation 통합에 대한 세부 정보(이름, 버전, 어댑터 버전) |
다음 반환: 업데이트된 인스턴스.
UADSBannerLoadConfigurationBuilderwith(extras:)_
공용 함수(추가 사항: [문자열: 문자열]) -> 자체
추가 키-값 파라미터를 에 추가합니다.
UADSBannerLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| extras | 배너 로딩을 위한 커스텀 파라미터. |
다음 반환: 업데이트된 UADSBannerLoadConfigurationBuilder 인스턴스.
build()_
공용 함수 빌드() -> UADSBannerLoadConfiguration
빌드하고 인스턴스를 반환합니다.
UADSBannerLoadConfiguration다음 반환: 의 인스턴스.
UADSBannerLoadConfigurationUADSBannerLoadOptions
UADSBannerLoadOptionsUADSInitializationConfiguration
공용 클래스 UADSInitializationConfiguration: NSOobject { @objc public private(set) var gameId: 문자열 @objc public private(set) var isTestModeEnabled: 부울 @objc 공용 private(set) var logLevel: UADSLogLevel @objc public private(set) var mediationInfo: UADSMediationInfo? @objc 공용 private(set) var extras: [문자열: 문자열]}
UADSInitializationConfiguration프로퍼티 | 설명 | 필수 |
|---|---|---|
| Unity Ads 수익화 대시보드의 고유 게임 식별자입니다. | 예 |
|
테스트 모드를 활성화하는 부울입니다. true인 경우 테스트 광고만 표시됩니다. 기본값은 false입니다. | 아니요 |
|
로그 출력의 디테일 수준(LOD)을 지정합니다. 기본값은 INFO입니다. | 아니요 |
| Mediation 통합에 대한 정보를 포함하는 오브젝트입니다. | 아니요 |
| 커스텀 구성을 위한 추가 키-값 파라미터의 맵입니다. | 아니요 |
UADSInitializationConfigurationBuilder
UADSInitializationConfigurationBuilderUADSInitializationConfigurationInitialize
공용 정적 기능 초기화(_ 설정: UADSInitializationConfiguration, 완료: @escaping(UnityAdsError?) -> Void)
지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 핸들러 호출됩니다.
파라미터 | 설명 |
|---|---|
| 설정 | SDK를 초기화하는 데 필요한 설정을 포함하는 UADSInitializationConfiguration 오브젝트입니다. |
| 완료 | 완료 시 완료 콜백이 호출되며 오류 메시지와 오류 코드로 실패가 성공했는지 또는 실패 원인을 상세하게 표시합니다. |
init(gameId:)_
public init(gameId: 문자열)
새 인스턴스를 만듭니다.
UADSInitializationConfigurationBuilder파라미터 | 설명 |
|---|---|
| gameId | Unity Ads 관리 툴 또는 Unity 에디터에서 제공하는 게임의 고유 식별자입니다. |
다음 반환: 의 인스턴스.
UADSInitializationConfigurationBuilderwith(testMode:)_
public func with(testMode: 부울) -> 자체
테스트 모드를 설정합니다.
파라미터 | 설명 |
|---|---|
| testMode | 테스트 모드를 표시하고 테스트 광고만 표시하려면 이 플래그를 |
다음 반환: 업데이트된 인스턴스.
UADSInitializationConfigurationBuilderwith(logLevel:)_
공용 함수(logLevel): UADSLogLevel) -> Self
로그에 포함된 디테일의 양을 정의하는 로그 레벨을 설정합니다(없음에서 전체 디버그 정보).
파라미터 | 설명 |
|---|---|
| logLevel | 로그 출력의 디테일 수준을 지정합니다. |
다음 반환: 업데이트된 인스턴스.
UADSInitializationConfigurationBuilderwith(mediationInfo:)_
public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 정보를 설정합니다. 여기에는 Mediation 이름, 버전, 어댑터 버전 등 앱의 Mediation 통합에 대한 세부 정보가 포함됩니다.
파라미터 | 설명 |
|---|---|
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다. |
다음 반환: 업데이트된 인스턴스.
UADSInitializationConfigurationBuilderwith(extras:)_
공용 함수(추가 사항: [문자열: 문자열]) -> 자체
추가 파라미터를 설정합니다.
파라미터 | 설명 |
|---|---|
| extras | 커스텀 설정을 위한 추가 키-값 페어입니다. |
다음 반환: 업데이트된 인스턴스.
UADSInitializationConfigurationBuilderbuild()
공용 함수 빌드() -> UADSInitializationConfiguration
빌드하고 인스턴스를 반환합니다.
UADSInitializationConfiguration다음 반환: 의 인스턴스.
UADSInitializationConfigurationUADSInterstitialAd
UADSInterstitialAdload(:완료)
공용 클래스 UADSInterstitialAd: NSOobject { 공용 정적 기능 로드(_ 설정: UADSLoadConfiguration, 완료: @escaping(UADSInterstitialAd?, UnityAdsError?) -> Void)}
지정된 설정 인터스티셜 광고 광고를 로드합니다.
파라미터 | 설명 |
|---|---|
| 설정 | 광고 로딩 옵션이 포함된 UADSLoadConfiguration 인스턴스입니다. |
| 완료 | 로드 프로세스가 완료되면 호출되는콜백입니다. 성공하면 UADSInterstitialAd 인스턴스, 로드에 실패하면 UnityAdsError를 반환합니다. |
show(_:delegate:)
공용 클래스 UADSInterstitialAd: NSOobject { 공용 function show(_ 설정: UADSShowConfiguration? = null, delegate: UADSInterstitialShowDelegate)}
로드된 인터스티셜 광고 광고를 표시합니다.
파라미터 | 설명 |
|---|---|
| 설정 | 광고 표시를 위한 선택적 설정입니다. |
| delegate | 광고 이벤트를 처리하기 위해 UADSInterstitialShowDelegate를 준수하는 델리게이트입니다. |
onAdExpired
광고 만료 시 트리거되는 콜백 등록합니다.
공용 클래스 UADSInterstitialAd: NSOobject { 공용 var onAdExpired: ((UnityAd) -> Void)?}
UADSLoadConfiguration
UADSLoadConfiguration공용 클래스 UADSLoadConfiguration: NSOobject { @objc public private(set) var placementId: 문자열 @objc public private(set) var adMarkup: 문자열? @objc public private(set) var mediationAdUnitId: 문자열? @objc public private(set) var mediationInfo: UADSMediationInfo? @objc 공용 private(set) var extras: [문자열: 문자열]}
새 인스턴스를 만듭니다.
UADSLoadConfiguration프로퍼티 | 설명 | 필수 |
|---|---|---|
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 예 |
|
입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다. Null이면 워터폴이죠 | 아니요 |
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. | 아니요 |
| Mediation 통합에 대한 세부 정보를 지정합니다. | 아니요 |
| 설정용 커스텀 키-값 쌍 추가. | 아니요 |
참고 adMarkup 프로퍼티 모든 입찰 구현에 필요합니다. 워터폴 구현의 경우 adMarkup을 null으로 설정할 수 있습니다. |
UADSLoadConfigurationBuilder
UADSLoadConfigurationBuilderUADSLoadConfigurationinit(placementId:)
public init(placementId: 문자열)
새 인스턴스를 만듭니다.
UADSLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. |
다음 반환: 의 인스턴스.
UADSLoadConfigurationBuilderwith(adMarkup:)_
public func with(adMarkup: 문자열) -> 자체
UADSLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| adMarkup | 입찰을 통해 광고를 로드할 때 사용되는광고 마크업 데이터입니다. Null이면 광고 요청이 워터폴을 사용합니다. |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilderwith(mediationAdUnitId:)_
public func with(mediationAdUnitId: 문자열) -> 자체
Mediation 광고 유닛 ID를 에 추가합니다.
UADSLoadConfigurationBuilder프로퍼티 | 설명 |
|---|---|
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilderwith(mediationInfo:)_
public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 정보를 에 추가합니다.
UADSLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다(이름, 버전, 어댑터 버전). |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilderwith(extras:)_
공용 함수(추가 사항: [문자열: 문자열]) -> 자체
추가 설정 키-값 쌍을 에 추가합니다.
UADSLoadConfigurationBuilder파라미터 | 설명 |
|---|---|
| extras | 광고 로딩을 위한 커스텀 파라미터의 사전. |
다음 반환: 업데이트된 인스턴스.
UADSLoadConfigurationBuilderbuild()
공용 함수 빌드() -> UADSLoadConfiguration
빌드하고 인스턴스를 반환합니다.
UADSLoadConfiguration다음 반환: 의 인스턴스.
UADSLoadConfigurationUADSLoadOptions
UADSLoadOptionsUADSMediationInfo
Mediation 통합에 대한 세부 정보를 지정합니다.
공용 클래스 UADSMediationInfo: NSOobject { public init(name: 문자열, 버전: 문자열, 어댑터버전: 문자열)}
파라미터 | 설명 |
|---|---|
| name | 앱에 통합된 Mediation 플랫폼의 이름입니다. |
| 버전 | 앱에 통합된 Mediation SDK 버전입니다. |
| adapterVersion | Mediation 파트너를 위한 Unity Ads 어댑터 버전입니다. |
다음 반환: 의 인스턴스.
UADSMediationInfoUADSMediationMetaData
UADSMediationMetaData개인정보
개인정보 보호는 Unity Ads 개인정보 보호 설정과 사용자 동의를 관리하기 위한 API를 제공하는 열거형 집합과 클래스. 이를 통해 개발자는 다양한 개인정보 보호 설정과 GDPR, PIPL 및 기타 규정을 준수하는 동의를 처리할 수 있습니다.
공용 클래스 개인정보 보호: NSOobject { public static func set(privacy: PrivacyFlag, 값: PrivacyValue) {} 공용 정적 기능 세트(동의: PrivacyConsent, 값: PrivacyConsentValue) {} // 새 플래그를 설정하려면 기존 플래그를 작성할 경우 예외를 발생시킵니다. public static func setPrivacy(_ flag: 문자열, 동의: PrivacyConsentValue) throws {} public static func setPrivacy(_ flag: 문자열, 값: PrivacyValue)는 {}를 발생시킵니다.}
UADSMetaData
UADSMetaDataUADSRewardedAd
UADSRewardedAdload(_:completion)_
공용 클래스 UADSRewardedAd: NSOobject { 공용 정적 기능 로드(_ 설정: UADSLoadConfiguration, 완료: @escaping(UADSRewardedAd?, UnityAdsError?) -> Void)}
지정된 옵션으로 보상형 광고 광고를 로드합니다.
파라미터 | 설명 |
|---|---|
| 설정 | 광고 로딩 옵션이 포함된 UADSLoadConfiguration 인스턴스입니다. |
| 완료 | 광고 로딩이 끝나면 호출되는콜백입니다. 성공하면 UADSRewardedAd 인스턴스 또는 로드에 실패하면 오류를 반환합니다. |
show(_:delegate:)
공용 클래스 UADSRewardedAd: NSOobject { 공용 function show(_ 설정: UADSShowConfiguration? = null, delegate: UADSRewardedShowDelegate)}
로드된 보상형 광고 광고를 표시합니다.
파라미터 | 설명 |
|---|---|
| 설정 | 광고 표시를 위한 선택적 설정입니다. |
| delegate | 보상형 광고 이벤트를 처리하는 선택적 위임자입니다. |
onAdExpired
광고 만료 시 트리거되는 콜백 등록합니다.
공용 클래스 UADSRewardedAd: NSOobject { 공용 var onAdExpired: ((UnityAd) -> Void)?}
UADSShowConfiguration
UADSShowConfiguration공용 클래스 UADSShowConfiguration: NSOobject { @objc 공용 private(set) var view컨트롤러: UIViewController? @objc public private(set) var customRewardString: 문자열? @objc 공용 private(set) var extras: [문자열: 문자열]}
선택적 추가 파라미터가 있는 새 인스턴스를 생성합니다.
UADSShowConfiguration프로퍼티 | 설명 | 필수 |
|---|---|---|
| 광고를 표시하는 데 사용된 보기 컨트롤러입니다. | 지원 안 함 |
| 광고 노출에 대한 커스텀 보상 식별자입니다. | 아니요 |
|
광고를 표시할 때 포함할 추가 키-값 파라미터입니다. 기본값은 빈 사전입니다. | 아니요 |
UADSShowConfigurationBuilder
UADSShowConfigurationBuilderUADSShowConfiguration*init()
public init()
UADSShowConfigurationBuilder의 새 인스턴스 생성합니다.
with(viewController:)
public func with(viewController: UIViewController) -> 자체
광고를 표시할 뷰 컨트롤러 설정합니다.
파라미터 | 설명 |
|---|---|
| 광고를 표시하는 뷰 컨트롤러입니다. |
다음 반환: 업데이트된 UADSShowConfigurationBuilder 인스턴스.
with(customRewardString:)
public func with(customRewardString: 문자열) -> 자체
광고 노출에 대한 커스텀 보상 식별자 설정합니다.
파라미터 | 설명 |
|---|---|
| 광고 노출에 대한 고유 보상 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSShowConfigurationBuilderwith(extras:)
공용 함수(추가 사항: [문자열: 문자열]) -> 자체
광고를 표시할 때 추가 키-값 파라미터를 추가합니다.
파라미터 | 설명 |
|---|---|
| 광고 표시를 위한 커스텀 파라미터입니다. |
다음 반환: 업데이트된 인스턴스.
UADSShowConfigurationBuilderbuild()
공용 함수 빌드() -> UADSShowConfiguration
빌드하고 인스턴스를 반환합니다.
UADSShowConfiguration다음 반환: 의 인스턴스.
UADSShowConfigurationUADSShowOptions
UADSShowOptionsUADSTokenConfiguration
공용 클래스 UADSToken설정: NSOobject { @objc public private(set) var adFormat: UADSAdFormat @objc public private(set) var mediationInfo: UADSMediationInfo? @objc public private(set) var mediationAdUnitId: 문자열? @objc public private(set) var placementId: 문자열? @objc 공용 private(set) var bannerSize: CGSize? @objc 공용 private(set) var extras: [문자열: 문자열] = [:]}
UADSTokenConfiguration프로퍼티 | 설명 | 필수 |
|---|---|---|
| 토큰을 생성할 광고 형식의 유형입니다. | 예 |
| Mediation 통합에 대한 세부 정보를 지정합니다. | 아니요 |
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. | 아니요 |
| Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 아니요 |
| 토큰이 배너 광고를 요청한 경우 배너 광고의 크기입니다. | 아니요 |
| 커스텀 설정을 위한 추가 키-값 쌍. | 아니요 |
UADSTokenConfigurationBuilder
UADSTokenConfigurationBuilderUADSTokenConfigurationinit(adFormat:)
public init(adFormat: UADSAdFormat)
새 인스턴스를 만듭니다.
UADSTokenConfigurationBuilder파라미터 | 설명 |
|---|---|
| adFormat | 광고 유형(인터스티셜 광고, 보상형 광고, 배너)을 지정하는 UADSAdFormat의 인스턴스입니다. |
다음 반환: 의 인스턴스.
UADSTokenConfigurationBuilderwith(mediationInfo:)
public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 통합에 대한 세부 정보를 지정합니다.
파라미터 | 설명 |
|---|---|
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다. |
다음 반환: 업데이트된 인스턴스.
UADSTokenConfigurationBuilderwithMediationAdUnitId:_
public func with(mediationAdUnitId: 문자열) -> 자체
Mediation 광고 유닛 ID를 에 추가합니다.
UADSTokenConfiguration프로퍼티 | 설명 |
|---|---|
| Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSUADSTokenConfigurationBuilderwithPlacementId:_
public func with(placementId: 문자열) -> 자체
Unity 수익화 대시보드에 정의된 플레이스먼트 ID를 지정합니다.
파라미터 | 설명 |
|---|---|
| placementId | Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. |
다음 반환: 업데이트된 인스턴스.
UADSUADSTokenConfigurationBuilderwithBannerSize:_
public func with(bannerSize: CGSize) -> Self
토큰이 배너 광고를 요청한 경우 배너 광고의 크기를 지정합니다.
파라미터 | 설명 |
|---|---|
| bannerSize | 토큰이 배너 광고를 요청한 경우 배너 광고의 크기입니다. |
다음 반환: 업데이트된 인스턴스.
UADSUADSTokenConfigurationBuilderwith(extras:)
공용 함수(추가 사항: [문자열: 문자열]) -> 자체
커스텀 설정 대한 추가 키-값 쌍을 지정합니다.
파라미터 | 설명 |
|---|---|
| extras | 커스텀 설정을 위한 추가 키-값 페어입니다. |
다음 반환: 업데이트된 인스턴스.
UADSTokenConfigurationBuilderbuild()
공용 함수 빌드() -> UADSTokenConfiguration
빌드하고 인스턴스를 반환합니다.
UADSTokenConfiguration다음 반환: 의 인스턴스.
UADSTokenConfigurationUnityAds
UnityAds초기화
initialize(_, completion:)
지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 차단 호출됩니다.
공용 정적 기능 초기화(_ 설정: UADSInitializationConfiguration, 완료: @escaping(UnityAdsError?) -> Void)
파라미터 | 설명 |
|---|---|
| 설정 | SDK를 초기화하는 데 필요한 설정이 포함된 UADSInitializationConfiguration 오브젝트입니다. |
| 완료 | SDK 초기화가 완료되면 호출되는콜백입니다. 초기화에 실패하면 UnityAdsError를 반환합니다. |
GetToken
getToken(_, completion:)
제공된 에 따라 입찰 토큰을 가져와 완료 차단으로 전달합니다.
UADSTokenConfiguration공용 정적 기능 getToken(_ 설정: UADSTokenConfiguration, 완료: @escaping(String?) -> Void)
파라미터 | 설명 |
|---|---|
| 설정 | 광고 형식, Mediation 정보 및 기타 파라미터를 지정하는 |
| 완료 | 토큰이 성공적으로 페치되면 완료 차단을 호출하고 오류가 발생하면 null을 호출합니다. |
정적 변수
IsInitialized
Unity Ads SDK가 성공적으로 초기화되었는지 여부를 결정하는 부울 프로퍼티.
@objc public static func isInitialized() -> Bool
다음 반환: 인 경우 Unity Ads가 성공적으로 초기화되었습니다.
truegetVersion
현재 사용 중인 Unity Ads SDK 버전을 결정하는 문자열 프로퍼티.
public static func getVersion() -> String
다음 반환: 현재 설치된 Unity Ads SDK 버전입니다.
userIdentifier
앱의 각 사용자 대한 고유한 ID를 설정합니다.
공용 정적 var userIdentifier: 문자열
개인정보
setUserConsent()
맞춤형 광고에 대한 사용자 동의 옵션을 표시합니다.
public static func setUserConsent(_ consentGranted: 부울)
setUserOptOut()
사용자에게 데이터 컬렉션 및 맞춤형 광고를 거부할 수 있는 옵션을 제공합니다.
public static func setUserOptOut(_ optOut: 부울)
setNonBehavioral()
문맥(비맞춤형) 광고 표시를 활성화합니다.
공용 정적 기능 setNonBehavioral(_ nonBehavioral: 부울)
UnityAdsInitializationDelegate
UnityAdsInitializationDelegateUnityAdsLoadDelegate
UnityAdsLoadDelegateUnityAdsShowDelegate
UnityAdsShowDelegate열거형
UADSAdFormat
Unity Ads 지원하는 다양한 타입의 광고 형식을 정의합니다.
공용 열거형 UADSAdFormat: Int { case unspecified = 0, 인터스티셜 광고, 보상형 광고, 배너}
파라미터 | 설명 |
|---|---|
| 지정되지 않음 | 특정 광고 형식 없음. |
| interstitial | 앱의 자연스러운 일시 정지 시 표시되는 전체 화면 광고입니다. |
| 보상형 광고 | 완료 후 사용자에게 보상을 부여하는 광고입니다. |
| banner | 앱 레이아웃 내에 표시되는 직사각형 광고로, 일반적으로 화면 상단 또는 하단에 고정됩니다. |
UnityAdsAdFormat
UnityAdsAdFormatUADSLogLevel
Unity Ads 로깅 레벨을 정의합니다.
공용 열거형 UADSLogLevel: Int { 대소문자 비활성화, 오류, 정보, 디버그}
파라미터 | 설명 |
|---|---|
| 비활성화됨 | 로그 출력 없음. |
| error | initi/load/show 작업에서 중요한 오류와 오류만 기록합니다. |
| info | 주요 운영 이벤트(예: 초기화 시작/완료, 로드 시작/완료, 시작/완료 표시, 토큰 생성)를 기록합니다. |
| debug | 모든 정보와 네트워크 요청 및 내부 오류와 같은 상세한 내부 작업을 기록합니다. |
UADSShowFinishState
광고가 표시된 후의 종료 상태를 나타냅니다.
public enum UADSShowFinishState: Int { case skipped = 0, 완료}
파라미터 | 설명 |
|---|---|
| 건너뛰기 | 사용자가 광고가 끝나기 전에 광고를 닫거나 건너뛰었습니다. |
| 완료됨 | 광고는 끝까지 재생. |
프로토콜
UADSBannerAdDelegate
공용 프로토콜 UADSBannerAdDelegate: NSObjectProtocol { function bannerImpression(_ 배너: UADSBannerAd) func bannerDidClick(_ banner: UADSBannerAd) func bannerDidFailShow(_ banner: UADSBannerAd, 오류: UnityAdsError)}
메서드 | 설명 |
|---|---|
| 배너 광고가 성공적으로 표시되면 호출됩니다(노출 기록). |
| 사용자가 배너 광고를 클릭했을 때 호출됩니다. |
| 배너가 표시되지 않는 경우 호출되며, 장애를 설명하는 |
UADSInterstitialShowDelegate
공용 프로토콜 UADSInterstitialShowDelegate: NSObjectProtocol { func showDidStart(_ unityAd): UADSInterstitialAd) func showDidClick(_ unityAd: UADSInterstitialAd) func showDidComplete(_ unityAd: 상태가 포함된 UADSInterstitialAd: UADSShowFinishState) func showDidFailed(_ unityAd): UADSInterstitialAd, 오류: UnityAdsError)}
메서드 | 설명 |
|---|---|
| 인터스티셜 광고 노출에 호출됩니다. |
| 인터스티셜 광고를 클릭했을 때 호출됩니다. |
|
광고 표시가 종료되면 호출됩니다. |
| 광고가 표시되지 않으면 호출되며, 실패를 설명하는 |
UADSRewardedShowDelegate
공용 프로토콜 UADSRewardedShowDelegate: NSObjectProtocol { func showDidStart(_ unityAd): UADSRewardedAd) func showDidClick(_ unityAd: UADSRewardedAd) func showDidComplete(_ unityAd: UADSRewardedAd, 상태: UADSShowFinishState) func showDidFailed(_ unityAd): UADSRewardedAd, 오류: UnityAdsError) func showDidReceiveReward(_ unityAd): UADSRewardedAd)}
메서드 | 설명 |
|---|---|
| 보상형 광고 노출 시 호출됩니다. |
| 보상형 광고가 클릭되면 호출됩니다. |
|
광고 표시가 종료되면 호출됩니다. |
| 광고가 표시되지 않으면 호출되며, 실패를 설명하는 |
| 유저가 광고에서 보상을 얻을 때 호출됩니다. |
UnityAdsError
공용 프로토콜 UnityAdsError { var 코드: Int { get } var 메시지: 문자열 { get }}
파라미터 | 설명 |
|---|---|
| code | Unity Ads 오류 유형을 식별하는 숫자 오류 코드입니다. |
| 메시지 | 오류에 대한 추가 세부 정보를 제공하는 오류 메시지입니다. |
UADSBannerErrorCode
UADSBannerErrorCodeUnityAdsInitializationError
UnityAdsInitializationErrorUnityAdsLoadError
UnityAdsLoadErrorUnityAdsShowError
UnityAdsShowError