# Unity Ads iOS SDK API 레퍼런스 - Swift

> Unity Ads SDK 공용 API 레퍼런스에 액세스하여 Swift에서 iOS 앱의 광고 동작을 연동하고 제어하는 데 사용할 수 있는 클래스, 메서드 및 프로퍼티를 확인합니다.

Unity Unity AdsUnity Ads Android SDK API 이 레퍼런스 사용합니다.

이 API를 사용하기 전에 앱에서 수익화를 활성화할 수 있도록 `UnityAds` 라이브러리를 임포트했는지 확인합니다. 자세한 내용은 [UnityAds 라이브러리 임포트](/ads-ios/4.19.0/sdk-integration/import-library.md)를 참조하십시오.

## 클래스##classes

### UADSBannerAd##uadsbannerad

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

### load(*:완료)##load(*:completion)

1. **Swift**

   ```swift
   공용 클래스 UADSBannerAd: NSOobject {
       공용 정적 기능 로드(_ 설정: UADSBannerLoadConfiguration,
                                 완료: @escaping(UADSBannerAd?, UnityAdsError?) -> Void)
   }
   ```

지정된 설정 배너 광고를 로드합니다.

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

### onAdExpired##onadexpired

1. **Swift**

   ```swift
   공용 var onAdExpired: ((UADSBannerAd) -> Void)?
   ```

광고 만료 시 트리거되는 콜백. 로드된 배너 광고가 만료되고 더 이상 유효하지 않으면 이 프로퍼티 알림을 받도록 설정합니다.

### 뷰##view

1. **Swift**

   ```swift
   공용 클래스 UADSBannerAd: UIView {
       공용 var view: UIView
   }
   ```

배너 광고 인스턴스 대한 액세스, 접근 제공하는 view 프로퍼티. 이 프로퍼티 사용하여 앱의 기존 뷰 계층 구조 구조 내에서 원하는 위치에 배너 광고를 삽입합니다.

### UADSBannerView##uadsbannerview

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 [`UADSBannerAd`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsbannerad)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSBannerView`는 배너 광고를 로드하고 표시하기 위한 이전 클래스입니다.

### UADSBannerViewDelegate##uadsbannerviewdelegate

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 [`UADSBannerAdDelegate`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsbanneraddelegate)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSBannerViewDelegate`는 배너 광고 이벤트를 처리하기 위한 이전의 위임자 프로토콜입니다.

## UADSBannerLoadConfiguration##uadsbannerloadconfiguration

`UADSBannerLoadConfiguration` 클래스는 배너 광고를 로드하는 데 필요한 옵션을 캡슐화합니다. 여기에는 플레이스먼트 ID, 배너 크기, 선택적 광고 마크업, 선택적 위임자 및 추가 파라미터 지정이 포함됩니다.

