折叠式横幅广告
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
折叠式横幅广告是一种横幅广告,最初会以较大的叠加层形式展示,并提供一个可将其收起为原始请求的横幅广告尺寸的按钮。折叠式横幅广告旨在提升尺寸较小的锚定广告的效果。本指南介绍了如何为现有横幅展示位置启用可收起的横幅广告。

前提条件
实现
请确保横幅广告视图的定义尺寸与您希望用户在常规(已收起)横幅广告状态下看到的尺寸一致。在广告请求中添加 extras 参数,将 collapsible
作为键,并将广告的展示位置作为值。
可收起的展示位置用于定义展开区域如何锚定到横幅广告。
Placement 值
|
行为 |
预期用例 |
top |
展开式广告的顶部与收起式广告的顶部对齐。 |
广告位于屏幕顶部。 |
bottom |
展开的广告底部与收起的广告底部对齐。 |
广告位于屏幕底部。 |
如果所加载的广告是可收起的横幅广告,则该横幅广告在放置到视图层次结构中后,会立即显示可收起的叠加层。
void _loadAd() async {
// Replace these test ad units with your own ad units.
final String adUnitId = Platform.isAndroid
? 'ca-app-pub-3940256099942544/2014213617'
: 'ca-app-pub-3940256099942544/8388050270';
// Get the size before loading the ad.
final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
MediaQuery.sizeOf(context).width.truncate());
if (size == null) {
// Unable to get the size.
return;
}
// Create an extra parameter that aligns the bottom of the expanded ad to the
// bottom of the banner ad.
const adRequest = AdRequest(extras: {
"collapsible": "bottom",
});
BannerAd(
adUnitId: adUnitId,
request: adRequest,
size: size,
listener: const BannerAdListener()
).load();
}
广告刷新行为
对于在 Ad Manager 网页界面中为横幅广告配置自动刷新的应用,当为横幅广告位请求折叠式横幅广告时,后续的广告刷新不会再请求折叠式横幅广告。这是因为,在每次刷新时都显示折叠式横幅广告可能会对用户体验产生负面影响。
如果您想在会话中的稍晚时间再加载一个折叠式横幅广告,可以使用包含 collapsible 参数的请求手动加载广告。
折叠式横幅广告仅适用于 Google 需求来源。通过中介投放的广告会显示为常规的不可收起的横幅广告。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-04-18。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-04-18。"],[[["Collapsible banner ads initially appear larger and can be collapsed to a standard banner size, improving anchored ad performance."],["To enable, include an extra parameter in the ad request with `collapsible` as the key and `top` or `bottom` as the value to specify the expanded ad's alignment."],["Collapsible banners only support Google demand; ads served through mediation will display as regular banners."],["Ads refreshing is automatically configured to avoid repeated collapsible banners, improving user experience."],["For manual control, load an ad with the collapsible parameter to re-enable a collapsible banner ad later in the session."]]],["Collapsible banner ads, which enhance smaller anchored ads, display as a larger overlay initially and then collapse to the defined size. To implement, ensure the banner view is sized for the collapsed state and include an \"extras\" parameter with \"collapsible\" set to \"top\" or \"bottom\" for placement. Subsequent ad refreshes won't be collapsible unless manually requested. Collapsible banners are limited to Google demand, with mediated ads appearing as standard banners.\n"]]