锚定自适应横幅广告

自适应横幅广告是新一代自适应广告，可针对每台设备优化广告尺寸，从而最大限度地提升广告效果。自适应横幅广告在仅支持固定高度的智能横幅广告的基础上进行了改进，允许您指定广告宽度，并据此确定最佳广告尺寸。

为了选择最佳广告尺寸，自适应横幅广告使用固定宽高比，而不是固定高度。因此，这种横幅广告在不同设备上占据的屏幕区域更为一致，也带来了提升广告效果的机会。

请注意，使用自适应横幅广告时，针对给定设备和宽度返回的广告尺寸将始终固定不变。在给定设备上测试布局后，便可以确定广告尺寸不会发生变化。不过，横幅广告素材的尺寸在不同设备上可能会有所不同。因此，我们建议您在广告布局中考虑到广告高度的变化。在极少数情况下，系统可能填不满整个自适应尺寸，此时，标准尺寸广告素材会改为在此广告位居中显示。

前提条件

何时使用自适应横幅广告

自适应横幅广告可直接取代符合业界标准的 320x50 横幅广告尺寸及智能横幅广告格式。

这些横幅广告尺寸通常用于锚定横幅广告，锚定横幅广告通常固定在屏幕顶部或底部。

对于此类锚定横幅广告，当使用自适应横幅广告时，宽高比与标准 320x50 广告的宽高比相似，如以下三个示例所示：


320x50 横幅广告
自适应横幅广告
智能横幅广告

自适应横幅广告可以更好地利用可用的屏幕尺寸。此外，与智能横幅广告相比，自适应横幅广告是更好的选择，原因如下：

  • 这种广告采用您提供的任意宽度（而不是强制宽度为全屏），以便您能够考虑到 iOS 上的安全区域和 Android 上的刘海屏。

  • 它会针对特定设备选择最佳高度，而不是在不同尺寸的设备上保持固定的高度，从而降低设备屏幕尺寸多样造成的影响。

实现说明

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

  • 您必须知道要在其中展示广告的视图的宽度，并且应该考虑到设备宽度以及任何适用的安全区域或刘海屏。
  • 您可能需要更新或创建新订单项来使用自适应尺寸。 了解详情。
  • 当投放尺寸较小的广告无法填满广告位时，请确保广告视图背景是不透明的，以符合 AdMob 政策。
  • 确保您使用的是最新版 Google 移动广告 Flutter 插件。
  • 按照自适应横幅广告尺寸的设计，占满可用宽度时效果最佳。在大多数情况下，这里指的是所用设备的屏幕全宽。请务必考虑适用的安全区域。
  • 使用自适应 AdSize API 时，Google 移动广告 SDK 会根据给定宽度，利用经过优化的广告高度调整横幅广告的尺寸。
  • 可通过以下两种方法获取自适应广告的广告尺寸：AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width)（用于请求特定的屏幕方向）和 AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width)（用于执行操作时的屏幕方向）。
  • 在给定设备上针对给定宽度返回的广告尺寸始终相同，因此在给定设备上测试布局后，就可以确定广告尺寸不会发生变化。
  • 锚定横幅广告的高度始终不会超过设备高度的 15% 或 90 密度无关像素（以二者中的较小者为准），也始终不小于 50 密度无关像素。

快速入门

若要植入简单的锚定自适应横幅广告，请按照以下步骤操作。

  1. 获取自适应横幅广告尺寸。您获取的尺寸将用于请求自适应横幅广告。要获取自适应广告尺寸，请务必执行以下操作：
    1. 获取所用设备的宽度（以密度无关像素为单位），或者自行设置宽度（如果您不想使用屏幕的全宽）。您可以使用 MediaQuery.of(context) 获取屏幕宽度。
    2. 针对广告尺寸类使用相应的静态方法（例如 AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width)），以获取适用于当前屏幕方向的自适应 AdSize 对象。
  2. 使用广告单元 ID、自适应广告尺寸和广告请求对象创建 AdManagerBannerAd 对象。
  3. 像加载常规横幅广告一样加载广告，然后通过 AdWidget 展示，就像加载常规广告视图一样。

代码示例

下面的 widget 示例会加载锚定自适应横幅广告，以适应屏幕宽度：

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:google_mobile_ads/google_mobile_ads.dart';

/// This example demonstrates anchored adaptive banner ads.
class AnchoredAdaptiveExample extends StatefulWidget {
  @override
  _AnchoredAdaptiveExampleState createState() =>
      _AnchoredAdaptiveExampleState();
}

class _AnchoredAdaptiveExampleState extends State<AnchoredAdaptiveExample> {
  AdManagerBannerAd? _anchoredAdaptiveAd;
  bool _isLoaded = false;

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    _loadAd();
  }

  Future<void> _loadAd() async {
    // Get an AnchoredAdaptiveBannerAdSize before loading the ad.
    final AnchoredAdaptiveBannerAdSize? size =
        await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
            MediaQuery.of(context).size.width.truncate());

    if (size == null) {
      print('Unable to get height of anchored banner.');
      return;
    }

    _anchoredAdaptiveAd = AdManagerBannerAd(
      // TODO: replace with your own ad unit.
      adUnitId: '<your-ad-unit>',
      sizes: [size],
      request: AdManagerAdRequest(),
      listener: AdManagerBannerAdListener(
        onAdLoaded: (Ad ad) {
          print('$ad loaded: ${ad.responseInfo}');
          setState(() {
            // When the ad is loaded, get the ad size and use it to set
            // the height of the ad container.
            _anchoredAdaptiveAd = ad as AdManagerBannerAd;
            _isLoaded = true;
          });
        },
        onAdFailedToLoad: (Ad ad, LoadAdError error) {
          print('Anchored adaptive banner failedToLoad: $error');
          ad.dispose();
        },
      ),
    );
    return _anchoredAdaptiveAd!.load();
  }

  @override
  Widget build(BuildContext context) => Scaffold(
        appBar: AppBar(
          title: Text('Anchored adaptive banner example'),
        ),
        body: Center(
          child: Stack(
            alignment: AlignmentDirectional.bottomCenter,
            children: <Widget>[
              ListView.separated(
                  padding: const EdgeInsets.symmetric(horizontal: 16.0),
                  itemBuilder: (context, index) {
                    return Text(
                      'Placeholder text',
                      style: TextStyle(fontSize: 24),
                    );
                  },
                  separatorBuilder: (context, index) {
                    return Container(height: 40);
                  },
                  itemCount: 20),
              if (_anchoredAdaptiveAd != null && _isLoaded)
                Container(
                  color: Colors.green,
                  width: _anchoredAdaptiveAd!.size.width.toDouble(),
                  height: _anchoredAdaptiveAd!.size.height.toDouble(),
                  child: AdWidget(ad: _anchoredAdaptiveAd!),
                )
            ],
          ),
        ),
      );

  @override
  void dispose() {
    super.dispose();
    _anchoredAdaptiveAd?.dispose();
  }
}

在本示例中，函数 AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize 用于获取当前界面方向的锚定位置上的横幅广告尺寸。如需按给定屏幕方向预加载锚定横幅广告，请使用 AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) 并传递所需的屏幕方向。