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

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

Unity Unity AdsUnity Ads ObjectiveObjective-CPI 이 레퍼런스 사용합니다.

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

## 클래스##classes

## UADSBannerAd##uadsbannerad

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

### load:completion:\_##load:completion:\_

1. **Objective-C**

   ```objective-c
   @interface UADSBannerAd : NSObject
   + (void)load:(UADSBannerLoadConfiguration * _Nonnull)config
     완료(void (^ _Nonnull)(UADSBannerAd * _Nullable, id<UnityAdsError> _Nullable)) 완료;
   @end
   ```

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

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

### 뷰##view

1. **Objective-C**

   ```objective-c
   @interface UADSBannerAd : NSObject
   @property (비핵화, 읽기 전용, 강력함) UIView * _Nonnull 뷰;
   @end
   ```

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

### UADSBannerView##uadsbannerview

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

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

## UADSBannerLoadConfiguration##uadsbannerloadconfiguration

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

1. **Objective-C**

   ````objective-c
   @interface BannerLoadConfiguration : NSObject
   @properties (nonatomic, strong) NSString *placementId;
   @property (비핵화, 강력, nullable) NSString *adMarkup;
   @property (비자동, 할당) CGSize bannerSize;
   @properti (nonatomic, weak, nullable) id<UADSBannerAdDelegate> 델리게이트; @properti (nonatomic, strong, nullable) NSString *mediationAdUnitId; @properti (nonatomic, strong, nullable) MediationInfo *mediationInfo; @properti (nonatomic, strong) NSDictionary<nsstring *, nsstring *>
   *extras; @end ```
   </Tab>
   </Tabs>

   <Table>
   <TableHeader>
   <TableRow>
     <TableHeaderCell>**프로퍼티**</TableHeaderCell>
     <TableHeaderCell>**설명**</TableHeaderCell>
     <TableHeaderCell>**필수**</TableHeaderCell>
   </TableRow>
   </TableHeader>

   <TableBody>
   <TableRow>
     <TableCell>`placementId`</TableCell>
     <TableCell>Unity 수익화 대시보드에 정의된 플레이스먼트 ID입니다.</TableCell>
     <TableCell>예</TableCell>
   </TableRow>

   <TableRow>
     <TableCell>`adMarkup`</TableCell>
     <TableCell>입찰을 통해 광고를 로드할 때 사용되는 광고 마크업 데이터입니다.</TableCell>
     <TableCell>아니요</TableCell>
   </TableRow>

   <TableRow>
     <TableCell>`bannerSize`</TableCell>
     배너 광고의 <TableCell>크기입니다.</TableCell>
     <TableCell>예</TableCell>
   </TableRow>

   <TableRow>
     <TableCell>`delegate`</TableCell>
     <TableCell>배너 광고 이벤트를 처리합니다.</TableCell>
     <TableCell>예</TableCell>
   </TableRow>

   <TableRow>
     <TableCell>`mediationAdUnitId`</TableCell>
     <TableCell>Mediation 파트너 대시보드에 정의된 광고 유닛 또는 플레이스먼트 ID입니다.</TableCell>
     <TableCell>아니요</TableCell>
   </TableRow>

   <TableRow>
     <TableCell>`mediationInfo`</TableCell>
     <TableCell>Mediation 통합에 대한 세부 정보를 지정합니다.</TableCell>
     <TableCell>아니요</TableCell>
   </TableRow>

   <TableRow>
     <TableCell>`extras`</TableCell>
     <TableCell>추가 커스텀 키-값 페어.</TableCell>
     <TableCell>아니요</TableCell>
   </TableRow>
   </TableBody>
   </Table>

   ## UADSBannerLoadConfigurationBuilder##uadsbannerloadconfigurationbuilder

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

   ### initWithPlacementId:adMarkup:bannerSize:delegate##initwithplacementid:admarkup:bannersize:delegate

   <Tabs>
   <Tab title="Objective-C">
   ```objective-c
   - (nonnull 인스턴스 타입)initWithPlacementId:(NSString * _Nonnull)placementId
                                    bannerSize:(CGSize)bannerSize
                                      델리게이트(id <UADSBannerAdDelegate> _Nonnull) 델리게이트;
   ````

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

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

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

