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

前提条件
植入
确保为横幅广告视图指定的尺寸是您希望用户在常规(已折叠)横幅广告状态下看到的尺寸。在广告请求中添加一个 extras 参数,其中 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);
}
广告刷新行为
对于在 Ad Manager 网页界面中为横幅广告配置了自动刷新功能的应用,我们设定了以下规则:如果已针对横幅广告位请求加载折叠式横幅广告,那么后续广告刷新将不再请求加载此类广告。这是因为在每次刷新时都显示折叠式横幅广告可能会对用户体验造成负面影响。
如果您希望在会话的稍晚时间再加载一个折叠式横幅广告,可以使用包含 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-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[[["\u003cp\u003eCollapsible banner ads, initially larger overlays, collapse to the requested banner size, enhancing smaller anchored ad performance.\u003c/p\u003e\n"],["\u003cp\u003eTo implement, define your banner view's collapsed size and include an extra parameter in the ad request, specifying placement (\u003ccode\u003etop\u003c/code\u003e or \u003ccode\u003ebottom\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eWhile auto-refresh is configured, subsequent refreshes won't request collapsible banners to maintain user experience; manual loading is needed.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eisCollapsible\u003c/code\u003e to verify if the loaded banner is indeed collapsible, helpful when requests fail.\u003c/p\u003e\n"],["\u003cp\u003eDuring the beta period, collapsible banners are exclusive to Google demand, with mediated ads appearing as standard banners.\u003c/p\u003e\n"]]],["Collapsible banner ads display as a large overlay initially, then collapse to the standard banner size. To enable this, include an \"extras\" parameter with \"collapsible\" as the key and the placement (\"top\" or \"bottom\") as the value in the ad request. Refreshed ads in automated cases will not be collapsible. To load a new collapsible banner, make a manual request with the \"collapsible\" parameter. To confirm if a loaded banner is collapsible, check using `isCollapsible`. Collapsible ads are only supported for Google demand.\n"],null,["# Collapsible banner ads\n\nSelect platform: [Android](/ad-manager/mobile-ads-sdk/android/banner/collapsible \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/banner/collapsible \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/banner/collapsible \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/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\n- Complete the [banner ads get started guide](/ad-manager/mobile-ads-sdk/unity/banner).\n\nImplementation\n--------------\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-----------------------\n\nFor apps that configure auto-refresh for banner ads in the\nAd Manager 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-----------------------------------\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---------\n\nCollapsible banner ads are only available for Google demand. Ads served through\nmediation show as normal, non-collapsible banner ads."]]