Anúncios de banner recolhíveis
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Selecione a plataforma:
Android
iOS
Unity
Flutter
Os anúncios de banner recolhível são apresentados inicialmente como uma sobreposição
maior, com um botão para deixá-los menores, do tamanho original solicitado.
Esses anúncios foram criados para melhorar a performance dos anúncios âncora que,
de outra forma, seriam menores. Neste guia, mostramos como ativar anúncios de banner
recolhível nas posições atuais.

Pré-requisitos
Implementação
Confira se a visualização está no tamanho que deve aparecer para os usuários
no estado padrão (recolhido) do banner. Inclua um parâmetro "extras" na solicitação de
anúncio com collapsible
como chave e a posição do anúncio como valor.
A posição recolhível define como a região expandida é fixada no anúncio de
banner.
Valor de Placement
|
Comportamento |
Caso de uso pretendido |
top |
A parte de cima do anúncio expandido fica alinhada à parte de cima do anúncio recolhido. |
O anúncio aparece na parte de cima da tela. |
bottom |
A parte de baixo do anúncio expandido fica alinhada à parte de baixo do anúncio
recolhido. |
O anúncio aparece na parte de baixo da tela. |
Se o anúncio carregado for um banner recolhível, a sobreposição recolhível
vai aparecer imediatamente assim que o banner for colocado na hierarquia de visualização.
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);
}
Comportamento da atualização dos anúncios
Para apps que usam a atualização automática dos anúncios de banner na
interface da Web do Ad Manager, quando um anúncio de banner recolhível
é solicitado para um espaço, as atualizações seguintes não pedem
mais anúncios desse tipo. Isso acontece porque mostrar um banner recolhível em cada
atualização pode atrapalhar a experiência do usuário.
Se você quiser mostrar outro anúncio de banner recolhível na sessão,
carregue um anúncio manualmente com uma solicitação que use o parâmetro "collapsible".
Verificar se um anúncio carregado pode ser recolhido
Os anúncios de banner não recolhível podem ser retornados em solicitações
de banner recolhível para maximizar a performance. Chame isCollapsible
para verificar se o último
banner carregado é recolhível. Se a solicitação não carregar e o banner
anterior puder ser recolhido, a API vai retornar "true".
_bannerView.OnBannerAdLoaded += () =>
{
Debug.Log(_bannerView.IsCollapsible()
? "Banner is collapsible."
: "Banner is not collapsible.");
};
Os anúncios de banner recolhível estão disponíveis apenas para a demanda do Google. Os anúncios veiculados por
mediação aparecem como banners normais e não recolhíveis.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-02 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-02 UTC."],[[["\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."]]