### withAdMarkup:\_##withadmarkup:\_

1. **Objective-C**

   ```objective-c
   - AdMarkup(NSString * _Nonnull)과 함께 (nonnull 인스턴스 타입)adMarkup
   ```

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

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

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

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
   ```

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

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

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

### withMediationInfo:\_##withmediationinfo:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
   ```

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

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

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

### withExtras:\_##withextras:\_

1. **Objective-C**

   ```objective-c
   - (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
   ```

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

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

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

### 빌드##build

1. **Objective-C**

   ```objective-c
   - (UADSBannerLoadConfiguration * _Nonnull)빌드
   ```

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

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

### UADSBannerLoadOptions##uadsbannerloadoptions

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

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

## UADSInitializationConfiguration##uadsinitializationconfiguration

1. **Objective-C**

   ```objective-c
   @interface UADSInitializationConfiguration: NSObject
   @property (nonatomic, strong) NSString *gameId;
   @property (nonatomic, assign) BOOL isTestModeEnabled;
   @property (nonatomic, assign) UADSLogLevel logLevel;
   @property (nonatomic, strong, nullable) UADSMediationInfo *mediationInfo;
   @property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;
   @end
   ```

`UADSInitializationConfiguration` 클래스는 Unity Ads SDK를 초기화하는 데 필요한 앱에 대한 필수 정보로 구성된 오브젝트를 생성합니다.

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

## UADSInitializationConfigurationBuilder##uadsinitializationconfigurationbuilder

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

### initWithgameID:\_##initwithgameid:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)initWithGameId:(NSString * _Nonnull)gameId
   ```

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

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

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

### withTestMode:\_##withtestmode:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입) withTestMode:(BOOL)testMode
   ```

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

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

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

### withLogLevel:\_##withloglevel:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)LogLevel(열거형 UADSLogLevel)logLevel
   ```

로그에 포함된 세부 정보의 양을 None부터 Full 디버그 정보까지 정의하는 [로그 레벨](#uadsloglevel)을 설정합니다.

| **파라미터** | **설명**                |
| -------- | --------------------- |
| 레벨       | 로그 출력의 디테일 수준을 지정합니다. |

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

### withMediationInfo:\_##withmediationinfo:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
   ```

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

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

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

### withExtras:\_##withextras:\_

1. **Objective-C**

   ```objective-c
   - (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
   ```

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

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

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

### 빌드##build

1. **Objective-C**

   ```objective-c
   - (UADSInitializationConfiguration * _Nonnull)빌드
   ```

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

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

## UADSInterstitialAd##uadsinterstitialad

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

### load:completion:\_##load:completion:\_

1. **Objective-C**

   ```objective-c
   @interface UADSInterstitialAd : NSObject
   + (void)load:(UADSLoadConfiguration * _Nonnull)설정
     완료(void (^ _Nonnull)(UADSInterstitialAd * _Nullable, id<UnityAdsError> _Nullable)) 완료;
   @end
   ```

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

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

### show:delegate:\_##show:delegate:\_

1. **Objective-C**

   ```objective-c
   @interface UADSInterstitialAd : NSObject
   - (void)show:(UADSShowConfiguration * _Nullable)설정
       델리게이트(id <UADSInterstitialShowDelegate> _Nonnull) 델리게이트;
   @end
   ```

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

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

### onAdExpired##onadexpired

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

1. **Objective-C**

   ```objective-c
   @interface UnityAd : NSObject
   @property (nonatomic, copy) void (^ _Nullable onAdExpired)(UnityAd * _Nonnull);
   @end
   ```

