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. Os anúncios de banner que podem ser recolhidos melhoram o desempenho dos anúncios fixos que, de outra forma, teriam um 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 de extras na solicitação de anúncio com collapsible como a chave e a posição do anúncio como o valor.

A posição recolhível define como a região expandida é âncora ao anúncio de banner.

Valor Placement Comportamento Caso de uso pretendido
top A parte superior do anúncio expandido é alinhada à parte superior do anúncio recolhido. O anúncio é posicionado na parte superior da tela.
bottom A parte inferior do anúncio expandido é alinhada à parte inferior do anúncio recolhido. 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

A atualização dos anúncios de banner que pode ser recolhido a cada 30 a 120 segundos pode ser muito frequente, levando a uma experiência do usuário frustrante. Para aplicativos que configuram a atualização automática na interface da Web da AdMob, recomendamos exibir apenas a primeira solicitação de anúncio como recolhível e os anúncios de banner atualizados subsequentes nesse espaço, no tamanho da solicitação original. Para fazer isso, transmita um UUID como um collapsible_request_id à solicitação de anúncio:

Java 

extras.putString("collapsible_request_id", UUID.randomUUID().toString());

Kotlin 

extras.putString("collapsible_request_id", UUID.randomUUID().toString())

Se quiser carregar outro anúncio de banner que pode ser recolhido mais tarde na sessão, carregue um anúncio manualmente com uma solicitação contendo o parâmetro "collapsible".

Verificar se um anúncio carregado pode ser recolhido

Chame isCollapsible para verificar se o último banner carregado pode ser recolhido. Se a solicitação não for carregada e o banner anterior puder ser recolhido, a API 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.

Comportamento de veiculação dos anúncios

Para maximizar a performance dos anúncios de banner, os anúncios que não são compatíveis com uma sobreposição que pode ser recolhida em tamanho maior podem retornar algumas solicitações de banner que podem ser recolhidos e renderizados imediatamente no tamanho de banner normal.