> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# App Open 广告

> 在 Android 应用中集成 CloudX App Open 广告

App Open 广告是全屏广告位，适用于应用回到前台等场景，例如用户将应用切到后台后再次返回。

#### 支持的网络

App Open 需求由以下竞价网络提供：

| 网络        | 适配器                                                  |
| --------- | ---------------------------------------------------- |
| Mintegral | [Mintegral](/zh/android/adapters/mintegral/overview) |
| Pangle    | [Pangle](/zh/android/adapters/pangle/overview)       |
| Vungle    | [Vungle](/zh/android/adapters/vungle/overview)       |

[Google Mobile Ads waterfall 适配器](/zh/android/adapters/googlewaterfall/overview)同样支持 App Open 广告位，用于 AdMob waterfall 流量。

<CodeGroup>
  ```kotlin Kotlin theme={null}
  class MainActivity : AppCompatActivity(), CloudXAppOpenListener, CloudXAdRevenueListener {
      private lateinit var appOpenAd: CloudXAppOpenAd

      private fun createAppOpenAd() {
          appOpenAd = CloudX.createAppOpen(this, "your-app-open-ad-unit-id")
          appOpenAd.listener = this
          appOpenAd.revenueListener = this
          appOpenAd.load()
      }

      private fun showAppOpenAd() {
          if (appOpenAd.isAdReady) {
              appOpenAd.show(this, "app_foreground")
          }
      }

      // CloudXAppOpenListener callbacks
      override fun onAdLoaded(cloudXAd: CloudXAd) {
          Log.d("CloudX", "App Open ad loaded from ${cloudXAd.networkName}")
      }

      override fun onAdLoadFailed(adUnitId: String, cloudXError: CloudXError) {
          Log.e("CloudX", "App Open ad failed to load: ${cloudXError.message}")
      }

      override fun onAdDisplayed(cloudXAd: CloudXAd) {
          Log.d("CloudX", "App Open ad displayed")
      }

      override fun onAdDisplayFailed(cloudXAd: CloudXAd, cloudXError: CloudXError) {
          Log.e("CloudX", "App Open ad failed to display: ${cloudXError.message}")
          appOpenAd.load()
      }

      override fun onAdHidden(cloudXAd: CloudXAd) {
          appOpenAd.load()
      }

      override fun onAdClicked(cloudXAd: CloudXAd) {}

      // CloudXAdRevenueListener callback
      override fun onAdRevenuePaid(cloudXAd: CloudXAd) {
          Log.d("CloudX", "App Open bid-time revenue: ${cloudXAd.revenue}")
      }

      override fun onDestroy() {
          super.onDestroy()
          appOpenAd.destroy()
      }
  }
  ```
</CodeGroup>

请谨慎使用 App Open 广告，仅在自然的应用打开或回到前台转场中展示。避免在用户已经与应用内容交互时展示。