内嵌自适应横幅广告

借助自适应横幅广告，您可以指定广告的宽度，以确定最佳广告尺寸。自适应横幅广告还可针对每台设备优化广告尺寸，从而最大限度地提升广告效果。此方法可提升性能。

与锚定自适应横幅广告相比，内嵌自适应横幅广告是一种更大、更高的横幅广告，使用的是可变高度而非固定高度。内嵌自适应横幅广告的高度可变，可能会占据整个屏幕，也可能会占据您指定的最大高度。

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

显示自适应横幅广告和内嵌自适应横幅广告差异的图表

准备工作

继续操作之前，请确保您已完成入门指南：横幅广告。

植入自适应横幅广告

与锚定自适应横幅广告不同，内嵌适配器横幅广告使用内嵌自适应横幅广告尺寸进行加载。要创建内嵌自适应广告尺寸，请完成以下步骤：

  1. 获取所用设备的宽度，或者自行设置宽度（如果您不想使用屏幕的全宽）。
  2. 针对广告尺寸类使用相应的静态方法（例如 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width)），获取与所选屏幕方向对应的内嵌自适应广告尺寸对象。
  3. 如果您想限制横幅广告的高度，请使用静态方法 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight)。

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

Java

// Step 1: Create an inline adaptive banner ad size using the activity context.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
AdManagerAdView bannerView = new AdManagerAdView(this);
bannerView.setAdUnitId("ad unit ID");

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER);

// Step 3: Load an ad.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
bannerView.loadAd(adRequest);
// TODO: Insert banner view in list view or scroll view, etc.

Kotlin

// Step 1: Create an inline adaptive banner ad size using the activity context.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
val bannerView = AdManagerAdView(this)
bannerView.adUnitId = "ad unit ID"

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER)

// Step 3: Load an ad.
val adRequest = AdManagerAdRequest.Builder().build()
bannerView.loadAd(adRequest)
// TODO: Insert banner view in list view or scroll view, etc.

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

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

内嵌自适应横幅广告尺寸的方向

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

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

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

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

其他资源

GitHub 上的示例

下载示例应用，查看内嵌自适应横幅广告的实际效果。

Java Kotlin