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

前提条件
植入
请确保您的横幅广告视图是按照您希望用户在常规(已收起)横幅广告状态下看到的尺寸定义的。在广告请求中添加一个额外信息参数,其中 collapsible
为键,广告的展示位置为值。
可折叠展示位置定义了展开区域如何锚定到横幅广告。
Placement 值
|
行为 |
预期应用场景 |
top |
展开的广告顶部与折叠的广告顶部对齐。 |
广告位于屏幕顶部。 |
bottom |
展开的广告底部与折叠的广告底部对齐。 |
广告位于屏幕底部。 |
如果加载的广告是折叠式横幅广告,则在放置到视图层次结构中后,它会立即显示可折叠的叠加层。
private void LoadBannerAd()
{
var bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Bottom);
var adRequest = new AdRequest();
// Create an extra parameter that aligns the bottom of
// the expanded ad to the bottom of the bannerView.
adRequest.Extras.Add("collapsible", "bottom");
bannerView.LoadAd(adRequest);
}
广告刷新行为
针对在 AdMob 网页界面中为横幅广告配置了自动刷新功能的应用,我们设定了以下规则:当为某个横幅广告位成功请求一次折叠式横幅广告后,后续的自动刷新将不再请求此类型的广告。这是因为在每次刷新时都显示折叠式横幅广告可能会对用户体验产生负面影响。
如果您想在会话中的稍晚时间再加载一个折叠式横幅广告,可以使用包含 collapsible 参数的请求手动加载广告。
检查已加载的广告是否可折叠
为实现最佳广告效果,当您发起折叠式横幅广告请求时,系统有时也可能会返回一个非折叠式横幅广告。您可以通过调用 isCollapsible
来判断上一次加载的横幅广告是否为折叠式。如果当前广告请求失败,但上一次成功加载的横幅广告是折叠式的,那么此时调用这个 API 方法仍会返回 true。
_bannerView.OnBannerAdLoaded += () =>
{
Debug.Log(_bannerView.IsCollapsible()
? "Banner is collapsible."
: "Banner is not collapsible.");
};
折叠式横幅广告仅适用于 Google 需求来源。通过中介投放的广告会显示为常规的非折叠式横幅广告。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-25。
[null,null,["最后更新时间 (UTC):2025-08-25。"],[[["\u003cp\u003eCollapsible banner ads start as larger overlays and can be collapsed to a standard banner size, improving the performance of smaller, anchored ads.\u003c/p\u003e\n"],["\u003cp\u003eTo implement, define the collapsed banner size, and include an extra parameter in the ad request specifying the placement (top or bottom) for the expanded overlay.\u003c/p\u003e\n"],["\u003cp\u003eAuto-refresh is disabled for collapsible banner ads after the initial load to avoid impacting user experience; manually load them again with the collapsible parameter if needed.\u003c/p\u003e\n"],["\u003cp\u003eVerify if a loaded ad is collapsible using \u003ccode\u003eisCollapsible\u003c/code\u003e as non-collapsible ads might be served to ensure ad delivery.\u003c/p\u003e\n"],["\u003cp\u003eCurrently, only Google demand supports collapsible banner ads during the beta period; mediated ads will display as regular banners.\u003c/p\u003e\n"]]],["Collapsible banner ads expand from a smaller banner size to a larger overlay. To implement, define the desired collapsed banner size and include an \"extras\" parameter in the ad request with \"collapsible\" as the key and the ad's placement (\"top\" or \"bottom\") as the value. Expanded region anchors to the banner ad based on the specified placement. Subsequent ad refreshes won't be collapsible by default. Developers can check if the loaded ad is collapsible using `isCollapsible`. These ads are exclusive to Google demand.\n"],null,["Select platform: [Android](/admob/android/banner/collapsible \"View this page for the Android platform docs.\") [iOS](/admob/ios/banner/collapsible \"View this page for the iOS platform docs.\") [Unity](/admob/unity/banner/collapsible \"View this page for the Unity platform docs.\") [Flutter](/admob/flutter/banner/collapsible \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nCollapsible banner ads are banner ads that are initially presented as a larger\noverlay, with a button to collapse them to the originally requested banner size.\nCollapsible banner ads are intended to improve performance of anchored ads that\nare otherwise a smaller size. This guide shows how to turn on collapsible banner\nads for existing banner placements.\n\nPrerequisites\n\n- Complete the [banner ads get started guide](/admob/unity/banner).\n\nImplementation\n\nMake sure your banner view is defined with the size you would like users to see\nin the regular (collapsed) banner state. Include an extras parameter in the ad\nrequest with `collapsible` as the key and the placement of the ad as the value.\n\nThe collapsible placement defines how the expanded region anchors to the banner\nad.\n\n| `Placement` value | Behavior | Intended use case |\n|-------------------|-------------------------------------------------------------------------|-----------------------------------------------|\n| `top` | The top of the expanded ad aligns to the top of the collapsed ad. | The ad is placed at the top of the screen. |\n| `bottom` | The bottom of the expanded ad aligns to the bottom of the collapsed ad. | The ad is placed at the bottom of the screen. |\n\nIf the loaded ad is a collapsible banner, the banner shows the collapsible\noverlay immediately once it's placed in the view hierarchy.\n\n private void LoadBannerAd()\n {\n var bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Bottom);\n\n var adRequest = new AdRequest();\n\n // Create an extra parameter that aligns the bottom of\n // the expanded ad to the bottom of the bannerView.\n adRequest.Extras.Add(\"collapsible\", \"bottom\");\n\n bannerView.LoadAd(adRequest);\n }\n\n\u003cbr /\u003e\n\nAds refreshing behavior\n\nFor apps that configure auto-refresh for banner ads in the\nAdMob web interface, when a collapsible banner ad\nis requested for a banner slot, subsequent ad refreshes won't request\ncollapsible banner ads. This is because showing a collapsible banner on every\nrefresh could have a negative impact on user experience.\n\nIf you want to load another collapsible banner ad later in the session, you can\nload an ad manually with a request containing the collapsible parameter.\n\nCheck if a loaded ad is collapsible\n\nNon-collapsible banner ads are eligible to return for collapsible banner\nrequests to maximize performance. Call `isCollapsible` to check if the last\nbanner loaded is collapsible. If the request fails to load and the previous\nbanner is collapsible, the API returns true. \n\n _bannerView.OnBannerAdLoaded += () =\u003e\n {\n Debug.Log(_bannerView.IsCollapsible()\n ? \"Banner is collapsible.\"\n : \"Banner is not collapsible.\");\n };\n\n\nMediation\n\nCollapsible banner ads are only available for Google demand. Ads served through\nmediation show as normal, non-collapsible banner ads."]]