Anúncios de banner recolhíveis

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

Verifique 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.

Java

private void loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

CollapsibleBannerFragment.java

Kotlin

private fun loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

CollapsibleBannerFragment.kt

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".

Java

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}
CollapsibleBannerFragment.kt

Mediação

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.