## UADSLoadConfiguration##uadsloadconfiguration

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

1. **Objective-C**

   ```objective-c
   @interface UADSLoadConfiguration: NSObject
   @property (nonatomic, strong) NSString *placementId;
   @property (nonatomic, strong, nullable) NSString *adMarkup;
   @property (nonatomic, strong, nullable) NSString *mediationAdUnitId;
   @property (nonatomic, strong, nullable) UADSMediationInfo *mediationInfo;
   @property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;
   @end
   ```

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

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

| 참고 adMarkup 프로퍼티 모든 입찰 구현에 필요합니다. 워터폴 구현의 경우 adMarkup을 null으로 설정할 수 있습니다. |
| ------------------------------------------------------------------------- |

## UADSLoadConfigurationBuilder##uadsloadconfigurationbuilder

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

### initWithPlacementId:\_##initwithplacementid:\_

1. **Objective-C**

   ```objective-c
   - - (nonnull instancetype)initWithPlacementId:(NSString * _Nonnull)placementId;
   ```

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

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

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

### withAdMarkup:\_##withadmarkup:\_

1. **Objective-C**

   ```objective-c
   - AdMarkup(NSString * _Nonnull)과 함께 (nonnull 인스턴스 타입)adMarkup
   ```

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

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

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

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

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
   ```

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

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

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

### withMediationInfo:\_##withmediationinfo:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)info
   ```

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

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

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

### withExtras:\_##withextras:\_

1. **Objective-C**

   ```objective-c
   - (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
   ```

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

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

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

### 빌드##build

1. **Objective-C**

   ```objective-c
   - (UADSLoadConfiguration * _Nonnull)빌드
   ```

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

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

### UADSLoadOptions##uadsloadoptions

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

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

## UADSMediationInfo##uadsmediationinfo

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

1. **Objective-C**

   ```objective-c
   @interface UADSMediationInfo : NSObject
   - (nonnull 인스턴스 타입)initWithName:(NSString * _Nonnull)name
                                버전:(NSString * _Nonnull) 버전
                         adapterVersion:(NSString * _Nonnull)adapterVersion
   @end
   ```

| **파라미터**       | **설명**                                 |
| -------------- | -------------------------------------- |
| 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-objc.md#uadsmediationinfo)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

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

## UADSRewardedAd##uadsrewardedad

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

### load:completion:\_##load:completion:\_

1. **Objective-C**

   ```objective-c
   + (void)load:(UADSLoadConfiguration * _Nonnull)설정
     완료(void (^ _Nonnull)(UADSRewardedAd * _Nullable, id<UnityAdsError> _Nullable)) 완료;
   ```

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

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

### show:delegate:\_##show:delegate:\_

1. **Objective-C**

   ```objective-c
   - (void)show:(UADSShowConfiguration * _Nullable)설정
       델리게이트(id <UADSRewardedShowDelegate> _Nonnull) 델리게이트;
   ```

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

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

### onAdExpired##onadexpired

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

1. **Objective-C**

   ```objective-c
   @interface UnityAd : NSObject
   @property (nonatomic, copy) void (^ _Nullable onAdExpired)(UnityAd * _Nonnull);
   @end
   ```

## UADSShowConfiguration##uadsshowconfiguration

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

1. **Objective-C**

   ```objective-c
   @interface UADSShowConfigurationBuilder : NSObject
   @property (nonatomic, weak, nullable) UIViewController *viewController;
   @property (nonatomic, strong, nullable) NSString *customRewardString;
   @property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;
   @end
   ```

선택적 추가 파라미터가 있는 새 `UADSShowConfiguration` 인스턴스를 생성합니다.

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

## UADSShowConfigurationBuilder##uadsshowconfigurationbuilder

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

### init##init

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)init;
   ```

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

### withViewController:\_##withviewcontroller:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)와ViewController:(UIViewController * _Nonnull)viewController
   ```

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

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

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

