对滚动显示的横幅广告使用内嵌自适应功能

请选择平台： Android iOS Flutter Android（旧版）

采用自适应横幅广告，您可以指定广告宽度，从而为每台设备确定最理想的广告尺寸。与锚定自适应横幅广告不同，内嵌自适应横幅广告的尺寸更大、高度更高，并且采用的并非固定高度。内嵌自适应横幅广告的高度是可变的。这些横幅广告既可以铺满整个屏幕，也可以限制在您指定的最高高度之内。

本指南介绍了如何创建内嵌自适应横幅广告以及如何设置横幅广告尺寸。

下图展示了内嵌自适应横幅广告在滚动内容中的呈现效果：

此图显示了自适应横幅广告与内嵌自适应横幅广告之间的区别

准备工作

在继续操作之前，请确保您已设置横幅广告。

如需查看完整的内嵌自适应横幅广告示例，请下载以下示例应用：

植入内嵌自适应横幅广告

如需植入内嵌自适应横幅广告，您需要设置广告尺寸、创建广告请求并加载广告。

如需确定内嵌自适应横幅广告的尺寸，请先确定广告宽度。常见方法包括：

  • 使用全屏宽度。
  • 使用包含广告的父布局的宽度。
  • 根据设备安全区域调整宽度。

创建广告尺寸对象时，请使用此计算出的宽度。

以下示例设置了广告尺寸、创建了广告请求并加载了广告：

Kotlin

private fun loadInlineAdaptiveBannerAd(adView: AdView, activity: Activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val bannerWidth = 320
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Inline adaptive banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Inline adaptive banner ad failed to load: $adError")
      }
    },
  )
}

Java

private void loadInlineAdaptiveBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  int bannerWidth = 320;
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Inline adaptive banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Inline adaptive banner ad failed to load: " + adError);
        }
      });
}

将 AD_UNIT_ID 替换为您的广告单元 ID。

设置小于或等于设备屏幕尺寸的广告尺寸。 如需确定屏幕大小上限，请使用 Resources.getDisplayMetrics 方法。AdSize 对象尺寸使用密度无关像素 (dp)。在进行比较时，请将屏幕尺寸从像素转换为 dp。 如需详细了解尺寸限制，请参阅在 Ad Manager 中针对广告空缺的展示进行问题排查。

如果您需要更新或创建订单项以使用自适应横幅广告，请参阅为自适应横幅广告设置订单项。

根据应用布局设置内嵌自适应横幅广告

若要在特定布局中预加载内嵌自适应横幅广告，请使用以下方法：

如果您的应用同时支持纵向和横向视图，且您希望按照当前布局预加载自适应横幅广告，请使用 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) 方法。此方法用于在当前布局中加载广告。

限制内嵌自适应横幅广告的高度

默认情况下，如果内嵌自适应横幅广告在创建时未指定 maxHeight 值，其高度上限会等于设备高度。若要限制内嵌自适应横幅广告的高度，请使用 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) 方法。