Anúncios de banner recolhíveis

Os anúncios de banner que podem ser recolhidos são exibidos inicialmente como um banner maior com um botão para recolhê-las ao tamanho do banner solicitado originalmente. Os anúncios de banner que podem ser recolhidos têm como objetivo melhorar o desempenho de anúncios fixos que caso contrário, são menores. Este guia mostra como ativar o banner que pode ser recolhido para posições de banner.

Pré-requisitos

Implementação

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

O posicionamento que pode ser recolhido define como a região expandida é fixada no banner anúncio.

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 se alinha à parte inferior do anúncio recolhido. anúncio. O anúncio é posicionado na parte inferior da tela.

Se o anúncio carregado for um banner que pode ser recolhido, ele mostrará o banner que pode ser recolhido sobreposição imediatamente após ser 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 para que sejam exibidos a cada 30 a 120 segundos pode ser muito frequentes, levando a uma experiência do usuário frustrante. Para apps que configuram atualização automática na interface da Web da AdMob, exibir somente a primeira solicitação de anúncio como recolhível e as próximas anúncios de banner atualizados naquele espaço, no tamanho da solicitação original. Para faça 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, carregar um anúncio manualmente com uma solicitação que contém 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 retorna verdadeiro.

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 na versão Beta período 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 pode retornar algumas solicitações de banner que podem ser recolhidos e renderizar imediatamente no tamanho de banner normal.