Anúncios de banner recolhíveis

Selecione a plataforma: Android iOS Unity Flutter

Os anúncios de banner recolhíveis são apresentados inicialmente como uma sobreposição maior, com um botão para recolhê-los ao tamanho original solicitado. Os anúncios em banner recolhíveis foram criados para melhorar a performance dos anúncios fixos que, de outra forma, seriam menores. Neste guia, mostramos como ativar anúncios de banner expansíveis para posições de banner atuais.

Pré-requisitos

• Conclua o guia de primeiros passos para anúncios de banner.

Implementação

Verifique se a visualização do banner está definida com o tamanho que você quer que os usuários vejam 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.

O posicionamento recolhível define como a região expandida se ancora no anúncio em 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 é colocado 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 é colocado 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 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 de anúncios de banner na interface da Web da AdMob, quando um anúncio de banner recolhível é solicitado para um espaço de banner, as atualizações subsequentes não solicitam anúncios desse tipo. Isso porque mostrar um banner recolhível 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 contendo o parâmetro "collapsible".

Verificar se um anúncio carregado pode ser recolhido

Os anúncios de banner não recolhíveis podem ser retornados para solicitações de banner recolhível e 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(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. Os anúncios veiculados por mediação aparecem como banners normais e não recolhíveis.