Para analizar nuestros productos y proporcionar comentarios sobre ellos, únete al canal oficial de Ad Manager en Discord, en el servidor Google Advertising and Measurement Community.
Los anuncios de banner contraíbles son anuncios de banner que se presentan inicialmente como una superposición más grande con un botón que permite contraerlos al tamaño de banner solicitado originalmente.
Este tipo de anuncios están diseñados para mejorar el rendimiento de los anuncios fijos de un tamaño más pequeño. En esta guía, se muestra cómo activar los anuncios de banner contraíbles para las posiciones de banner existentes.
Asegúrate de que la vista del banner esté definida con el tamaño que deseas que vean los usuarios en el estado normal (contraído) del banner. Incluye un parámetro de elementos adicionales en la solicitud de anuncio con collapsible como clave y la posición del anuncio como valor.
La posición contraíble define cómo se fija la región expandida al anuncio de banner.
Valor de Placement
Comportamiento
Caso de uso previsto
top
La parte superior del anuncio expandido se alinea con la parte superior del anuncio contraído.
El anuncio se coloca en la parte superior de la pantalla.
bottom
La parte inferior del anuncio expandido se alinea con la parte inferior del anuncio contraído.
El anuncio se coloca en la parte inferior de la pantalla.
Si el anuncio cargado es un banner contraíble, el banner muestra la superposición contraíble inmediatamente después de que se coloca en la jerarquía de vistas.
Swift
funcloadBannerAd(){bannerView.adUnitID="ca-app-pub-3940256099942544/8388050270"bannerView.rootViewController=selfletviewWidth=FRAME_WIDTHbannerView.adSize=currentOrientationAnchoredAdaptiveBanner(width:viewWidth)letrequest=AdManagerRequest// Create an extra parameter that aligns the bottom of the expanded ad to// the bottom of the bannerView.letextras=Extras()extras.additionalParameters=["collapsible":"bottom"]request.register(extras)bannerView.load(request)}
Objective-C
-(void)loadBannerAd{self.bannerView.adUnitID=@"ca-app-pub-3940256099942544/8388050270";CGFloatviewWidth=FRAME_WIDTH;self.bannerView.adSize=GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);GADRequest*request=[GADRequestrequest];// Create an extra parameter that aligns the bottom of the expanded ad to the// bottom of the bannerView.GADExtras*extras=[[GADExtrasalloc]init];extras.additionalParameters=@{@"collapsible":@"bottom"};[requestregisterAdNetworkExtras:extras];
[self.bannerViewloadRequest:request];}
Comportamiento de actualización de anuncios
En el caso de las apps que configuran la actualización automática para los anuncios de banner en la interfaz web de Ad Manager, cuando se solicita un anuncio de banner contraíble para un espacio de banner, las actualizaciones posteriores de anuncios no solicitarán anuncios de banner contraíbles. Esto se debe a que mostrar un banner contraíble en cada actualización podría tener un impacto negativo en la experiencia del usuario.
Si quieres cargar otro anuncio de banner contraíble más adelante en la sesión, puedes cargarlo de forma manual con una solicitud que contenga el parámetro contraíble.
Comprueba si un anuncio cargado se puede contraer
Los anuncios de banner no contraíbles son aptos para publicarse en respuesta a solicitudes de anuncios de banner contraíbles para maximizar el rendimiento. Llama a isCollapsible para verificar si el banner cargado más reciente se puede contraer. Si la solicitud no se carga y el banner anterior se puede contraer, la API devuelve un valor verdadero.
Swift
funcbannerViewDidReceiveAd(_bannerView:BannerView){print("The last loaded banner is \(bannerView.isCollapsible?"":"not") collapsible.")}
Objective-C
-(void)bannerViewDidReceiveAd:(GADBannerView*)bannerView{NSLog(@"The last loaded banner is %@collapsible.",(bannerView.isCollapsible?@"":@"not "));}
Mediación
Los anuncios de banner contraíbles solo están disponibles para la demanda de Google. Los anuncios publicados a través de la mediación se muestran como anuncios de banner normales que no se pueden contraer.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eCollapsible banner ads start as larger overlays and can be collapsed to a standard banner size, improving performance for smaller anchored ads.\u003c/p\u003e\n"],["\u003cp\u003eTo implement, define the banner view's collapsed size and include an extras parameter in the ad request specifying the placement (\u003ccode\u003etop\u003c/code\u003e or \u003ccode\u003ebottom\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eWhile auto-refresh is enabled, subsequent refreshes after a collapsible banner won't request another collapsible banner to avoid impacting user experience.\u003c/p\u003e\n"],["\u003cp\u003eYou can verify if a loaded ad is collapsible by calling \u003ccode\u003eisCollapsible\u003c/code\u003e on the banner view.\u003c/p\u003e\n"],["\u003cp\u003eDuring the beta period, collapsible banner ads are only supported for Google demand and not for ads served through mediation.\u003c/p\u003e\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/ios/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\nSwift \n\n func loadBannerAd() {\n bannerView.adUnitID = \"ca-app-pub-3940256099942544/8388050270\"\n bannerView.rootViewController = self\n let viewWidth = FRAME_WIDTH\n bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: viewWidth)\n\n let request = AdManagerRequest\n\n // Create an extra parameter that aligns the bottom of the expanded ad to\n // the bottom of the bannerView.\n let extras = Extras()\n extras.additionalParameters = \\[\"collapsible\" : \"bottom\"\\]\n request.register(extras)\n\n bannerView.load(request)\n }\n\nObjective-C \n\n - (void)loadBannerAd {\n self.bannerView.adUnitID = @\"ca-app-pub-3940256099942544/8388050270\";\n CGFloat viewWidth = FRAME_WIDTH;\n self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);\n\n GADRequest *request = [GADRequest request];\n\n // Create an extra parameter that aligns the bottom of the expanded ad to the\n // bottom of the bannerView.\n GADExtras \\*extras = \\[\\[GADExtras alloc\\] init\\];\n extras.additionalParameters = @{@\"collapsible\" : @\"bottom\"};\n \\[request registerAdNetworkExtras:extras\\];\n\n [self.bannerView loadRequest:request];\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\nSwift \n\n func bannerViewDidReceiveAd(_ bannerView: BannerView) {\n print(\"The last loaded banner is \\(bannerView.isCollapsible ? \"\" : \"not\") collapsible.\")\n }\n\nObjective-C \n\n - (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {\n NSLog(@\"The last loaded banner is %@collapsible.\", (bannerView.isCollapsible ? @\"\" : @\"not \"));\n }\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."]]