1. **Swift**

   ```swift
   공용 클래스 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

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

### init(placementId, bannerSize, delegate)##init(placementid-bannersize-delegate)

1. **Swift**

   ```swift
   public init(placementId: 문자열
               bannerSize: CGSize,
               delegate: UADSBannerAdDelegate)
   ```

새 `UADSBannerLoadConfigurationBuilder` 인스턴스를 만듭니다.

| **프로퍼티**      | **설명**                            | **필수** |
| ------------- | --------------------------------- | ------ |
| `placementId` | Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. | 예      |
| `bannerSize`  | 크기입니다.                            | 예      |
| `delegate`    | 배너 광고 이벤트를 처리합니다.                 | 예      |

**다음 반환**: `UADSBannerLoadConfigurationBuilder`의 인스턴스.

### with(adMarkup:)\_##with(admarkup:)\_

1. **Swift**

   ```swift
   public func with(adMarkup: 문자열) -> 자체
   ```

`UADSBannerLoadConfigurationBuilder`에 adMarkup을 추가합니다.

| **파라미터** | **설명**                               |
| -------- | ------------------------------------ |
| adMarkup | 입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다. |

**다음 반환**: 업데이트된 `UADSBannerLoadConfigurationBuilder` 인스턴스.

### with(mediationAdUnitId:)\_##with(mediationadunitid:)\_

1. **Swift**

   ```swift
   public func with(mediationAdUnitId: 문자열) -> 자체
   ```

Mediation 광고 유닛 ID를 `UADSBannerLoadConfigurationBuilder`에 추가합니다.

| **파라미터**          | **설명**                                         |
| ----------------- | ---------------------------------------------- |
| mediationAdUnitId | Mediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다. |

**다음 반환**: 업데이트된 `UADSBannerLoadConfigurationBuilder` 인스턴스.

### with(mediationInfo:)\_##with(mediationinfo:)\_

1. **Swift**

   ```swift
   public func with(mediationInfo: UADSMediationInfo) -> Self
   ```

Mediation 정보를 `UADSBannerLoadConfigurationBuilder`에 추가합니다.

| **파라미터**      | **설명**                                 |
| ------------- | -------------------------------------- |
| mediationInfo | Mediation 통합에 대한 세부 정보(이름, 버전, 어댑터 버전) |

**다음 반환**: 업데이트된 `UADSBannerLoadConfigurationBuilder` 인스턴스.

### with(extras:)\_##with(extras:)\_

1. **Swift**

   ```swift
   공용 함수(추가 사항: [문자열: 문자열]) -> 자체
   ```

추가 키-값 파라미터를 `UADSBannerLoadConfigurationBuilder`에 추가합니다.

| **파라미터** | **설명**              |
| -------- | ------------------- |
| extras   | 배너 로딩을 위한 커스텀 파라미터. |

**다음 반환**: 업데이트된 UADSBannerLoadConfigurationBuilder 인스턴스.

### build()\_##build()\_

1. **Swift**

   ```swift
   공용 함수 빌드() -> UADSBannerLoadConfiguration
   ```

빌드하고 `UADSBannerLoadConfiguration` 인스턴스를 반환합니다.

**다음 반환**: `UADSBannerLoadConfiguration`의 인스턴스.

### UADSBannerLoadOptions##uadsbannerloadoptions

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신에 [`UADSBannerLoadConfiguration`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsbannerloadconfiguration) 및 [`UADSBannerLoadConfigurationBuilder`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsbannerloadconfigurationbuilder)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSBannerLoadOptions`는 배너 로드 옵션을 지정하기 위한 이전 클래스입니다.

## UADSInitializationConfiguration##uadsinitializationconfiguration

