Anúncios de banner recolhíveis

Os anúncios de banner que podem ser recolhidos são apresentados inicialmente como uma sobreposição maior, com um botão para recolhê-los para o tamanho de banner solicitado originalmente. O objetivo dos anúncios em banner colapsáveis é melhorar a performance dos anúncios fixos de tamanho menor. Este guia mostra como ativar anúncios de banner que podem ser recolhidos em posições de banner atuais.

Pré-requisitos

Implementação

Verifique se a visualização do banner está definida com o tamanho que você quer que os usuários vejam no estado normal (recolhido) do banner. Inclua um parâmetro extras na solicitação do anúncio com collapsible como chave e a posição do anúncio como valor.

O posicionamento recolhível define como a região expandida é ancorada ao anúncio de banner.

Valor Placement Comportamento Caso de uso pretendido
top A parte superior do anúncio expandido será alinhada à parte superior do anúncio recolhido. O anúncio é colocado na parte de cima da tela.
bottom A parte de baixo do anúncio aberto se alinha à parte de baixo do anúncio fechado. O anúncio é posicionado na parte inferior da tela.

Se o anúncio carregado for um banner que pode ser recolhido, ele mostrará a sobreposição recolhível assim que ele for colocado na hierarquia de visualização.

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // 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");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // 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")

  val adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

Comportamento de atualização dos anúncios

Para apps que configuram a atualização automática para anúncios de banner na interface da Web da AdMob, quando um anúncio de banner que pode ser recolhido é solicitado para um espaço de banner, as atualizações subsequentes não solicitam anúncios desse tipo. Isso ocorre porque mostrar um banner que pode ser recolhido em cada atualização pode ter um impacto negativo na experiência do usuário.

Se você quiser carregar outro anúncio de banner recolhível mais tarde na sessão, será possível carregar um anúncio manualmente com uma solicitação que contenha o parâmetro collapsible.

Verificar se um anúncio carregado pode ser recolhido

Os anúncios de banner não recolhíveis podem retornar para solicitações de banner recoletivo para maximizar a performance. Chame isCollapsible para verificar se o último banner carregado pode ser recolhido. Se a solicitação não for carregada e o banner anterior for colapsável, a API vai retornar "true".

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

Mediação

Os anúncios de banner que podem ser recolhidos estão disponíveis apenas para a demanda do Google durante o período Beta. Os anúncios veiculados por mediação são exibidos como anúncios de banner normais e não recolhíveis.