Anúncios de banner recolhíveis

Os anúncios de banner recolhível são apresentados inicialmente como uma sobreposição maior, com um botão para recolhê-los ao tamanho do 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 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 de cima do anúncio aberto se alinha à parte de cima do anúncio fechado. 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 de anúncios

Para apps que configuram a atualização automática de anúncios de banner na interface da Web do Ad Manager, quando um anúncio de banner recolhível é solicitado para um espaço de banner, as atualizações subsequentes do anúncio não solicitam anúncios de banner recolhível. Isso ocorre porque mostrar um banner 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, carregue 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 são qualificados para retornar ao banner que pode ser recolhido solicitações para maximizar o desempenho. Chame isCollapsible para verificar se o último o banner carregado é recolhível. Se a solicitação não for carregada e o erro banner for recolhível, 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 recolhíveis 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.