# Adobe AIR のバナーインテグレーション

> SDKの初期化、初期化後のバナー広告オブジェクトの作成、適切な広告サイズと位置の設定によってバナー広告を統合します。

バナーは、システムによって開始される長方形の広告で、静的またはアニメーションにすることができ、ライブアコンテンツ定されたエリアに配信されます。

以下の手順を実行して、Unity LevelPlay でバナー広告を統合して配信します。

1. **バナーイベントの実装**
2. **ロードバナー広告**
3. **バナー広告の破棄**
4. **バナープロバイダーの統合**

## 前提条件##prerequisites

* ironsource Air プラグインがアプリケーションに正しく統合されていることを確認します。インテグレーションの概要は[こちら](/grow/levelplay/sdk/adobe/air-plugin-integration.md)です。
* バナーサポート付きのメディエーションアダプタのいずれかを統合し、この広告単位を提供します。

## ステップ 1. バナーイベントの実装##step-1.-implement-the-banner-events

ironsource Air プラグインは、広告の可用性とアクティビティを通知するいくつかのイベントを発生させます。イベントをリッスンするには、以下のメソッドを呼び出します。

```text
IronSource.instance.addEventListener( "EventName", functionToCall  );
```

> **Note:**
>
> 1. **EventName** はリッスンするイベントを含む文字列です。
> 2. **functionToCall** は、イベントが発生したときに呼び出す機能です。

```text
IronSource.instance.addEventListener("levelPlayBannerAdLoaded", levelPlayBannerAdLoaded);
IronSource.instance.addEventListener("levelPlayBannerAdLoadFailed", levelPlayBannerAdLoadFailed);
IronSource.instance.addEventListener("levelPlayBannerAdClicked", levelPlayBannerAdClicked);
IronSource.instance.addEventListener("levelPlayBannerAdLeftApplication", levelPlayBannerAdLeftApplication);
IronSource.instance.addEventListener("levelPlayBannerAdScreenPresented", levelPlayBannerAdScreenPresented);
IronSource.instance.addEventListener("levelPlayBannerAdScreenDismissed", levelPlayBannerAdScreenDismissed);
```

プラグインは、以下のすべての可能なイベントをリスナーに通知します。

```text
private function levelPlayBannerAdLoaded(event:Event):void {
   //level Play Banner Ad Loaded
}
private function levelPlayBannerAdLoadFailed(event:Event):void {
   //level Play Banner Ad Load Failed
}
private function levelPlayBannerAdClicked(event:Event):void {
   //level Play Banner Ad Clicked
}
private function levelPlayBannerAdLeftApplication(event:Event):void {
   //level Play Banner Ad Left Application
}
private function levelPlayBannerAdScreenPresented(event:Event):void {
   //level Play Banner Ad Screen Presented
}
private function levelPlayBannerAdScreenDismissed(event:Event):void {
   //level Play Banner Ad Screen Dismissed
}
```

## ステップ 2. ロードバナー広告##step-2.-load-banner-ad

バナー広告をロードするには、以下のメソッドを呼び出します。

```text
IronSource.instance.loadBanner(IronSourceBannerSize.BANNER, IronSource.POSITION_BOTTOM);
```

### バナーの寸法と位置##banner-dimensions-&-position

バナーをロードするときは、バナーのサイズと位置を必ず設定してください。

| **サイズ**           | **説明**                                        | **ディメンション**                                     | **広告ネットワークサポート**                                                          |
| ----------------- | --------------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------- |
| バナー               | 携帯電話とタブレットに最適な標準バナー                           | 50 X 画面幅                                        | AppLovin、Digital Turbine、Google、Liftoff Monetize、Meta、Mintegral、Unity Ads |
| LARGE\_BANNER     | タブレットおよび大型デバイスに最適な大型バナー                       | 90 X 画面幅                                        | Admob、AppLovin                                                            |
| RECTANGLE\_BANNER | スクロール可能なフィードやゲームレベル間の移動に最適な大型矩形バナー            | 250 X 画面幅                                       | Admob、AppLovin                                                            |
| SMART\_BANNER     | スマートバナー デバイスのサイズと向きに合わせて自動的にサイズ変更される広告をレンダリング | 50 (画面の高ささ ≤ 720) X 画面幅 90 (画面の高ささ ≤ 720) X 画面幅 | Admob、AppLovin                                                            |