1. **Swift**

   ```swift
   공용 클래스 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를 초기화하는 데 필요한 앱에 대한 필수 정보로 구성된 오브젝트를 생성합니다.

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

## UADSInitializationConfigurationBuilder##uadsinitializationconfigurationbuilder

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

### Initialize##initialize

1. **Swift**

   ```swift
   공용 정적 기능 초기화(_ 설정: UADSInitializationConfiguration,
                                 완료: @escaping(UnityAdsError?) -> Void)
   ```

지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 핸들러 호출됩니다.

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

### init(gameId:)\_##init(gameid:)\_

1. **Swift**

   ```swift
   public init(gameId: 문자열)
   ```

새 `UADSInitializationConfigurationBuilder` 인스턴스를 만듭니다.

| **파라미터** | **설명**                                            |
| -------- | ------------------------------------------------- |
| gameId   | Unity Ads 관리 툴 또는 Unity 에디터에서 제공하는 게임의 고유 식별자입니다. |

**다음 반환**: `UADSInitializationConfigurationBuilder`의 인스턴스.

### with(testMode:)\_##with(testmode:)\_

1. **Swift**

   ```swift
   public func with(testMode: 부울) -> 자체
   ```

테스트 모드를 설정합니다.

| **파라미터** | **설명**                                           |
| -------- | ------------------------------------------------ |
| testMode | 테스트 모드를 표시하고 테스트 광고만 표시하려면 이 플래그를 `true`로 설정합니다. |

**다음 반환**: 업데이트된 `UADSInitializationConfigurationBuilder` 인스턴스.

### with(logLevel:)\_##with(loglevel:)\_

1. **Swift**

   ```swift
   공용 함수(logLevel): UADSLogLevel) -> Self
   ```

로그에 포함된 디테일의 양을 정의하는 로그 레벨을 설정합니다(없음에서 전체 디버그 정보).

| **파라미터**                  | **설명**                |
| ------------------------- | --------------------- |
| [logLevel](#uadsloglevel) | 로그 출력의 디테일 수준을 지정합니다. |

**다음 반환**: 업데이트된 `UADSInitializationConfigurationBuilder` 인스턴스.

### with(mediationInfo:)\_##with(mediationinfo:)\_

1. **Swift**

   ```swift
   public func with(mediationInfo: UADSMediationInfo) -> Self
   ```

Mediation 정보를 설정합니다. 여기에는 Mediation 이름, 버전, 어댑터 버전 등 앱의 Mediation 통합에 대한 세부 정보가 포함됩니다.

| **파라미터**      | **설명**                         |
| ------------- | ------------------------------ |
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다. |

**다음 반환**: 업데이트된 `UADSInitializationConfigurationBuilder` 인스턴스.

### with(extras:)\_##with(extras:)\_

1. **Swift**

   ```swift
   공용 함수(추가 사항: [문자열: 문자열]) -> 자체
   ```

추가 파라미터를 설정합니다.

| **파라미터** | **설명**                   |
| -------- | ------------------------ |
| extras   | 커스텀 설정을 위한 추가 키-값 페어입니다. |

**다음 반환**: 업데이트된 `UADSInitializationConfigurationBuilder` 인스턴스.

### build()##build()

1. **Swift**

   ```swift
   공용 함수 빌드() -> UADSInitializationConfiguration
   ```

빌드하고 `UADSInitializationConfiguration` 인스턴스를 반환합니다.

**다음 반환**: `UADSInitializationConfiguration`의 인스턴스.

## UADSInterstitialAd##uadsinterstitialad

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

### load(*:완료)##load(*:completion)

1. **Swift**

   ```swift
   공용 클래스 UADSInterstitialAd: NSOobject {
       공용 정적 기능 로드(_ 설정: UADSLoadConfiguration,
                                 완료: @escaping(UADSInterstitialAd?, UnityAdsError?) -> Void)
   }
   ```

지정된 설정 인터스티셜 광고 광고를 로드합니다.

| **파라미터** | **설명**                                                              |
| -------- | ------------------------------------------------------------------- |
| 설정       | 광고 로딩 옵션이 포함된 UADSLoadConfiguration 인스턴스입니다.                        |
| 완료       | 콜백입니다. 성공하면 UADSInterstitialAd 인스턴스, 로드에 실패하면 UnityAdsError를 반환합니다. |

### show(\_:delegate:)##show(\_:delegate:)

1. **Swift**

   ```swift
   공용 클래스 UADSInterstitialAd: NSOobject {
       공용 function show(_ 설정: UADSShowConfiguration? = null,
                          delegate: UADSInterstitialShowDelegate)
   }
   ```

로드된 인터스티셜 광고 광고를 표시합니다.

| **파라미터** | **설명**                                                       |
| -------- | ------------------------------------------------------------ |
| 설정       | 광고 표시를 위한 선택적 설정입니다.                                         |
| delegate | 광고 이벤트를 처리하기 위해 UADSInterstitialShowDelegate를 준수하는 델리게이트입니다. |

### onAdExpired##onadexpired

광고 만료 시 트리거되는 콜백 등록합니다.

1. **Swift**

   ```swift
   공용 클래스 UADSInterstitialAd: NSOobject {
       공용 var onAdExpired: ((UnityAd) -> Void)?
   }
   ```

## UADSLoadConfiguration##uadsloadconfiguration

`UADSLoadConfiguration` 클래스는 Unity Ads 로드에 필요한 옵션을 캡슐화합니다. 여기에는 플레이스먼트 ID, 선택적 광고 마크업, 추가 파라미터 지정이 포함됩니다.

1. **Swift**

   ```swift
   공용 클래스 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

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

### init(placementId:)##init(placementid:)

