横幅广告会占据应用版式中的一处位置,要么是设备屏幕的顶部,要么是底部。用户与应用互动时,这类广告会停留在屏幕上,并且可在一段时间后自动刷新。
本指南旨在帮助您上手使用锚定自适应横幅广告。锚定自适应横幅广告会按照您指定的广告宽度,针对每台设备优化广告尺寸。
锚定自适应横幅广告是固定宽高比广告,而不是固定尺寸广告。其宽高比大致为 320x50。指定可用的全宽后,Google 移动广告 SDK 就会返回一个高度最适合该宽度的广告。广告的最适合高度在不同的广告请求中保持不变;当广告刷新时,广告周围的内容会保持原位。
务必用测试广告进行测试
在构建和测试应用时,请确保使用的是测试广告,而不是实际投放的广告。否则,可能会导致您的账号被中止。
对于横幅广告,加载测试广告最简便的方法就是使用我们的专用测试广告单元 ID:
Android
ca-app-pub-3940256099942544/9214589741
iOS
ca-app-pub-3940256099942544/2435281174
这些测试广告单元 ID 已经过配置,可确保每个请求返回的都是测试广告。您可以在自己应用的编码、测试和调试过程中随意使用这些测试广告单元 ID。只需确保在发布应用前用您自己的广告单元 ID 替换这些测试广告单元 ID 即可。
获取广告尺寸
若要请求符合广告尺寸要求的横幅广告,请按以下步骤操作:
使用
MediaQuery.of(context)
获取设备屏幕的宽度(以密度无关像素 [dp] 为单位)。如果您不想使用全屏宽度,可以自行设置宽度。使用
AdSize
类中的相应静态方法来获取AdSize
对象。例如,使用AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width)
可获取适合当前屏幕方向的广告尺寸。
// Get an AnchoredAdaptiveBannerAdSize before loading the ad.
final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
MediaQuery.sizeOf(context).width.truncate(),
);
加载广告
下例加载了一个横幅广告:
void _loadAd() async {
// Get an AnchoredAdaptiveBannerAdSize before loading the ad.
final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
MediaQuery.sizeOf(context).width.truncate(),
);
if (size == null) {
// Unable to get width of anchored banner.
return;
}
BannerAd(
adUnitId: _adUnitId,
request: const AdRequest(),
size: size,
listener: BannerAdListener(
onAdLoaded: (ad) {
// Called when an ad is successfully received.
debugPrint("Ad was loaded.");
setState(() {
_bannerAd = ad as BannerAd;
});
},
onAdFailedToLoad: (ad, err) {
// Called when an ad request failed.
debugPrint("Ad failed to load with error: $err");
ad.dispose();
},
),
).load();
}
横幅广告事件
通过使用 BannerAdListener
,您可以监听各种广告生命周期事件,例如广告何时加载。下例实现了每个方法,并在控制台中记录了一条消息:
onAdOpened: (Ad ad) {
// Called when an ad opens an overlay that covers the screen.
debugPrint("Ad was opened.");
},
onAdClosed: (Ad ad) {
// Called when an ad removes an overlay that covers the screen.
debugPrint("Ad was closed.");
},
onAdImpression: (Ad ad) {
// Called when an impression occurs on the ad.
debugPrint("Ad recorded an impression.");
},
onAdClicked: (Ad ad) {
// Called when an a click event occurs on the ad.
debugPrint("Ad was clicked.");
},
onAdWillDismissScreen: (Ad ad) {
// iOS only. Called before dismissing a full screen view.
debugPrint("Ad will be dismissed.");
},
刷新广告
如果您已为广告单元配置刷新功能,则在广告加载失败时无需再请求另一个广告。Google 移动广告 SDK 会按照您在 AdMob 界面中指定的任何频率进行刷新。如果您尚未启用刷新功能,则需发出新的请求。如需详细了解广告单元刷新(例如如何设置刷新频率),请参阅为横幅广告使用自动刷新功能。
展示横幅广告
若要以 widget 形式展示 BannerAd
,您必须在调用 load()
之后实例化含有受支持广告的 AdWidget
。您可以在调用 load()
之前创建 widget,但必须先调用 load()
,然后才能将该 widget 添加到 widget 树中。
AdWidget
继承自 Flutter 的 Widget 类,可以像其他任何 widget 一样使用。在 iOS 中,请确保将该 widget 放置在具有指定宽度和高度的 widget 中。否则,您的广告可能不会展示。BannerAd
可以放置在尺寸与该广告匹配的容器中:
if (_bannerAd != null)
Align(
alignment: Alignment.bottomCenter,
child: SafeArea(
child: SizedBox(
width: _bannerAd!.size.width.toDouble(),
height: _bannerAd!.size.height.toDouble(),
child: AdWidget(ad: _bannerAd!),
),
),
),
如果不再需要访问广告,必须对其进行处置。关于何时调用 dispose()
,最佳做法是在将 AdWidget
从 widget 树中移除后调用,或在 BannerAdListener.onAdFailedToLoad()
回调函数中调用。
大功告成!您的应用现在就可以展示横幅广告了。
Android 9 及更低版本中的滚动限制
我们注意到,对于运行 Android 9 或更低版本的部分旧设备或性能较差的设备,在滚动视图中展示内嵌横幅广告时,可能会出现效果欠佳的情况。因此,我们建议仅在 Android 10 或更高版本上使用这些类型的横幅广告。固定位置的横幅广告(如锚定横幅广告)不会受到影响,并且可在所有 Android API 级别上使用,同时实现理想的效果。
GitHub 上的完整示例
如需查看本页中介绍的横幅广告植入的完整示例,请参阅 banner_example。
了解其他类型的横幅广告
熟悉本部分中为 Flutter 应用定义的其他类型的横幅广告。
内嵌自适应横幅广告
内嵌自适应横幅广告的高度可变,与锚定自适应横幅广告相比,其尺寸更大、高度更高。对于在可滚动内容中放置横幅广告的应用,建议使用内嵌自适应横幅广告,而不是锚定自适应横幅广告。如需了解详情,请参阅内嵌自适应横幅广告。
折叠式横幅广告
折叠式横幅广告最初会以较大的叠加层形式展示,并提供一个可将广告折叠为较小尺寸的按钮。您可以考虑使用这种横幅广告来进一步提升效果。如需了解详情,请参阅折叠式横幅广告。