| **位置**           | **説明**              |
| ---------------- | ------------------- |
| POSITION\_TOP    | バナーは画面の中央上部に配置      |
| POSITION\_BOTTOM | バナーは画面の下部中央に配置されます。 |

### バナープレースメント##banner-placements

Unity LevelPlay ダッシュボードでは、[プレースメント](/grow/levelplay/platform/settings/placements.md)、バナーの上限設定、バナーの間隔設定をサポートしています。

バナーのプレースメントを設定している場合は、以下のメソッドを呼び出して特定の場所にバナー広告を配信します。

```text
IronSource.instance.loadBanner(IronSourceBannerSize.BANNER, IronSource.POSITION_BOTTOM, YOUR_PLACEMENT_NAME);
```

`levelPlayBannerAdLoaded`を受け取り、アプリケーションにバナーが表示されます。

### バナーの非表示とディスプレイ##hide-&-display-banner

広告体験の柔軟性を最大限に高めるために、アプリケーション上のバナーの表示/非表示を切り替えることができるようになりました。

バナーをロードして配信したら、このバナーを非表示にして、後でアプリケーションで再表示することができます。

バナーを非表示にするには、この機能を呼び出します。

```text
IronSource.instance.hideBanner();
```

その後、同じバナーを再度表示するには、この機能を呼び出します。

```text
IronSource.instance.displayBanner();
```

## ステップ 3. バナー広告の破棄##step-3.-destroy-the-banner-ad

バナーが正常に配信されたら、以下の機能を呼び出して前のバナーを破棄することをお勧めします。

```text
IronSource.instance.destroyBanner();
```

このメソッドの呼び出し後は、該当するバナーは使用できません。再度バナーを使用する場合は、\[icode]loadBanner\[/icode] メソッドを使用して新しいバナーをリクエストする必要があります。

## ステップ 4. バナープロバイダーの統合##step-4.-integrate-a-banner-provider

次に、広告ネットワークアダプタを統合し、Unity LevelPlay Mediationを通じてバナーを提供します。

サポートされているネットワークと各ネットワークの bannerSize の動作については、以下を参照してください。

### **バナーサポート**##**banner-support**

|                                                                                                          | バナー    | 大規模    | 矩形 | スマート        |
| -------------------------------------------------------------------------------------------------------- | ------ | ------ | -- | ----------- |
| **ironSource**                                                                                           | Banner | large  |    | バナー/リーダーボード |
| [**AppLovin**](https://dash.applovin.com/docs/integration#androidBanners)                                | Banner | Banner | 矩形 | バナー/リーダーボード |
| [**デジタルタービン**](https://developer.digitalturbine.com/hc/en-us/articles/360013580478-Android-Ad-Formats)   | Banner | Banner | 矩形 | バナー/リーダーボード |
| [**Google**](https://developers.google.com/admob/android/banner#banner_sizes)                            | Banner | 大\*    | 矩形 | バナー/リーダーボード |
| [**メタオーディエンスネットワーク**](https://developers.facebook.com/docs/audience-network/android-banners#bannersizes) | Banner | large  | 矩形 | バナー/リーダーボード |
| [**UnityAds**](/grow/ads/ios-sdk/banner-ads.md)                                                          | Banner | Banner | -  | リーダーボード     |
| [**Vungle**](https://support.vungle.com/hc/en-us/articles/360002925791#integrate-banner-ads-0-22)        | Banner | Banner | 矩形 | バナー/リーダーボード |

[インテグレーションヘルパー](/grow/levelplay/sdk/unity/integration-helper.md) とのインテグレーションを確認します。

## 次のステップ##next-steps

インテグレーション ガイドに従って、追加の広告ユニットを統合します。

* [動画リワード](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md)
* [Interstitial (インタースティシャル)](/grow/levelplay/sdk/adobe/interstitial-integration.md)

サポート対象の[メディエーションネットワーク](/grow/levelplay/sdk/unity/mediation-networks.md)も参照してください。