### withCustomRewardString:\_##withcustomrewardstring:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)CustomRewardString(NSString * _Nonnull)과 함께 사용
   ```

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

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

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

### withExtras:\_##withextras:\_

1. **Objective-C**

   ```objective-c
   - (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
   ```

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

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

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

### 빌드##build

1. **Objective-C**

   ```objective-c
   - (UADSShowConfiguration * _Nonnull)빌드
   ```

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

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

### UADSShowOptions##uadsshowoptions

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

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

## UADSTokenConfiguration##uadstokenconfiguration

1. **Objective-C**

   ```objective-c
   @interface UADSTokenConfiguration : NSObject
   @property (nonatomic, assign) AdFormat UADSAdFormat;
   @property (nonatomic, strong, nullable) UADSMediationInfo *mediationInfo;
   @property (nonatomic, strong, nullable) NSString *mediationAdUnitId;
   @property (nonatomic, strong, nullable) NSString *placementId;
   @property (nonatomic, assign) CGSize bannerSize;
   @property (nonatomic, strong) NSDictionary<NSString *, NSString *> *extras;
   @end
   ```

`UADSTokenConfiguration` 인터페이스는 입찰 토큰을 얻기 위해 필요한 필수 정보로 구성된 오브젝트를 생성합니다.

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

### UADSTokenConfigurationBuilder##uadstokenconfigurationbuilder

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

### initWithAdFormat:\_##initwithadformat:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)initWithAdFormat:( 열거형 UADSAdFormat)adFormat
   ```

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

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

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

### withMediationInfo:\_##withmediationinfo:\_

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)MediationInfo:(UADSMediationInfo * _Nonnull)mediationInfo
   ```

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

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

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

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

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)MediationAdUnitId(NSString * _Nonnull)mediationAdUnitId
   ```

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

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

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

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

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입) withPlacementId:(NSString * _Nonnull)placementId
   ```

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

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

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

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

1. **Objective-C**

   ```objective-c
   - (nonnull 인스턴스 타입)와BannerSize:(CGSize)bannerSize
   ```

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

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

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

### withExtras:\_##withextras:\_

1. **Objective-C**

   ```objective-c
   - (nonnull instancetype)withExtras:(NSDictionary<NSString *, NSString *> * _Nonnull)extras
   ```

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

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

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

### 빌드##build

1. **Objective-C**

   ```objective-c
   - (UADSTokenConfiguration * _Nonnull)빌드
   ```

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

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

## UnityAds##unityads

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

### 초기화##initialization

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

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

1. **Objective-C**

   ```objective-c
   + (void) initialize:(UADSInitializationConfiguration *) 설정
            완료(void (^)(id<UnityAdsError>)) 완료;
   ```

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

### GetToken##gettoken

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

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

1. **Objective-C**

   ```objective-c
   + (void) getToken(UADSTokenConfiguration *) 설정
          완료(void (^)(NSString *)) 완료;
   ```

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

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

#### IsInitialized##isinitialized

Unity Ads SDK가 성공적으로 초기화되었는지 확인합니다.

1. **Objective-C**

   ```objective-c
   + (BOOL)이Initialized
   ```

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

#### getVersion##getversion

사용 중인 현재 Unity Ads SDK 버전을 결정합니다.

1. **Objective-C**

   ```objective-c
   + (NSString *)getVersion
   ```

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

#### userIdentifier##useridentifier

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

1. **Objective-C**

   ```objective-c
   @objc 공용 정적 var userIdentifier: 문자열 {...}
   ```

### 개인정보##privacy

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

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

1. **Objective-C**

   ```objective-c
   + (void)setUserConsent:(BOOL)consentGranted;
   ```

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

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

1. **Objective-C**

   ```objective-c
   + (void)setUserOptOut:(BOOL)optOut;
   ```

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

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

1. **Objective-C**

   ```objective-c
   + (void)setNonBehavioral:(BOOL)nonBehavioral;
   ```

### UADSMetaData##uadsmetadata

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

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

### UnityAdsInitializationDelegate##unityadsinitializationdelegate

> **Warning:**
>
> **4.19.0 버전에서 사용 중단 예정. 버전 5.0.0에서 제거 예정**
>
> 대신에 완료 차단과 [`UnityAds initialize:completion:`](/ads-ios/4.19.0/sdk-integration/api/ios-api-objc.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-objc.md#uadsinterstitialad) 또는 [`UADSRewardedAd load:completion:`](/ads-ios/4.19.0/sdk-integration/api/ios-api-objc.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-objc.md#uadsinterstitialshowdelegate) 또는 [`UADSRewardedShowDelegate`](/ads-ios/4.19.0/sdk-integration/api/ios-api-objc.md#uadsrewardedshowdelegate)를 사용하십시오. 마이그레이션에 대한 자세한 내용은 [iOS 사용 중단 예정 API](/ads-ios/4.19.0/sdk-integration/api/ios-deprecated-apis.md)를 참조하십시오.

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

## 열거형##enum

### UADSAdFormat##uadsadformat

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

1. **Objective-C**

   ```objective-c
   typedef 열거형 {
     UADSAdFormatUnspecified = 0,
     UADSAdFormatInterstitial = 1,
     UADSAdFormatRewarded = 2,
     UADSAdFormatBanner = 3,
   } UADSAdFormat;
   ```

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

### UnityAdsAdFormat##unityadsadformat

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

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

### UADSLogLevel##uadsloglevel

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

1. **Objective-C**

   ```objective-c
   typedef 열거형 {
     UADSLogLevelDisabled = 0,
     UADSLogLevelError = 1,
     UADSLogLevelInfo = 2,
     UADSLogLevelDebug = 3,
   } UADSLogLevel;
   ```

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

### UADSShowFinishState##uadsshowfinishstate

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

1. **Objective-C**

   ```objective-c
   typedef 열거형 {
     UADSShowFinishStateSkipped = 0,
     UADSShowFinishStateCompleted = 1,
   } UADSShowFinishState
   ```

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

## 프로토콜##protocol

### UADSBannerAdDelegate##uadsbanneraddelegate

1. **Objective-C**

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

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

### UADSInterstitialShowDelegate##uadsinterstitialshowdelegate

1. **Objective-C**

   ```objective-c
   @protocol UADSInterstitialShowDelegate <NSObject>
   - (void)showDidStart:(UADSInterstitialAd * _Nonnull)unityAd;
   - (void)showDidClick:(UADSInterstitialAd * _Nonnull)unityAd;
   - (void)showDidComplete:(UADSInterstitialAd * _Nonnull)unityAd와:( 열거형 UADSShowFinishState)finishState;
   - (void)showDidFail:(UADSInterstitialAd * _Nonnull)unityAd error:(id<UnityAdsError> _Nonnull)error;
   @end
   ```

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

### UADSRewardedShowDelegate##uadsrewardedshowdelegate

1. **Objective-C**

   ```objective-c
   @protocol UADSRewardedShowDelegate <NSObject>
   - (void)showDidStart:(UADSRewardedAd * _Nonnull)unityAd;
   - (void)showDidClick:(UADSRewardedAd * _Nonnull)unityAd;
   - (void)showDidComplete:(UADSRewardedAd * _Nonnull)unityAd와:( 열거형 UADSShowFinishState)finishState;
   - (void)showDidFail:(UADSRewardedAd * _Nonnull)unityAd error:(id<UnityAdsError> _Nonnull)error;
   - (void)showDidReceiveReward:(UADSRewardedAd * _Nonnull)unityAd;
   @end
   ```

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

## UnityAdsError##unityadserror

1. **Objective-C**

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

| **파라미터** | **설명** |
| -------- | ------ |
| code     |        |
| 메시지      |        |

### UADSBannerErrorCode##uadsbannererrorcode

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

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