기술 자료

Unity Ads Monetization


iOS API 레퍼런스 - Swift

iOS API 레퍼런스 - Objective-C

Unity Ads Monetization


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

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

load(:완료)

공용 클래스 UADSBannerAd: NSOobject { 공용 정적 기능 로드(_ 설정: UADSBannerLoadConfiguration, 완료: @escaping(UADSBannerAd?, UnityAdsError?) -> Void)}
지정된 설정 배너 광고를 로드합니다.
배너가 로드될 때 호출되는

파라미터

설명

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

onAdExpired

공용 var onAdExpired: ((UADSBannerAd) -> Void)?
광고 만료 시 트리거되는 콜백. 로드된 배너 광고가 만료되고 더 이상 유효하지 않으면 이 프로퍼티 알림을 받도록 설정합니다.

뷰

공용 클래스 UADSBannerAd: UIView { 공용 var view: UIView}
배너 광고 인스턴스 대한 액세스, 접근 제공하는 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, 배너 크기, 선택적 광고 마크업, 선택적 위임자 및 추가 파라미터 지정이 포함됩니다.
공용 클래스 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: [문자열: 문자열]}
배너 광고의

프로퍼티

설명

필수

placementId
Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.예
adMarkup
입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다.아니요
bannerSize
크기입니다. 예
delegate
배너 광고 이벤트를 처리합니다.예
mediationAdUnitId
Mediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다.아니요
mediationInfo
Mediation 통합에 대한 세부 정보를 지정합니다.아니요
extras
추가 커스텀 키-값 페어.아니요

UADSBannerLoadConfigurationBuilder

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

init(placementId, bannerSize, delegate)

public init(placementId: 문자열 bannerSize: CGSize, delegate: UADSBannerAdDelegate)
새
UADSBannerLoadConfigurationBuilder
인스턴스를 만듭니다.
배너 광고의

프로퍼티

설명

필수

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

with(adMarkup:)_

public func with(adMarkup: 문자열) -> 자체
UADSBannerLoadConfigurationBuilder
에 adMarkup을 추가합니다.

파라미터

설명

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

with(mediationAdUnitId:)_

public func with(mediationAdUnitId: 문자열) -> 자체
Mediation 광고 유닛 ID를
UADSBannerLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

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

with(mediationInfo:)_

public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 정보를
UADSBannerLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

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

with(extras:)_

공용 함수(추가 사항: [문자열: 문자열]) -> 자체
추가 키-값 파라미터를
UADSBannerLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

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

build()_

공용 함수 빌드() -> UADSBannerLoadConfiguration
빌드하고
UADSBannerLoadConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSBannerLoadConfiguration
의 인스턴스.

UADSBannerLoadOptions

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

UADSInitializationConfiguration

공용 클래스 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 SDK를 초기화하는 데 필요한 앱에 대한 필수 정보로 구성된 오브젝트를 생성합니다.
테스트 모드를 활성화하는
로그 출력의 디테일 수준(LOD)을

프로퍼티

설명

필수

gameId
Unity Ads 수익화 대시보드의 고유 게임 식별자입니다.예
isTestModeEnabled
부울입니다. true인 경우 테스트 광고만 표시됩니다. 기본값은 false입니다. 아니요
logLevel
지정합니다. 기본값은 INFO입니다. 아니요
mediationInfo
Mediation 통합에 대한 정보를 포함하는 오브젝트입니다.아니요
extras
커스텀 구성을 위한 추가 키-값 파라미터의 맵입니다.아니요

UADSInitializationConfigurationBuilder

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

Initialize

공용 정적 기능 초기화(_ 설정: UADSInitializationConfiguration, 완료: @escaping(UnityAdsError?) -> Void)
지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 핸들러 호출됩니다.

파라미터

설명

설정SDK를 초기화하는 데 필요한 설정을 포함하는 UADSInitializationConfiguration 오브젝트입니다.
완료완료 시 완료 콜백이 호출되며 오류 메시지와 오류 코드로 실패가 성공했는지 또는 실패 원인을 상세하게 표시합니다.

init(gameId:)_

public init(gameId: 문자열)
새
UADSInitializationConfigurationBuilder
인스턴스를 만듭니다.

파라미터

설명

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

with(testMode:)_

public func with(testMode: 부울) -> 자체
테스트 모드를 설정합니다.

파라미터

설명

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

with(logLevel:)_

공용 함수(logLevel): UADSLogLevel) -> Self
로그에 포함된 디테일의 양을 정의하는 로그 레벨을 설정합니다(없음에서 전체 디버그 정보).

