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

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

采用自适应横幅广告时，您可以指定广告宽度，以确定最优的广告尺寸。自适应横幅广告还可针对每种设备优化广告尺寸，从而最大限度地提升广告效果。此方法有助于提升广告效果。

与锚定自适应横幅广告相比，内嵌自适应横幅广告更大、更高，并且使用的是可变高度而非固定高度。内嵌自适应横幅广告的高度可变，可能占据整个屏幕，也可能只达到您指定的高度上限。

您可以将内嵌自适应横幅广告放置在滚动显示的内容中，示例如下：

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

准备工作

在继续操作之前，请确保您已通读横幅广告入门指南。

植入自适应横幅广告

以下示例演示了这些步骤：

Kotlin

private fun loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()

  // Step 2 - Load the ad.
  BannerAd.load(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // Assign the loaded ad to the BannerAd object.
        bannerAd = ad
        // Step 3 - Call BannerAd.getView() to get the View and add it
        // to view hierarchy on the UI thread.
        activity?.runOnUiThread {
          binding.bannerViewContainer.addView(ad.getView(requireActivity()))
        }
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        bannerAd = null
      }
    }
  )
}

Java

private void loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
      adSize).build();

  // Step 2 - Load the ad.
  BannerAd.load(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // Assign the loaded ad to the BannerAd object.
          bannerAd = ad;
          // Step 3 - Call BannerAd.getView() to get the View and add it
          // to view hierarchy on the UI thread.
          if (getActivity() != null) {
            getActivity()
                .runOnUiThread(() ->
                    binding.bannerViewContainer.addView(ad.getView(getActivity())));
          }
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          bannerAd = null;
        }
      });
}

在应用中植入自适应横幅广告时，请注意以下几点：

  • 按照内嵌自适应横幅广告尺寸的设计，占满可用宽度时效果最佳。在大多数情况下，该尺寸指的是所用设备的屏幕全宽，或者横幅广告父级内容的全宽。您必须知道要放置广告的视图的宽度、设备宽度、父级内容宽度以及适用的安全区域。
  • 您可能需要更新或创建新订单项才能采用自适应尺寸。了解详情。

根据屏幕方向调整内嵌自适应横幅广告尺寸

若要以特定屏幕方向预加载内嵌自适应横幅广告，请使用以下方法：

如果您的应用同时支持纵向视图和横向视图，并且您想以当前屏幕方向预加载自适应横幅广告，请使用 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width)。此方法会以当前屏幕方向加载广告。

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

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