1. **Swift**

   ```swift
   public init(placementId: 문자열)
   ```

새 `UADSLoadConfigurationBuilder` 인스턴스를 만듭니다.

| **파라미터**      | **설명**                            |
| ------------- | --------------------------------- |
| `placementId` | Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. |

**다음 반환**: `UADSLoadConfigurationBuilder`의 인스턴스.

### with(adMarkup:)\_##with(admarkup:)\_

1. **Swift**

   ```swift
   public func with(adMarkup: 문자열) -> 자체
   ```

`UADSLoadConfigurationBuilder`에 adMarkup을 추가합니다.

| **파라미터** | **설명**                                   |
| -------- | ---------------------------------------- |
| adMarkup | 광고 마크업 데이터입니다. Null이면 광고 요청이 워터폴을 사용합니다. |

**다음 반환**: 업데이트된 `UADSLoadConfigurationBuilder` 인스턴스.

### with(mediationAdUnitId:)\_##with(mediationadunitid:)\_

1. **Swift**

   ```swift
   public func with(mediationAdUnitId: 문자열) -> 자체
   ```

Mediation 광고 유닛 ID를 `UADSLoadConfigurationBuilder`에 추가합니다.

| **프로퍼티**            | **설명**                                 |
| ------------------- | -------------------------------------- |
| `mediationAdUnitId` | Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. |

**다음 반환**: 업데이트된 `UADSLoadConfigurationBuilder` 인스턴스.

### with(mediationInfo:)\_##with(mediationinfo:)\_

1. **Swift**

   ```swift
   public func with(mediationInfo: UADSMediationInfo) -> Self
   ```

Mediation 정보를 `UADSLoadConfigurationBuilder`에 추가합니다.

| **파라미터**      | **설명**                                         |
| ------------- | ---------------------------------------------- |
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다(이름, 버전, 어댑터 버전). |

**다음 반환**: 업데이트된 `UADSLoadConfigurationBuilder` 인스턴스.

### with(extras:)\_##with(extras:)\_

1. **Swift**

   ```swift
   공용 함수(추가 사항: [문자열: 문자열]) -> 자체
   ```

추가 설정 키-값 쌍을 `UADSLoadConfigurationBuilder`에 추가합니다.

| **파라미터** | **설명**                  |
| -------- | ----------------------- |
| extras   | 광고 로딩을 위한 커스텀 파라미터의 사전. |

**다음 반환**: 업데이트된 `UADSLoadConfigurationBuilder` 인스턴스.

### build()##build()

1. **Swift**

   ```swift
   공용 함수 빌드() -> UADSLoadConfiguration
   ```

빌드하고 `UADSLoadConfiguration` 인스턴스를 반환합니다.

**다음 반환**: `UADSLoadConfiguration`의 인스턴스.

### UADSLoadOptions##uadsloadoptions

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 [`UADSLoadConfigurationBuilder`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsloadconfigurationbuilder)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSLoadOptions`는 광고 로드 옵션을 지정하기 위한 이전 클래스입니다.

## UADSMediationInfo##uadsmediationinfo

Mediation 통합에 대한 세부 정보를 지정합니다.

1. **Swift**

   ```swift
   공용 클래스 UADSMediationInfo: NSOobject {
       public init(name: 문자열, 버전: 문자열, 어댑터버전: 문자열)
   }
   ```

| **파라미터**       | **설명**                                 |
| -------------- | -------------------------------------- |
| name           | 앱에 통합된 Mediation 플랫폼의 이름입니다.           |
| 버전             | 앱에 통합된 Mediation SDK 버전입니다.            |
| adapterVersion | Mediation 파트너를 위한 Unity Ads 어댑터 버전입니다. |

**다음 반환**: `UADSMediationInfo`의 인스턴스.

### UADSMediationMetaData##uadsmediationmetadata

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 [`UADSMediationInfo`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsmediationinfo)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSMediationMetaData`는 Mediation 파트너 정보를 전달하기 위한 이전 클래스입니다.

## 개인정보##privacy