파라미터

설명

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

with(mediationInfo:)_

public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 정보를 설정합니다. 여기에는 Mediation 이름, 버전, 어댑터 버전 등 앱의 Mediation 통합에 대한 세부 정보가 포함됩니다.

파라미터

설명

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

with(extras:)_

공용 함수(추가 사항: [문자열: 문자열]) -> 자체
추가 파라미터를 설정합니다.

파라미터

설명

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

build()

공용 함수 빌드() -> UADSInitializationConfiguration
빌드하고
UADSInitializationConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSInitializationConfiguration
의 인스턴스.

UADSInterstitialAd

UADSInterstitialAd
클래스는 전체 화면 인터스티셜 광고의 로딩 및 표시를 관리합니다.

load(:완료)

공용 클래스 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
클래스는 Unity Ads 로드에 필요한 옵션을 캡슐화합니다. 여기에는 플레이스먼트 ID, 선택적 광고 마크업, 추가 파라미터 지정이 포함됩니다.
공용 클래스 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
인스턴스를 만듭니다.
입찰을 통해 광고를 로드할 때 사용되는

프로퍼티

설명

필수

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

UADSLoadConfigurationBuilder

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

init(placementId:)

public init(placementId: 문자열)
새
UADSLoadConfigurationBuilder
인스턴스를 만듭니다.

파라미터

설명

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

with(adMarkup:)_

public func with(adMarkup: 문자열) -> 자체
UADSLoadConfigurationBuilder
에 adMarkup을 추가합니다.
입찰을 통해 광고를 로드할 때 사용되는

파라미터

설명

adMarkup광고 마크업 데이터입니다. Null이면 광고 요청이 워터폴을 사용합니다.
다음 반환: 업데이트된
UADSLoadConfigurationBuilder
인스턴스.

with(mediationAdUnitId:)_

public func with(mediationAdUnitId: 문자열) -> 자체
Mediation 광고 유닛 ID를
UADSLoadConfigurationBuilder
에 추가합니다.

프로퍼티

설명

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

with(mediationInfo:)_

public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 정보를
UADSLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

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

with(extras:)_

공용 함수(추가 사항: [문자열: 문자열]) -> 자체
추가 설정 키-값 쌍을
UADSLoadConfigurationBuilder
에 추가합니다.

파라미터

설명

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

build()

공용 함수 빌드() -> UADSLoadConfiguration
빌드하고
UADSLoadConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSLoadConfiguration
의 인스턴스.

UADSLoadOptions

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

UADSMediationInfo

Mediation 통합에 대한 세부 정보를 지정합니다.
공용 클래스 UADSMediationInfo: NSOobject { public init(name: 문자열, 버전: 문자열, 어댑터버전: 문자열)}

파라미터

설명

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

UADSMediationMetaData

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

개인정보

개인정보 보호는 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

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

UADSRewardedAd

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

