접을 수 있는 배너 광고
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
접을 수 있는 배너 광고는 처음에는 더 큰 오버레이로 표시되며 원래 요청된 배너 크기로 접을 수 있는 버튼을 제공하는 배너 광고입니다.
접을 수 있는 배너 광고는 크기가 더 작은 앵커 광고의 실적을 개선하기 위한 것입니다. 이 가이드에서는 기존 배너 게재위치에 접을 수 있는 배너 광고를 사용 설정하는 방법을 설명합니다.

기본 요건
구현
배너 뷰가 일반(접힘) 배너 상태에서 사용자에게 표시하려는 크기로 정의되어 있는지 확인합니다. 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();
}
광고 새로고침 동작
AdMob 웹 인터페이스에서 배너 광고의 자동 새로고침을 구성하는 앱의 경우 배너 슬롯에 접을 수 있는 배너 광고가 요청되면 이후 광고 새로고침에서 접을 수 있는 배너 광고가 요청되지 않습니다. 새로고침마다 접을 수 있는 배너를 표시하면 사용자 환경에 부정적인 영향을 미칠 수 있기 때문입니다.
동일한 세션에서 나중에 다른 접을 수 있는 배너 광고를 로드하려면 접을 수 있는 배너 매개변수를 포함하는 요청을 이용해 광고를 직접 로드하세요.
접을 수 있는 배너 광고는 Google 광고 수요에만 사용할 수 있습니다. 미디에이션을 통해 게재되는 광고는 접을 수 없는 일반 배너 광고로 표시됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-25(UTC)
[null,null,["최종 업데이트: 2025-08-25(UTC)"],[[["\u003cp\u003eCollapsible banner ads start as larger overlays and can be collapsed to a standard banner size for improved anchored ad performance.\u003c/p\u003e\n"],["\u003cp\u003eTo implement, define the collapsed banner size and include an extras parameter in the ad request specifying the collapsible placement (\u003ccode\u003etop\u003c/code\u003e or \u003ccode\u003ebottom\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eCollapsible banners are initially displayed as expanded and automatically collapse; auto-refresh is not supported for these ads to avoid impacting user experience.\u003c/p\u003e\n"],["\u003cp\u003eCurrently, collapsible banner ads are only available for Google demand, and mediated ads will display as regular banners.\u003c/p\u003e\n"]]],["Collapsible banner ads display as a large overlay initially, then collapse to the specified banner size. To enable them, define the desired collapsed banner size, and include an `extras` parameter in the ad request with `collapsible` as the key and `top` or `bottom` for placement. This defines how the expanded ad aligns. Refreshed ads do not request collapsible banners. They are available for Google demand only; mediated ads are not collapsible.\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/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\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\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."]]