可收合橫幅廣告
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
可收合橫幅廣告一開始出現時,會以較大尺寸重疊在畫面上,使用者點選上面的按鈕後,廣告就會收合成最初請求的橫幅尺寸。這種顯示方式能讓原本尺寸較小的錨定廣告更醒目,提升廣告效果。本指南將介紹如何在現有的橫幅廣告刊登位置,顯示可收合橫幅廣告。

先決條件
導入作業
請務必定義橫幅廣告檢視區塊的標準大小,也就是廣告在收合狀態時,使用者能看到的大小。接著在廣告請求中加入 extras 參數,將 collapsible
設為鍵,並將廣告刊登位置設為值。
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 廣告需求。透過中介服務放送的廣告,會以不可收合的一般橫幅廣告形式呈現。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-09-02 (世界標準時間)。
[null,null,["上次更新時間:2025-09-02 (世界標準時間)。"],[[["\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,["Select 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- Complete the [banner ads get started guide](/ad-manager/mobile-ads-sdk/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\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\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."]]