load(_: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
클래스는 Unity Ads를 표시할 때 키-값 페어 형태로 전달할 추가 파라미터를 지정합니다.
공용 클래스 UADSShowConfiguration: NSOobject { @objc 공용 private(set) var view컨트롤러: UIViewController? @objc public private(set) var customRewardString: 문자열? @objc 공용 private(set) var extras: [문자열: 문자열]}
선택적 추가 파라미터가 있는 새
UADSShowConfiguration
인스턴스를 생성합니다.
광고를 표시할 때 포함할

프로퍼티

설명

필수

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

UADSShowConfigurationBuilder

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

*init()

public init()
UADSShowConfigurationBuilder의 새 인스턴스 생성합니다.

with(viewController:)

public func with(viewController: UIViewController) -> 자체
광고를 표시할 뷰 컨트롤러 설정합니다.

파라미터

설명

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

with(customRewardString:)

public func with(customRewardString: 문자열) -> 자체
광고 노출에 대한 커스텀 보상 식별자 설정합니다.

파라미터

설명

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

with(extras:)

공용 함수(추가 사항: [문자열: 문자열]) -> 자체
광고를 표시할 때 추가 키-값 파라미터를 추가합니다.

파라미터

설명

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

build()

공용 함수 빌드() -> UADSShowConfiguration
빌드하고
UADSShowConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSShowConfiguration
의 인스턴스.

UADSShowOptions

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

UADSTokenConfiguration

공용 클래스 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
클래스는 입찰 토큰을 얻기 위해 필요한 필수 정보로 구성된 오브젝트를 만듭니다.

프로퍼티

설명

필수

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

UADSTokenConfigurationBuilder

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

init(adFormat:)

public init(adFormat: UADSAdFormat)
새
UADSTokenConfigurationBuilder
인스턴스를 만듭니다.

파라미터

설명

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

with(mediationInfo:)

public func with(mediationInfo: UADSMediationInfo) -> Self
Mediation 통합에 대한 세부 정보를 지정합니다.

파라미터

설명

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

withMediationAdUnitId:_

public func with(mediationAdUnitId: 문자열) -> 자체
Mediation 광고 유닛 ID를
UADSTokenConfiguration
에 추가합니다.

프로퍼티

설명

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

withPlacementId:_

public func with(placementId: 문자열) -> 자체
Unity 수익화 대시보드에 정의된 플레이스먼트 ID를 지정합니다.

파라미터

설명

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

withBannerSize:_

public func with(bannerSize: CGSize) -> Self
토큰이 배너 광고를 요청한 경우 배너 광고의 크기를 지정합니다.

파라미터

설명

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

with(extras:)

공용 함수(추가 사항: [문자열: 문자열]) -> 자체
커스텀 설정 대한 추가 키-값 쌍을 지정합니다.

파라미터

설명

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

build()

공용 함수 빌드() -> UADSTokenConfiguration
빌드하고
UADSTokenConfiguration
인스턴스를 반환합니다.
다음 반환:
UADSTokenConfiguration
의 인스턴스.

UnityAds

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

초기화

initialize(_, completion:)

지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 차단 호출됩니다.
공용 정적 기능 초기화(_ 설정: UADSInitializationConfiguration, 완료: @escaping(UnityAdsError?) -> Void)
SDK 초기화가 완료되면 호출되는

파라미터

설명

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

GetToken

getToken(_, completion:)

제공된
UADSTokenConfiguration
에 따라 입찰 토큰을 가져와 완료 차단으로 전달합니다.
공용 정적 기능 getToken(_ 설정: UADSTokenConfiguration, 완료: @escaping(String?) -> Void)

파라미터

설명

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

정적 변수

IsInitialized

Unity Ads SDK가 성공적으로 초기화되었는지 여부를 결정하는 부울 프로퍼티.
@objc public static func isInitialized() -> Bool
다음 반환:
true
인 경우 Unity Ads가 성공적으로 초기화되었습니다.

getVersion

현재 사용 중인 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

경고
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 지원하는 다양한 타입의 광고 형식을 정의합니다.
공용 열거형 UADSAdFormat: Int { case unspecified = 0, 인터스티셜 광고, 보상형 광고, 배너}

파라미터

설명

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

UnityAdsAdFormat

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

UADSLogLevel

Unity Ads 로깅 레벨을 정의합니다.
공용 열거형 UADSLogLevel: Int { 대소문자 비활성화, 오류, 정보, 디버그}

파라미터

설명

비활성화됨로그 출력 없음.
erroriniti/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)}

메서드

설명

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

UADSInterstitialShowDelegate

공용 프로토콜 UADSInterstitialShowDelegate: NSObjectProtocol { func showDidStart(_ unityAd): UADSInterstitialAd) func showDidClick(_ unityAd: UADSInterstitialAd) func showDidComplete(_ unityAd: 상태가 포함된 UADSInterstitialAd: UADSShowFinishState) func showDidFailed(_ unityAd): UADSInterstitialAd, 오류: UnityAdsError)}
광고 표시가 종료되면

메서드

설명

showDidStart(_:)
인터스티셜 광고 노출에 호출됩니다.
showDidClick(_:)
인터스티셜 광고를 클릭했을 때 호출됩니다.
showDidComplete(_:with:)
호출됩니다.
UADSShowFinishState
(
skipped
또는
completed
)를 제공합니다.
showDidFailed(_:error:)
광고가 표시되지 않으면 호출되며, 실패를 설명하는
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)}
광고 표시가 종료되면

메서드

설명

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

UnityAdsError

공용 프로토콜 UnityAdsError { var 코드: Int { get } var 메시지: 문자열 { get }}

파라미터

설명

codeUnity Ads 오류 유형을 식별하는 숫자 오류 코드입니다.
메시지오류에 대한 추가 세부 정보를 제공하는 오류 메시지입니다.

UADSBannerErrorCode

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

UnityAdsInitializationError

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

UnityAdsLoadError

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

UnityAdsShowError

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