# Adobe AIR 横幅集成

> 通过初始化 SDK、在初始化后创建横幅广告对象以及设置适当的广告大小和位置来集成横幅广告服务。

横幅是由系统启动的矩形广告服务，可以是静态广告，也可以是动画广告，并在实时 app 内容周围的指定区域提供。

通过 Unity LevelPlay 集成横幅广告服务并完成以下步骤：

1. **实现横幅事件**
2. **加载横幅广告**
3. **销毁横幅广告**
4. **集成横幅提供商**

## 先决条件##prerequisites

* 确保已将 ironSource Air Plugin 正确集成到应用程序中。[此处](/grow/levelplay/sdk/adobe/air-plugin-integration.md)概述了集成。
* 将我们的聚合适配器之一与横幅支持集成以投放此广告单元。

## 步骤 1.实现横幅事件##step-1.-implement-the-banner-events

ironSource Air Plugin 会触发多个事件来通知您广告的可用性和活动。要监听任何事件，请调用以下方法：

```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

加载横幅时，请确保配置横幅大小和位置：

| **大小**            | **描述**                               | **维度**                                    | **广告网络支持**                                                                |
| ----------------- | ------------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------- |
| BANNER            | 最适合手机和平板电脑的标准横幅                      | 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     | 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`，横幅将显示在您的 app 上。

### 隐藏和显示横幅##hide-&-display-banner

为了在广告体验中提供最大的灵活性，您现在可以在 app 上隐藏和显示横幅。

加载并投放横幅广告后，可以选择隐藏此横幅广告并在稍后在 app 中重新显示。

要隐藏横幅，请调用以下函数：

```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**

|                                                                                                                | BANNER | 大型       | 矩形   | SMART  |
| -------------------------------------------------------------------------------------------------------------- | ------ | -------- | ---- | ------ |
| **ironSource**                                                                                                 | 横幅广告   | Large（大） |      | 横幅/排行榜 |
| [**AppLovin**](https://dash.applovin.com/docs/integration#androidBanners)                                      | 横幅广告   | 横幅广告     | 中等矩形 | 横幅/排行榜 |
| [**数字涡轮**](https://developer.digitalturbine.com/hc/en-us/articles/360013580478-Android-Ad-Formats)机            | 横幅广告   | 横幅广告     | 中等矩形 | 横幅/排行榜 |
| [**谷歌**](https://developers.google.com/admob/android/banner#banner_sizes)                                      | 横幅广告   | 大\*      | 中等矩形 | 横幅/排行榜 |
| [**Meta Audience Network**](https://developers.facebook.com/docs/audience-network/android-banners#bannersizes) | 横幅广告   | Large（大） | 中等矩形 | 横幅/排行榜 |
| [**UnityAds**](/grow/ads/ios-sdk/banner-ads.md)                                                                | 横幅广告   | 横幅广告     | -    | 排行榜    |
| [**旺格尔**](https://support.vungle.com/hc/en-us/articles/360002925791#integrate-banner-ads-0-22)                 | 横幅广告   | 横幅广告     | 中等矩形 | 横幅/排行榜 |

验证您与我们的 [Integration Helper](/grow/levelplay/sdk/unity/integration-helper.md) 的集成。

## 后续步骤##next-steps

按照我们的集成指南集成其他广告单位：

* [奖励视频](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md)
* [插页式视频](/grow/levelplay/sdk/adobe/interstitial-integration.md)

另请参阅我们支持的 [Mediation Networks](/grow/levelplay/sdk/unity/mediation-networks.md)。