מודעות באנר ניתנות לכיווץ
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מודעות באנר שאפשר לכווץ הן מודעות באנר שמוצגות בהתחלה כשכבת-על גדולה יותר, עם לחצן לכווץ אותן לגודל המקורי של מודעת הבאנר שנתבקשה.
מודעות באנר מתקפלות נועדו לשפר את הביצועים של מודעות עוגן שהגודל שלהן קטן יותר. במדריך הזה מוסבר איך להפעיל מודעות באנר שאפשר לכווץ במיקומי באנר קיימים.

דרישות מוקדמות
הטמעה
חשוב לוודא שתצוגת הבאנר מוגדרת עם הגודל שאתם רוצים שהמשתמשים יראו במצב הרגיל (המכווץ) של הבאנר. כוללים פרמטר 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, כשנשלחת בקשה להצגת מודעת באנר שאפשר לכווץ במיקום של מודעת באנר, אחרי רענון לא יישלחו מאותו דף בקשות למודעות מאותו פורמט. הסיבה לכך היא שהצגת מודעת באנר שאפשר לכווץ בכל רענון עלולה לפגוע בחוויית המשתמש.
אם רוצים לטעון עוד מודעת באנר שאפשר לכווץ בשלב מאוחר יותר בסשן, אפשר לטעון מודעה באופן ידני עם בקשה שיש בה פרמטר של מודעה מהסוג הזה.
מודעות באנר שאפשר לכווץ זמינות רק לביקוש של Google. מודעות שמוצגות באמצעות תהליך בחירת הרשת (mediation) מוצגות כמודעות באנר רגילות שאי אפשר לכווץ.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-09-02 (שעון UTC).
[null,null,["עדכון אחרון: 2025-09-02 (שעון UTC)."],[[["\u003cp\u003eCollapsible banner ads initially appear larger and can be collapsed to a standard banner size, improving anchored ad performance.\u003c/p\u003e\n"],["\u003cp\u003eTo enable, include an extra parameter in the ad request with \u003ccode\u003ecollapsible\u003c/code\u003e as the key and \u003ccode\u003etop\u003c/code\u003e or \u003ccode\u003ebottom\u003c/code\u003e as the value to specify the expanded ad's alignment.\u003c/p\u003e\n"],["\u003cp\u003eCollapsible banners only support Google demand; ads served through mediation will display as regular banners.\u003c/p\u003e\n"],["\u003cp\u003eAds refreshing is automatically configured to avoid repeated collapsible banners, improving user experience.\u003c/p\u003e\n"],["\u003cp\u003eFor manual control, load an ad with the collapsible parameter to re-enable a collapsible banner ad later in the session.\u003c/p\u003e\n"]]],["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"],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/flutter/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 void _loadAd() async {\n // Replace these test ad units with your own ad units.\n final String adUnitId = Platform.isAndroid\n ? 'ca-app-pub-3940256099942544/2014213617'\n : 'ca-app-pub-3940256099942544/8388050270';\n\n // Get the size before loading the ad.\n final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(\n MediaQuery.sizeOf(context).width.truncate());\n\n if (size == null) {\n // Unable to get the size.\n return;\n }\n\n // Create an extra parameter that aligns the bottom of the expanded ad to the\n // bottom of the banner ad.\n const adRequest = AdRequest(extras: {\n \"collapsible\": \"bottom\",\n });\n\n BannerAd(\n adUnitId: adUnitId,\n request: adRequest,\n size: size,\n listener: const BannerAdListener()\n ).load();\n }\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\n\u003cbr /\u003e\n\nMediation\n\nCollapsible banner ads are only available for Google demand. Ads served through\nmediation show as normal, non-collapsible banner ads."]]