# Unity Ads iOS SDK API リファレンス

> Unity Ads SDK のパブリック API リファレンスにアクセスして、Objective-C または Swift で使用可能なクラス、メソッド、プロパティを表示し、iOS アプリの広告動作を統合およびコントロールできます。

`UnityAds.h` ライブラリを使用して、動画リワード広告、非リワード型動画広告、インタースティシャル広告、バナー広告などの基本的な広告コンテンツを実装します。

```objective-c
#import "UnityAds.h"
```

この記事は以下の API ドキュメントを含んでいます。

**クラス**

* [`UnityAds`](#unityads)
* [`UADSLoadOptions`](#uadsloadoptions)
* [`UADSBannerView`](#uadsbannerview)

**列挙型**

* [`UnityAdsBannerPosition`](#unityadsbannerposition)
* [`UnityAdsInitializationError`](#unityadsinitializationerror)
* [`UnityAdsLoadError`](#unityadsloaderror)
* [`UnityAdsShowError`](#unityadsshowerror)
* [`UnityAdsError`](#unityadserror)

**デリゲート**

* [`UnityAdsInitializationDelegate`](#unityadsinitializationdelegate)
* [`UnityAdsLoadDelegate`](#unityadsloaddelegate)
* [`UnityAdsShowDelegate`](#unityadsshowdelegate)
* [`UADSBannerDelegate`](#uadsbannerdelegate)
* [`UADSBannerAdRefreshViewDelegate`](#uadsbanneradrefreshviewdelegate)

## クラス##classes

### UnityAds##unityads

```objective-c
#import <UnityAds/UnityAds.h>
```

この名前空間は、動画リワード広告、非リワード型動画広告、インタースティシャル広告、バナー広告などの基本的な広告コンテンツを実装するために使用します。

#### initialize##initialize

```objective-c
+ (void) initialize: (NSString *)gameId
    testMode: (BOOL)testMode
    initializationDelegate: (nullable id<UnityAdsInitializationDelegate>)initializationDelegate;
}
```

指定されたゲーム ID、[テストモード](/grow/ads/optimization/test-ads-integration.md) のステータス、初期化デリゲートを使用して、広告サービスを初期化します。

| **パラメーター**               | **説明**                                                                                                            |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `gameId`                 | プラットフォーム固有のプロジェクトの Unity ゲーム識別子。[Unity の収益化ダッシュボード](https://cloud.unity.com/monetization) から見つけることができます。          |
| `testMode`               | テストモードを使用すると、実際の広告を表示することなく、インテグレーションをテストできます。`true` を使用してテストモードで初期化します。                                          |
| `initializationDelegate` | 任意で [`UnityAdsInitializationDelegate`](#unityadsinitializationdelegate) コールバックを使用して SDK を有効にします (バージョン 3.7.0 以降)。 |

#### load##load

```objective-c
+ (void)load: (NSString *)placementId オプション: (UADSLoadOptions *)options loadDelegate: (nullable id<UnityAdsLoadDelegate>)loadDelegate {
  [UADSLoadModule.sharedInstance loadForPlacementID: placementId
	      						    options: options
    						         loadDelegate: loadDelegate];
}
```

指定された広告ユニットの広告コンテンツをロードします。[`show`](#show) を呼び出す前に、`load` を呼び出す必要があります。

| **パラメーター**     | **説明**                                                                                          |
| -------------- | ----------------------------------------------------------------------------------------------- |
| `placementId`  | 広告コンテンツと共にロードする広告ユニットの識別子。                                                                      |
| `options`      | 広告のロード動作を変更するための [オプション](#uadsloadoptions) のコレクション。                                             |
| `loadDelegate` | 任意で [`UnityAdsLoadDelegate`](#unityadsloaddelegate) コールバックを使用して広告コンテンツをロードします (バージョン 3.7.0 以降)。 |

#### isReady##isready

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

```objective-c
+ (BOOL)isReady: (NSString *)adUnitId {
  return [UnityServices isSupported] && [UnityServices isInitialized] && [UADSPlacement isReady: adUnitId];
}
```

広告が指定した広告ユニットに表示する準備が整っている場合は、`YES` を返します。SDK 初期化時に `enablePerPlacementLoad` を有効にした場合、[`show`](#show) を呼び出す前に `load` を呼び出す必要があります。

| **パラメーター** | **説明**                |
| ---------- | --------------------- |
| `adUnitId` | クエリを実行する広告 dnit の識別子。 |

> **Note:**
>
> 広告ユニット ID を指定せずに `isReady` を呼び出すと、そのメソッドにより、Unity Standard Placement の結果が返されます。

#### show##show

```objective-c
+ (void)show: (UIViewController *)viewController placementId: (NSString *)placementId showDelegate: (nullable id<UnityAdsShowDelegate>)showDelegate {
 	[self show: viewController
       adUnitId: placementId
        options: [UADSShowOptions new]
   showDelegate: showDelegate];
}
```

指定した広告ユニットにロードされた広告コンテンツを表示します。

| **パラメーター**     | **説明**                                                                                       |
| -------------- | -------------------------------------------------------------------------------------------- |
| `placementId`  | 表示する広告ユニットの識別子。                                                                              |
| `options`      | 広告の表示動作を変更するためのオプションのコレクション。                                                                 |
| `showDelegate` | 任意で [`UnityAdsShowDelegate`](#unityadsshowdelegate) コールバックを使用してコンテンツを表示します (バージョン 3.7.0 以降)。 |

> **Note:**
>
> 広告ユニット ID を指定せずに `show` を呼び出すと、そのメソッドにより、Unity Standard Placement 内にあるロード済みのコンテンツが表示されます。SDK バージョン 4.0 以降では、広告ユニット ID を指定してこのメソッドを呼び出す必要があります。

#### addDelegate##adddelegate

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

```objective-c
+ (void)addDelegate: (__nullable id<UnityAdsDelegate>)delegate {
  [UADSProperties addDelegate: delegate];
}
```

Unity Ads のコールバックを受け取るリスナーデリゲートを追加します。バージョン 3.1.0 以降では、複数のリスナーを登録できます。これは [メディエーション](/grow/ads/mediation/unity-ads-in-mediation.md) の顧客にとって特に便利です。

| **パラメーター** | **説明**                                        |
| ---------- | --------------------------------------------- |
| `delegate` | Unity Ads コールバックの [リスナー](#unityadsdelegate) 。 |

#### removeDelegate##removedelegate

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

```objective-c
+ (void)removeDelegate: (id<UnityAdsDelegate>)delegate {
    [UADSProperties removeDelegate: delegate];
}
```

アクティブな [`UnityAdsDelegate`](#unityadsdelegate) リスナーを削除します。

| **パラメーター** | **説明**                                        |
| ---------- | --------------------------------------------- |
| `delegate` | Unity Ads コールバックの [リスナー](#unityadsdelegate) 。 |

#### setDebugMode##setdebugmode

```objective-c
+ (BOOL)getDebugMode {
  return [UnityServices getDebugMode];
}
```

SDK からのログ出力数を制御します。より堅実にログを残すには、`YES` に設定します。

#### getDebugMode##getdebugmode

```objective-c
+ (void)getDebugMode: (BOOL)enableDebugMode {
  [UnityServices setDebugMode: enableDebugMode];
}
```

SDK がデバッグモードの場合は `YES`、それ以外の場合は `NO` を返します。

#### getVersion##getversion

```objective-c
+ (NSString *)getVersion {
  return [UnityServices getVersion];
}
```

Unity Ads SDK の現在のバージョンを返します。

#### isInitialized##isinitialized

```objective-c
+ (BOOL)isInitialized {
  return [USRVSdkProperties isInitialized];
}
```

SDK が正常に初期化された場合は `YES`、それ以外の場合は `NO` を返します。

### UADSLoadOptions##uadsloadoptions

```objective-c
#import <UnityAds/UADSBaseOptions.h>

@interface UADSLoadOptions : UADSBaseOptions

@property (nonatomic, readwrite) NSString *adMarkup;

@end
```

このクラスには、[`load`](#load) メソッドに追加する任意のメタデータが含まれています。サードパーティのメディエーションのヘッダー入札を使用しているお客様は、Unity ネットワークからの入札者が広告オークションで落札した場合にこれを使用する必要があります。

#### setAdMarkup##setadmarkup

```objective-c
- (void)setAdMarkup: (NSString *)adMarkup
```

このメソッドは、入札者サービスから返される広告マークアップを取得します。Unity の広告ネットワークからの入札者がヘッダー入札オークションで落札すると、Unity Ads SDK はメディエーションエクスチェンジから広告マークアップを受け取ります。広告マークアップ文字列には、Unity が広告をロードおよび表示するために必要な情報が含まれています。

### UADSBannerView##uadsbannerview

```objective-c
@interface UADSBannerView : UIView
```

[バナー広告を実装](/grow/ads/ios-sdk/banner-ads.md) するには、このクラスを使用します。Unity Ads バージョン 3.3 以降は、1 つの広告ユニットを介した複数のバナーインスタンスをサポートしています。

#### initWithPlacementId##initwithplacementid

```objective-c
-(instancetype)initWithPlacementId:(NSString *)placementId size:(CGSize)size;
```

広告ユニット ID とバナーサイズを使用してバナービューを実装します。`initWithPlacementId` を呼び出してオブジェクトを初期化してから、[`load`](#load-banner) を呼び出して広告コンテンツをロードします。バナーオブジェクトが [`UADSBannerViewDelegate`](#uadsbannerdelegate) リスナーを介してライフサイクルイベントにアクセスすることに注意してください。

| **パラメーター**    | **説明**                                                                                                                            |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `placementId` | バナーの広告ユニット ID。                                                                                                                    |
| `size`        | バナーオブジェクトの [`size`](https://developer.apple.com/documentation/coregraphics/cgsize?language=objc)。最小サポートサイズは 320 ピクセル × 50 ピクセルです。 |

> **Note:**
>
> [`UADSBannerView`](#uadsbannerview) を使用してバナー広告を呼び出すと、コンテンツロードが 1 回試行され、再読み込みは行われません。バナーがフィルを返さない場合は、バナーを除去し、新しいバナーを作成して再試行してください。メディエーション 顧客に対してはこの方法をお勧めします。

#### ロード##load-banner

```objective-c
- (void)load;
```

バナーに広告をリクエストするための基本メソッドです。

## 列挙型##enums

### UnityAdsPlacementState##unityadsplacementstate

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

```objective-c
typedef NS_ENUM(NSInteger, UnityAdsPlacementState)
```

広告ユニットの状態を表す列挙型。

| **値**                                 | **説明**                    |
| ------------------------------------- | ------------------------- |
| `kUnityAdsPlacementStateReady`        | 広告ユニットは広告を表示できる状態になっています。 |
| `kUnityAdsPlacementStateNotAvailable` | 広告ユニットは利用できません。           |
| `kUnityAdsPlacementStateDisabled`     | 広告ユニットが無効になりました。          |
| `kUnityAdsPlacementStateWaiting`      | 広告ユニットは準備中です。             |
| `kUnityAdsPlacementStateNoFill`       | 広告ユニットに表示する広告がありません。      |

### UnityAdsFinishState##unityadsfinishstate

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

```objective-c
typedef NS_ENUM(NSInteger, UnityAdsFinishState)
```

ユーザーと広告とのインタラクションの状態を表す列挙型。広告が完了すると、SDK がこの値を [`unityAdsDidFinish`](#unityadsdidfinish) コールバックメソッドに渡します。

| **値**                           | **説明**                               |
| ------------------------------- | ------------------------------------ |
| `kUnityAdsFinishStateError`     | Unity のエラーにより広告を最後まで表示できなかったことを示します。 |
| `kUnityAdsFinishStateSkipped`   | ユーザーが広告をスキップしたことを示します。               |
| `kUnityAdsFinishStateCompleted` | 広告の再生が完了したことを示します。                   |

### UnityAdsInitializationError##unityadsinitializationerror

```objective-c
typedef NS_ENUM (NSInteger, UnityAdsInitializationError)
```

SDK の初期化に失敗した理由を表す列挙型です。

| **値**                                        | **説明**                                |
| -------------------------------------------- | ------------------------------------- |
| `kUnityInitializationErrorInternalError`     | 環境または内部サービスが原因でエラーが発生しました。            |
| `kUnityInitializationErrorInvalidArgument`   | Initialize メソッド内の無効な引数が原因でエラーが発生しました。 |
| `kUnityInitializationErrorAdBlockerDetected` | URL がブロックされたことが原因でエラーが発生しました。         |

### UnityAdsLoadError##unityadsloaderror

```objective-c
typedef NS_ENUM (NSInteger, UnityAdsLoadError)
```

広告ユニットのロードが失敗した理由を表す列挙型。

| **値**                                | **説明**                                       |
| ------------------------------------ | -------------------------------------------- |
| `kUnityAdsLoadErrorInitializeFailed` | SDK が初期化されていないことによって広告のロードに失敗しました。           |
| `kUnityAdsLoadErrorInternal`         | Unity Ads の内部サービスエラーによって広告のロードに失敗しました。       |
| `kUnityAdsLoadErrorInvalidArgument`  | [`load`](#load) メソッド内の無効な引数により広告のロードに失敗しました。 |
| `kUnityAdsLoadErrorNoFill`           | ネットワークに利用可能なコンテンツがなかったため広告のロードに失敗しました。       |
| `kUnityAdsLoadErrorTimeout`          | 指定の時間内に広告をロードできませんでした。                       |

### UnityAdsShowCompletionState##unityadsshowcompletionstate

```objective-c
typedef NS_ENUM (NSInteger, UnityAdsShowCompletionState)
```

広告が終了した原因を表す列挙型です。

| **値**                                | **説明**                                                            |
| ------------------------------------ | ----------------------------------------------------------------- |
| `kUnityShowCompletionStateSkipped`   | ユーザーが広告をスキップしたことを示します。                                            |
| `kUnityShowCompletionStateCompleted` | 広告が最後まで再生されたことを示します。これは一般的にユーザーが広告全体を視聴したことで報酬を受け取ることができることを示します。 |

### UnityAdsShowError##unityadsshowerror

```objective-c
typedef NS_ENUM (NSInteger, UnityAdsShowError)
```

広告ユニットの表示に失敗した理由を表す列挙型。

| **値**                             | **説明**                                      |
| --------------------------------- | ------------------------------------------- |
| `kUnityShowErrorNotInitialized`   | SDK が初期化されていなかったため広告の表示に失敗しました。             |
| `kUnityShowErrorNotReady`         | 広告ユニットの準備ができていなかったため広告の表示に失敗しました。           |
| `kUnityShowErrorVideoPlayerError` | メディアプレイヤーのエラーにより広告の表示に失敗しました。               |
| `kUnityShowErrorInvalidArgument`  | [`show`](#show) メソッド内の無効な引数により広告の表示に失敗しました。 |
| `kUnityShowErrorNoConnection`     | インターネット接続エラーにより広告の表示に失敗しました。                |
| `kUnityShowErrorAlreadyShowing`   | 広告がすでに表示されていたため広告の表示に失敗しました。                |
| `kUnityShowErrorInternalError`    | Unity Ads の内部サービスエラーによって広告の表示に失敗しました。       |

### UnityAdsError##unityadserror

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

```objective-c
typedef NS_ENUM (NSInteger, UnityAdsError)
```

[`unityAdsDidError`](#unityadsdiderror) コールバックを通じて発生した Unity Ads のエラーの原因を表す列挙型。

| **値**                               | **説明**                              |
| ----------------------------------- | ----------------------------------- |
| `kUnityAdsErrorNotInitialized = 0`  | Unity Ads サービスは現在初期化されません。          |
| `kUnityAdsErrorInitializedFailed`   | 初期化プロセスでエラーが発生しました。                 |
| `kUnityAdsErrorInvalidArgument`     | 無効なパラメーターにより、Unity Ads の初期化が失敗しました。 |
| `kUnityAdsErrorVideoPlayerError`    | ビデオプレイヤーの障害によってエラーが発生しました。          |
| `kUnityAdsErrorInitSanityCheckFail` | 無効な環境により Unity Ads サービスの初期化が失敗しました。 |
| `kUnityAdsErrorAdBlockerDetected`   | 広告ブロッカーによりエラーが発生しました。               |
| `kUnityAdsErrorFileIoError`         | ファイルの読み取りまたは書き込みができないためにエラーが発生しました。 |
| `kUnityAdsErrorDeviceIdError`       | 不正なデバイス識別子のためにエラーが発生しました。           |
| `kUnityAdsErrorShowError`           | 広告を表示しようとした際にエラーが発生しました。            |
| `kUnityAdsErrorInternalError`       | Unity Ads サービス内部でエラーが発生しました。        |

### UnityAdsBannerPosition##unityadsbannerposition

バナー広告のアンカーとして設定可能な位置を表す列挙型。

| **値**                                 | **説明**             |
| ------------------------------------- | ------------------ |
| `kUnityAdsBannerPositionTopLeft`      | バナーを画面の左上に固定します。   |
| `kUnityAdsBannerPositionTopCenter`    | バナーを画面の上部中央に固定します。 |
| `kUnityAdsBannerPositionTopRight`     | バナーを画面の右上に固定します。   |
| `kUnityAdsBannerPositionBottomLeft`   | バナーを画面の左下に固定します。   |
| `kUnityAdsBannerPositionBottomCenter` | バナーを画面の下部中央に固定します。 |
| `kUnityAdsBannerPositionBottomRight`  | バナーを画面の右下に固定します。   |
| `kUnityAdsBannerPositionCenter`       | バナーを画面の中央に固定します。   |
| `kUnityAdsBannerPositionNone`         | バナーを固定しません。        |

## デリゲート##delegates

### UnityAdsInitializationDelegate##unityadsinitializationdelegate

```objective-c
@protocol UnityAdsInitializationDelegate <NSObject>
- (void)initializationComplete;
- (void)initializationFailed: (UnityAdsInitializationError)error withMessage: (NSString *)message;
@end
```

このデリゲートは [`initialize`](#initialize) の結果をハンドルするために実装します。

#### initializationComplete##initializationcomplete

このコールバックメソッドは、SDK が問題なく初期化されたときのロジックをハンドルします。

#### initializationFailed##initializationfailed

このコールバックメソッドは、SDK の初期化が失敗したときのロジックをハンドルします。

| **パラメーター** | **説明**                                                                       |
| ---------- | ---------------------------------------------------------------------------- |
| `error`    | 初期化の失敗の原因となった [`UnityAdsInitializationError`](#unityadsinitializationerror)。 |
| `message`  | エラーに関連するメッセージです。                                                             |

### UnityAdsLoadDelegate##unityadsloaddelegate

```objective-c
@protocol UnityAdsLoadDelegate <NSObject>
- (void)unityAdsAdLoaded: (NSString *)placementId;
- (void)unityAdsAdFailedToLoad: (NSString *)placementId
       withError: (UnityAdsLoadError)error
     withMessage: (NSString *)message;
@end
```

このデリゲートは [`load`](#load) の結果をハンドルするために実装します。

#### unityAdsAdLoaded##unityadsadloaded

このコールバックメソッドは、広告ユニットが正常にロードされたときのロジックを処理します。

| **パラメーター**    | **説明**                 |
| ------------- | ---------------------- |
| `placementId` | コンテンツをロードした広告ユニットの識別子。 |

#### unityAdsAdFailedToLoad##unityadsadfailedtoload

このコールバックメソッドは、広告ユニットのロードが失敗したときのロジックを処理します。

| **パラメーター**    | **説明**                                                |
| ------------- | ----------------------------------------------------- |
| `placementId` | コンテンツのロードに失敗した広告ユニットの識別子。                             |
| `error`       | ロード失敗の原因となった [UnityAdsLoadError](#unityadsloaderror)。 |
| `message`     | エラーに関連するメッセージです。                                      |

### UnityAdsShowDelegate##unityadsshowdelegate

```objective-c
@protocol UnityAdsShowDelegate <NSObject>
- (void)unityAdsShowComplete: (NSString *)adUnitId withFinishState: (UnityAdsShowCompletionState)state;
- (void)unityAdsShowFailed: (NSString *)adUnitId withError: (UnityAdsShowError)error withMessage: (NSString *)message;
- (void)unityAdsShowStart: (NSString *)adUnitId;
- (void)unityAdsShowClick: (NSString *)adUnitId;
@end
```

このデリゲートは [`show`](#show) の結果をハンドルするために実装します。

#### unityAdsShowComplete##unityadsshowcomplete

このコールバックメソッドは、広告視聴終了時のロジックをハンドルします。

| **パラメーター** | **説明**                    |
| ---------- | ------------------------- |
| `adUnitId` | コンテンツを表示している広告ユニットの識別子。   |
| `state`    | 広告がスキップされたか、完全視聴したかを示します。 |

#### unityAdsShowStart##unityadsshowstart

このコールバックメソッドは、広告再生開始時のロジックをハンドルします。

| **パラメーター** | **説明**                  |
| ---------- | ----------------------- |
| `adUnitId` | コンテンツを表示している広告ユニットの識別子。 |

#### unityAdsShowClick##unityadsshowclick

このコールバックメソッドは、ユーザーが広告をクリックしたときのロジックをハンドルします。

| **パラメーター** | **説明**                  |
| ---------- | ----------------------- |
| `adUnitId` | コンテンツを表示している広告ユニットの識別子。 |

#### unityAdsShowFailed##unityadsshowfailed

このコールバックメソッドは、広告ユニットのコンテンツの表示が失敗したときのロジックを処理します。

| **パラメーター** | **説明**                                                 |
| ---------- | ------------------------------------------------------ |
| `adUnitId` | コンテンツの表示に失敗した広告ユニットの識別子。                               |
| `error`    | 表示失敗の原因となった [`UnityAdsShowError`](#unityadsshowerror)。 |
| message    | エラーに関連するメッセージです。                                       |

### UnityAdsDelegate##unityadsdelegate

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

```objective-c
@protocol UnityAdsDelegate <NSObject>
- (void)unityAdsReady: (NSString *)placementId;
- (void)unityAdsDidError: (UnityAdsError)error withMessage: (NSString *)message;
- (void)unityAdsDidStart: (NSString *)placementId;
- (void)unityAdsDidFinish: (NSString *)placementId
   withFinishState: (UnityAdsFinishState)state;
@end
```

このデリゲートは広告のさまざまな状態をハンドルするために実装します。[リワード広告](/grow/ads/ios-sdk/rewarded-ads.md) のロジックを定義するには、これをスクリプトに実装します。

#### unityAdsReady##unityadsready

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

指定された広告ユニットを通じて表示する広告コンテンツの準備ができているときのロジックを指定します。

| **パラメーター**    | **説明**              |
| ------------- | ------------------- |
| `placementId` | 準備ができている広告ユニットの識別子。 |

#### unityAdsDidError##unityadsdiderror

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

エラーによって広告コンテンツの表示に失敗したときのロジックを指定します。

| **パラメーター** | **説明**                                        |
| ---------- | --------------------------------------------- |
| `error`    | エラーの原因となった [`UnityAdsError`](#unityadserror)。 |
| `message`  | エラーに関連するメッセージです。                              |

#### unityAdsDidStart##unityadsdidstart

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

プレイヤーが広告の表示をトリガーしたときのロジックを指定します。

| **パラメーター**    | **説明**               |
| ------------- | -------------------- |
| `placementId` | 広告を表示している広告ユニットの識別子。 |

#### unityAdsDidFinish##unityadsdidfinish

> **Important:**
>
> SDK バージョン 4.0 で削除されました。詳細については、非推奨の API クラス を参照してください。

プレイヤーが広告を最後まで見たときのロジックを指定します。

| **パラメーター**    | **説明**                                        |
| ------------- | --------------------------------------------- |
| `placementId` | 表示が完了した広告ユニットの識別子。                            |
| `state`       | 表示される広告の [結果のユーザーイベント](#unityadsfinishstate)。 |

### UADSBannerDelegate##uadsbannerdelegate

```objective-c
@protocol UADSBannerViewDelegate <NSObject>
 
@optional
- (void)bannerViewDidLoad: (UADSBannerView *)bannerView;
- (void)bannerViewDidClick: (UADSBannerView *)bannerView;
- (void)bannerViewDidLeaveApplication: (UADSBannerView *)bannerView;
- (void)bannerViewDidError: (UADSBannerView *)bannerView error: (UADSBannerError *)error;
@end
```

このデリゲートは Unity Ads のバナーイベントからのコールバックを提供します。

#### bannerViewDidLoad##bannerviewdidload

このコールバックは、バナーが広告コンテンツを正常にロードしたときに発生します。

#### bannerViewDidClick##bannerviewdidclick

このコールバックは、ユーザーがバナー広告をクリックしたときに発生します。

#### bannerViewDidLeaveApplication##bannerviewdidleaveapplication

このコールバックは、ユーザーがアプリを終了したことでバナーが閉じられたときに発生します。

#### bannerViewDidError##bannerviewdiderror

このコールバックは、UnityAdsBanner でエラーが発生したときに発生します。

| **パラメーター** | **説明**                        |
| ---------- | ----------------------------- |
| `error`    | エラーの原因となった `UADSBannerError`。 |

### UADSBannerAdRefreshViewDelegate##uadsbanneradrefreshviewdelegate

> **Note:**
>
> このデリゲートは廃止予定であり、Unity Ads SDK の今後のメジャーバージョンリリースで削除されます。

```objective-c
@protocol UADSBannerAdRefreshViewDelegate <NSObject>
 
@optional
- (void)unityAdsRefreshBannerDidLoad: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidNoFill: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidShow: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidHide: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidClick: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidError: (UADSBannerAdRefreshView *)bannerAdRefreshView message: (NSString *)message;
@end
```

このデリゲートは Unity Ads のバナーの再読み込みイベントからのコールバックを提供します。

#### unityAdsRefreshBannerDidLoad##unityadsrefreshbannerdidload

バナーがロードされ、ビュー階層に配置される準備が整ったときに呼び出されます。

#### unityAdsRefreshBannerDidNoFill##unityadsrefreshbannerdidnofill

バナーに広告コンテンツがないときに呼び出されます。

#### unityAdsRefreshBannerDidShow##unityadsrefreshbannerdidshow

バナーがユーザーに表示されているときに呼び出されます。

#### unityAdsRefreshBannerDidHide##unityadsrefreshbannerdidhide

バナーがユーザーに表示されていないときに呼び出されます。

#### unityAdsRefreshBannerDidClick##unityadsrefreshbannerdidclick

ユーザーがバナー広告をクリックしたときに呼び出されます。

#### unityAdsRefreshBannerDidError##unityadsrefreshbannerdiderror

`UnityAdsBanner` でエラーが発生したときに呼び出されます。

| **パラメーター** | **説明**           |
| ---------- | ---------------- |
| `message`  | エラーに関連するメッセージです。 |