原生样式

请选择平台: Android iOS Flutter

原生样式设置可让 Google Ad Manager 根据您在相应产品中指定的原生样式来处理原生广告的呈现工作。首先,您需要指定尺寸和定位条件。然后,添加 HTML、CSS 和 JavaScript,以定义能够在所有屏幕上呈现优质展示效果的自适应广告。您无需承担任何广告呈现工作;Ad Manager 会自动应用适合在目标位置展示的原生样式。原生样式的实现方式与横幅广告一样,都是使用 AdManagerAdView。它们既可与预先确定的固定广告尺寸搭配使用,也可与在运行时确定的自适应广告尺寸搭配使用。

前提条件

  • Google 移动广告 Flutter 插件 0.13.6 版或更高版本

本指南假定您已经掌握了一些 Google 移动广告 SDK 应用知识。如果没有的话,不妨先通读我们的入门指南。

固定尺寸

具有固定尺寸的原生样式可让您控制原生广告的宽度和高度。如需设置固定尺寸,请按以下步骤操作:

  1. 在 Ad Manager 界面中创建订单项,然后从 Size 字段下拉菜单中选择一个预定义尺寸。

  2. 加载与您在第 1 步中设置的尺寸相同的 AdManagerBannerAd。如需了解如何实例化和加载广告,请参阅横幅广告文档。您可以在横幅广告尺寸部分中查看尺寸列表以及各种尺寸对应的 AdSize 常量。

以下示例展示了如何指定固定尺寸,例如 MEDIUM_RECTANGLE (300x250) 广告尺寸:

AdManagerBannerAd ad = AdManagerBannerAd(
  adUnitId: '<your-ad-unit>',
  sizes: <AdSize>[AdSize.mediumRectangle],
  request: AdManagerAdRequest(),
);

自适应尺寸

在某些情况下,固定尺寸可能不适用。例如,您可能希望广告的宽度与应用内容的宽度保持一致,但又需要其高度根据广告内容进行动态调整。为了处理这种情况,您可以在 Ad Manager 界面中将广告尺寸指定为 Fluid,这表示广告尺寸将在应用的运行时确定。SDK 提供了一个特殊的 AdSize 常量 FLUID 来处理这种情况。自适应广告尺寸的高度会根据发布商定义的宽度动态确定,从而使平台广告视图能够调整其高度以与广告素材的高度相匹配。

自适应广告请求

使用 FluidAdManagerBannerAd 请求自适应广告:

final fluidAd = FluidAdManagerBannerAd(
  adUnitId: '<your-ad-unit>',
  request: AdManagerAdRequest(),
  listener: AdManagerBannerAdListener(
    onAdLoaded: (Ad ad) {
      print('$_fluidAd loaded.');
    },
    onAdFailedToLoad: (Ad ad, LoadAdError error) {
      print('$_fluidAd failedToLoad: $error');
      ad.dispose();
    },
  ),

展示自适应广告

加载广告后,使用 FluidAdWidget 来展示自适应广告。它会调整自身的高度,以与底层平台广告视图相匹配:

FluidAdWidget(
  width: <your-width>,
  ad: fluidAd,
);

如需查看 Ad Manager 自适应广告尺寸的实现示例,请参见 GitHub 上的示例应用。