# Adobe AIR 的插页式广告集成

> 使用 LevelPlay SDK（包括事件监听器和广告放置/位置配置）将插页式广告服务集成到 Adobe AIR 应用程序中。

完成几个简单步骤即可开始使用 Interstitial Ad Unit：

1. **实现监听器**
2. **加载插页式广告**
3. **检查广告可用性**
4. ****显示插页式广告****

## 先决条件##prerequisites

确保已正确集成 ironSource Adobe AIR 插件。[此处](/grow/levelplay/sdk/adobe/air-plugin-integration.md)概述了集成。

## 步骤 1.实现 Interstitial 监听器##step-1.-implement-the-interstitial-listener

ironSource Adobe AIR 插件会触发多个事件来通知您 Interstitial Activity。要接收这些事件，必须实现 Interstitial EventListener：

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

* **EventName** = 包含要监听的事件的字符串。
* **functionToCal**l = 触发事件时要调用的函数。

ironSource Adobe AIR 插件将通知您的监听器以下列出的所有可能事件：

```java
IronSource.instance.addEventListener("levelPlayInterstitialAdReady", levelPlayInterstitialAdReady);
IronSource.instance.addEventListener("levelPlayInterstitialAdLoadFailed", levelPlayInterstitialAdLoadFailed);
IronSource.instance.addEventListener("levelPlayInterstitialAdOpened", levelPlayInterstitialAdOpened);
IronSource.instance.addEventListener("levelPlayInterstitialAdShowSucceeded", levelPlayInterstitialAdShowSucceeded);
IronSource.instance.addEventListener("levelPlayInterstitialAdShowFailed", levelPlayInterstitialAdShowFailed);
IronSource.instance.addEventListener("levelPlayInterstitialAdClicked", levelPlayInterstitialAdClicked);
IronSource.instance.addEventListener("levelPlayInterstitialAdClosed", levelPlayInterstitialAdClosed);
```

插件将通知监听器以下列出的所有可能事件：

```java
private function levelPlayInterstitialAdClosed(event:Event):void {
   //level Play Interstitial Ad Closed
}
private function levelPlayInterstitialAdClicked(event:Event):void {
   //level Play Interstitial Ad Clicked
}
private function levelPlayInterstitialAdShowFailed(event:Event):void {
   //level Play Interstitial Ad Show Failed
}
private function levelPlayInterstitialAdShowSucceeded(event:Event):void {
   //on Ad Show level Play Interstitial Ad Show Succeeded
}
private function levelPlayInterstitialAdOpened(event:Event):void {
   //on Ad level Play Interstitial Ad Opened
}
private function levelPlayInterstitialAdLoadFailed(event:Event):void {
   //level Play Interstitial Ad Load Failed
}
private function levelPlayInterstitialAdReady(event:Event):void {
   //level Play Interstitial Ad Ready
}

```

* ****onAdlevelPlayInterstitialAdOpenedOpened**** 事件传达广告格式已占据 app 屏幕，但不表示广告已成功送达您的终端用户。
* **onAdShowlevelPlayInterstitialAdShowSucceeded** 事件将来自 IronSource 或任何其他广告网络的插页式广告成功送达您的终端用户。
* Ironsource 提供了一种报错代码机制，可帮助您了解在集成或实际生产过程中可能运行的错误。按如下方式从 DataEvent 对象中提取报错数据：

  ```java
  var errorCode:String;
  var errorDescription:String;
                  
  if(event.data){
     var error:Object = JSON.parse(event.data);
     errorDescription = error.error_description;
     errorCode = error.error_code;
  }
  ```

  请参阅[此处](/grow/levelplay/sdk/ios/advanced-settings.md)关于 ironSource 报错代码的完整描述。

> **Note:**
>
> 不要假设回调始终在主线程上运行。在执行之前，需要将 IronSource 回调产生的任何 UI 交互或更新传递给主线程。

## 步骤 2.加载 Interstitial Ad##step-2.-load-interstitial-ad

我们建议您在计划向用户展示 Interstitial Ad 之前稍后申请，因为加载过程可能需要时间。要请求插页式广告，请调用以下方法：

```java
IronSource.instance.loadInterstitial();
```

> **Note:**
>
> 如果您想在应用程序中投放多个插页式广告服务，必须在显示**并关闭**上一个插页式广告后重复此步骤。触发 **levelPlayInterstitialAdClosed** 事件后，您将能够加载新的插页式广告。

## 步骤 3.检查广告可用性##step-3.-check-ad-availability

调用 **loadInterstitial** 后，系统会在广告加载并准备好向用户展示时通知您。**levelPlayInterstitialAdReady** 事件将通知您广告可用性。

```java
 private function levelPlayInterstitialAdReady(event:Event):void {
}
```

如果插页式广告不可用，您将收到 **levelPlayInterstitialAdLoadFailed** 事件：

```java
private function levelPlayInterstitialAdLoadFailed(event:Event):void {
}
```

## 步骤 4.显示 Interstitial##step-4.-show-an-interstitial

在有可用的插页后，可以通过调用以下方法向用户展示此广告：

```java
IronSource.instance.showInterstitial();
```

使用 ironSource Ad Placements，您可以自定义和优化 Interstitial 体验。此工具允许您在不同位置（例如，app 发布或关卡之间）向用户展示插页式广告服务。您可以使用以下函数来定义要展示广告的确切放置/位置。

```java
IronSource.instance.showInterstitial(YOUR_PLACEMENT_NAME);
```

除了 ironSource Ad Placements，现在还可以为所选广告位配置上限和节奏设置。限制和调整进度可通过限制定义时间范围内的广告服务量来改善 app 中的用户体验。

您现在可以在应用程序中投放插页式广告服务。

> **Note:**
>
> 如果这是应用程序的新集成，则应用程序默认情况下将处于 IronSource Dashboard 上的“**Test Mode**”。当 app 处于测试模式时， ironSourc SDK 将向主机打印更多日志，以便提供 SDK 进程的更大可见性。在启用实时广告库存之前，您将收到不会产生收入的测试广告系列。当 app 准备好进行实时广告库存时，请确保在 **广告单位** 页面上选择 **上线！**。

## 后续步骤##next-steps

请遵循我们的集成指南来实现其他广告单位：

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