개인정보 보호는 Unity Ads 개인정보 보호 설정과 사용자 동의를 관리하기 위한 API를 제공하는 열거형 집합과 클래스. 이를 통해 개발자는 다양한 개인정보 보호 설정과 GDPR, PIPL 및 기타 규정을 준수하는 동의를 처리할 수 있습니다.

1. **Swift**

   ```swift
   공용 클래스 개인정보 보호: NSOobject {
       public static func set(privacy: PrivacyFlag, 값: PrivacyValue) {}
       공용 정적 기능 세트(동의: PrivacyConsent, 값: PrivacyConsentValue) {}
       // 새 플래그를 설정하려면 기존 플래그를 작성할 경우 예외를 발생시킵니다.
       public static func setPrivacy(_ flag: 문자열, 동의: PrivacyConsentValue) throws {}
       public static func setPrivacy(_ flag: 문자열, 값: PrivacyValue)는 {}를 발생시킵니다.
   }
   ```

### UADSMetaData##uadsmetadata

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> [`UnityAds`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#unityads)(`setUserConsent()`, `setUserOptOut()`, `setNonBehavioral()`)에 입력된 개인정보 보호 방법을 사용합니다. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSMetaData`는 GDPR 및 기타 개인정보 보호 관련 플래그를 설정하기 위한 이전 클래스입니다.

## UADSRewardedAd##uadsrewardedad

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

### load(\_:completion)\_##load(*:completion)*

1. **Swift**

   ```swift
   공용 클래스 UADSRewardedAd: NSOobject {
       공용 정적 기능 로드(_ 설정: UADSLoadConfiguration,
                                 완료: @escaping(UADSRewardedAd?, UnityAdsError?) -> Void)
   }
   ```

지정된 옵션으로 보상형 광고 광고를 로드합니다.

| **파라미터** | **설명**                                                 |
| -------- | ------------------------------------------------------ |
| 설정       | 광고 로딩 옵션이 포함된 UADSLoadConfiguration 인스턴스입니다.           |
| 완료       | 콜백입니다. 성공하면 UADSRewardedAd 인스턴스 또는 로드에 실패하면 오류를 반환합니다. |

### show(\_:delegate:)##show(\_:delegate:)

1. **Swift**

   ```swift
   공용 클래스 UADSRewardedAd: NSOobject {
       공용 function show(_ 설정: UADSShowConfiguration? = null,
                          delegate: UADSRewardedShowDelegate)
   }
   ```

로드된 보상형 광고 광고를 표시합니다.

| **파라미터** | **설명**                       |
| -------- | ---------------------------- |
| 설정       | 광고 표시를 위한 선택적 설정입니다.         |
| delegate | 보상형 광고 이벤트를 처리하는 선택적 위임자입니다. |

### onAdExpired##onadexpired

광고 만료 시 트리거되는 콜백 등록합니다.

1. **Swift**

   ```swift
   공용 클래스 UADSRewardedAd: NSOobject {
       공용 var onAdExpired: ((UnityAd) -> Void)?
   }
   ```

## UADSShowConfiguration##uadsshowconfiguration

`UADSShowConfiguration` 클래스는 Unity Ads를 표시할 때 키-값 페어 형태로 전달할 추가 파라미터를 지정합니다.

1. **Swift**

   ```swift
   공용 클래스 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

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

### \*init()##\*init()

1. **Swift**

   ```swift
   public init()
   ```

UADSShowConfigurationBuilder의 새 인스턴스 생성합니다.

### with(viewController:)##with(viewcontroller:)

1. **Swift**

   ```swift
   public func with(viewController: UIViewController) -> 자체
   ```

광고를 표시할 뷰 컨트롤러 설정합니다.

| **파라미터**         | **설명**              |
| ---------------- | ------------------- |
| `viewController` | 광고를 표시하는 뷰 컨트롤러입니다. |

**다음 반환**: 업데이트된 UADSShowConfigurationBuilder 인스턴스.

### with(customRewardString:)##with(customrewardstring:)

1. **Swift**

   ```swift
   public func with(customRewardString: 문자열) -> 자체
   ```

광고 노출에 대한 커스텀 보상 식별자 설정합니다.

| **파라미터**             | **설명**                 |
| -------------------- | ---------------------- |
| `customRewardString` | 광고 노출에 대한 고유 보상 ID입니다. |

**다음 반환**: 업데이트된 `UADSShowConfigurationBuilder` 인스턴스.

### with(extras:)##with(extras:)

1. **Swift**

   ```swift
   공용 함수(추가 사항: [문자열: 문자열]) -> 자체
   ```

광고를 표시할 때 추가 키-값 파라미터를 추가합니다.

| **파라미터** | **설명**                 |
| -------- | ---------------------- |
| `extras` | 광고 표시를 위한 커스텀 파라미터입니다. |

**다음 반환**: 업데이트된 `UADSShowConfigurationBuilder` 인스턴스.

### build()##build()

1. **Swift**

   ```swift
   공용 함수 빌드() -> UADSShowConfiguration
   ```

빌드하고 `UADSShowConfiguration` 인스턴스를 반환합니다.

**다음 반환**: `UADSShowConfiguration`의 인스턴스.

### UADSShowOptions##uadsshowoptions

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 [`UADSShowConfigurationBuilder`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsshowconfigurationbuilder)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSShowOptions`는 광고 표시 옵션을 지정하기 위한 이전 클래스입니다.

## UADSTokenConfiguration##uadstokenconfiguration

1. **Swift**

   ```swift
   공용 클래스 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

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

### init(adFormat:)##init(adformat:)

1. **Swift**

   ```swift
   public init(adFormat: UADSAdFormat)
   ```

새 `UADSTokenConfigurationBuilder` 인스턴스를 만듭니다.

| **파라미터** | **설명**                                                   |
| -------- | -------------------------------------------------------- |
| adFormat | 광고 유형(인터스티셜 광고, 보상형 광고, 배너)을 지정하는 UADSAdFormat의 인스턴스입니다. |

**다음 반환**: `UADSTokenConfigurationBuilder`의 인스턴스.

#### with(mediationInfo:)##with(mediationinfo:)

1. **Swift**

   ```swift
   public func with(mediationInfo: UADSMediationInfo) -> Self
   ```

Mediation 통합에 대한 세부 정보를 지정합니다.

| **파라미터**      | **설명**                         |
| ------------- | ------------------------------ |
| mediationInfo | Mediation 통합에 대한 세부 정보를 지정합니다. |

**다음 반환**: 업데이트된 `UADSTokenConfigurationBuilder` 인스턴스.

### withMediationAdUnitId:\_##withmediationadunitid:\_

1. **Swift**

   ```swift
   public func with(mediationAdUnitId: 문자열) -> 자체
   ```

Mediation 광고 유닛 ID를 `UADSTokenConfiguration`에 추가합니다.

| **프로퍼티**            | **설명**                                 |
| ------------------- | -------------------------------------- |
| `mediationAdUnitId` | Mediation 파트너 대시보드에서 사용한 플레이스먼트 ID입니다. |

**다음 반환**: 업데이트된 `UADSUADSTokenConfigurationBuilder` 인스턴스.

### withPlacementId:\_##withplacementid:\_

1. **Swift**

   ```swift
   public func with(placementId: 문자열) -> 자체
   ```

Unity 수익화 대시보드에 정의된 플레이스먼트 ID를 지정합니다.

| **파라미터**    | **설명**                            |
| ----------- | --------------------------------- |
| placementId | Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다. |

**다음 반환**: 업데이트된 `UADSUADSTokenConfigurationBuilder` 인스턴스.

### withBannerSize:\_##withbannersize:\_

1. **Swift**

   ```swift
   public func with(bannerSize: CGSize) -> Self
   ```

토큰이 배너 광고를 요청한 경우 배너 광고의 크기를 지정합니다.

| **파라미터**   | **설명**                          |
| ---------- | ------------------------------- |
| bannerSize | 토큰이 배너 광고를 요청한 경우 배너 광고의 크기입니다. |

**다음 반환**: 업데이트된 `UADSUADSTokenConfigurationBuilder` 인스턴스.

#### with(extras:)##with(extras:)

1. **Swift**

   ```swift
   공용 함수(추가 사항: [문자열: 문자열]) -> 자체
   ```

커스텀 설정 대한 추가 키-값 쌍을 지정합니다.

| **파라미터** | **설명**                   |
| -------- | ------------------------ |
| extras   | 커스텀 설정을 위한 추가 키-값 페어입니다. |

**다음 반환**: 업데이트된 `UADSTokenConfigurationBuilder` 인스턴스.

### build()##build()

1. **Swift**

   ```swift
   공용 함수 빌드() -> UADSTokenConfiguration
   ```

빌드하고 `UADSTokenConfiguration` 인스턴스를 반환합니다.

**다음 반환**: `UADSTokenConfiguration`의 인스턴스.

## UnityAds##unityads

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

### 초기화##initialization

#### initialize(\_, completion:)##initialize(\_-completion:)

지정된 설정 사용하여 Unity Ads SDK를 초기화합니다. 초기화가 성공 또는 실패로 완료되면 완료 차단 호출됩니다.

1. **Swift**

   ```swift
   공용 정적 기능 초기화(_ 설정: UADSInitializationConfiguration, 완료: @escaping(UnityAdsError?) -> Void)
   ```

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

### GetToken##gettoken

#### getToken(\_, completion:)##gettoken(\_-completion:)

제공된 `UADSTokenConfiguration`에 따라 입찰 토큰을 가져와 완료 차단으로 전달합니다.

1. **Swift**

   ```swift
   공용 정적 기능 getToken(_ 설정: UADSTokenConfiguration, 완료: @escaping(String?) -> Void)
   ```

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

### 정적 변수##static-variables

#### IsInitialized##isinitialized

Unity Ads SDK가 성공적으로 초기화되었는지 여부를 결정하는 부울 프로퍼티.

1. **Swift**

   ```swift
   @objc public static func isInitialized() -> Bool
   ```

**다음 반환**: `true`인 경우 Unity Ads가 성공적으로 초기화되었습니다.

#### getVersion##getversion

현재 사용 중인 Unity Ads SDK 버전을 결정하는 문자열 프로퍼티.

1. **Swift**

   ```swift
   public static func getVersion() -> String
   ```

**다음 반환**: 현재 설치된 Unity Ads SDK 버전입니다.

#### userIdentifier##useridentifier

앱의 각 사용자 대한 고유한 ID를 설정합니다.

1. **Swift**

   ```swift
   공용 정적 var userIdentifier: 문자열
   ```

### 개인정보##privacy

#### setUserConsent()##setuserconsent()

맞춤형 광고에 대한 사용자 동의 옵션을 표시합니다.

1. **Swift**

   ```swift
   public static func setUserConsent(_ consentGranted: 부울)
   ```

#### setUserOptOut()##setuseroptout()

사용자에게 데이터 컬렉션 및 맞춤형 광고를 거부할 수 있는 옵션을 제공합니다.

1. **Swift**

   ```swift
   public static func setUserOptOut(_ optOut: 부울)
   ```

#### setNonBehavioral()##setnonbehavioral()

문맥(비맞춤형) 광고 표시를 활성화합니다.

1. **Swift**

   ```swift
   공용 정적 기능 setNonBehavioral(_ nonBehavioral: 부울)
   ```

### UnityAdsInitializationDelegate##unityadsinitializationdelegate

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신에 완료 차단과 [`UnityAds.initialize(_:completion:)`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#unityads)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UnityAdsInitializationDelegate`는 SDK 초기화 콜백의 이전 델리게이트 프로토콜입니다.

### UnityAdsLoadDelegate##unityadsloaddelegate

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신에 [`UADSInterstitialAd.load(_:completion:)`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsinterstitialad) 또는 [`UADSRewardedAd.load(_:completion:)`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsrewardedad)가 있는 완성 차단을 사용합니다. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UnityAdsLoadDelegate`는 광고 로딩 콜백의 이전 델리게이트 프로토콜입니다.

### UnityAdsShowDelegate##unityadsshowdelegate

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신에 [`UADSInterstitialShowDelegate`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsinterstitialshowdelegate) 또는 [`UADSRewardedShowDelegate`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsrewardedshowdelegate)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UnityAdsShowDelegate`는 광고 쇼 콜백의 이전 델리게이트 프로토콜입니다.

## 열거형##enums

### UADSAdFormat##uadsadformat

Unity Ads 지원하는 다양한 타입의 광고 형식을 정의합니다.

1. **Swift**

   ```swift
   공용 열거형 UADSAdFormat: Int {
       case unspecified = 0, 인터스티셜 광고, 보상형 광고, 배너
   }
   ```

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

### UnityAdsAdFormat##unityadsadformat

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 [`UADSAdFormat`](/ads-ios/4.19.0/sdk-integration/api/ios-api-swift.md#uadsadformat)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UnityAdsAdFormat`는 광고 형식 유형의 이전 열거형입니다.

### UADSLogLevel##uadsloglevel

Unity Ads 로깅 레벨을 정의합니다.

1. **Swift**

   ```swift
   공용 열거형 UADSLogLevel: Int {
       대소문자 비활성화, 오류, 정보, 디버그
   }
   ```

| **파라미터** | **설명**                                                     |
| -------- | ---------------------------------------------------------- |
| 비활성화됨    | 로그 출력 없음.                                                  |
| error    | initi/load/show 작업에서 중요한 오류와 오류만 기록합니다.                    |
| info     | 주요 운영 이벤트(예: 초기화 시작/완료, 로드 시작/완료, 시작/완료 표시, 토큰 생성)를 기록합니다. |
| debug    | 모든 정보와 네트워크 요청 및 내부 오류와 같은 상세한 내부 작업을 기록합니다.               |

### UADSShowFinishState##uadsshowfinishstate

광고가 표시된 후의 종료 상태를 나타냅니다.

1. **Swift**

   ```swift
   public enum UADSShowFinishState: Int {
       case skipped = 0, 완료
   }
   ```

| **파라미터** | **설명**                           |
| -------- | -------------------------------- |
| 건너뛰기     | 사용자가 광고가 끝나기 전에 광고를 닫거나 건너뛰었습니다. |
| 완료됨      | 광고는 끝까지 재생.                      |

## 프로토콜##protocols

### UADSBannerAdDelegate##uadsbanneraddelegate

1. **Swift**

   ```swift
   공용 프로토콜 UADSBannerAdDelegate: NSObjectProtocol {
       function bannerImpression(_ 배너: UADSBannerAd)
       func bannerDidClick(_ banner: UADSBannerAd)
       func bannerDidFailShow(_ banner: UADSBannerAd, 오류: UnityAdsError)
   }
   ```

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

### UADSInterstitialShowDelegate##uadsinterstitialshowdelegate

1. **Swift**

   ```swift
   공용 프로토콜 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

1. **Swift**

   ```swift
   공용 프로토콜 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

1. **Swift**

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

| **파라미터** | **설명**                             |
| -------- | ---------------------------------- |
| code     | Unity Ads 오류 유형을 식별하는 숫자 오류 코드입니다. |
| 메시지      | 오류에 대한 추가 세부 정보를 제공하는 오류 메시지입니다.   |

### UADSBannerErrorCode##uadsbannererrorcode

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 `UnityAdsError` 프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UADSBannerErrorCode`는 배너별 오류 코드의 이전 열거형입니다.

### UnityAdsInitializationError##unityadsinitializationerror

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 `UnityAdsError` 프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UnityAdsInitializationError`는 초기화 오류 유형의 이전 열거형입니다.

### UnityAdsLoadError##unityadsloaderror

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 `UnityAdsError` 프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UnityAdsLoadError`는 광고 로드 오류 유형의 이전 열거형입니다.

### UnityAdsShowError##unityadsshowerror

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신 `UnityAdsError` 프로토콜을 사용합니다. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

`UnityAdsShowError`는 광고 표시 오류 유형의 이전 열거형입니다.
