Anúncios de banner recolhíveis

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Os anúncios de banner recolhível são apresentados inicialmente como uma sobreposição maior, com um botão para deixá-los menores, do tamanho original solicitado. Anúncios de banner recolhíveis foram criados para melhorar a performance dos anúncios âncora que, de outra forma, seriam menores. Neste guia, mostramos como ativar anúncios de banner recolhível nas posições atuais.

Pré-requisitos

• Leia o guia para iniciantes sobre anúncios de banner.

Implementação

Verifique se a visualização está no tamanho que deve aparecer para os usuários 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.

A posição recolhível define como a região expandida é fixada no anúncio de 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 aparece 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 aparece 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:

Kotlin

private fun loadCollapsibleBannerAd(adView: AdView, activity: Activity) {
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the adView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val adRequest =
    BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.i(
          TAG,
          "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
        )
      }


      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

Java

private void loadCollapsibleBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the adView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  BannerAdRequest adRequest =
      new BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          Log.i(
              TAG,
              String.format(
                  "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
        }


        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

Substitua AD_UNIT_ID pelo ID do seu bloco de anúncios.

Comportamento da atualização dos anúncios

Para apps que usam a atualização automática dos anúncios de banner na interface da Web da AdMob, quando um anúncio de banner recolhível é solicitado para um espaço, as atualizações seguintes não pedem mais anúncios desse tipo. Isso acontece porque mostrar um banner que pode ser recolhido em cada atualização pode atrapalhar a experiência do usuário.

Se você quiser mostrar outro anúncio de banner que pode ser recolhido na sessão, carregue um anúncio manualmente com uma solicitação que use o parâmetro "collapsible".

Verificar se um anúncio carregado pode ser recolhido

Os anúncios de banner não recolhível podem ser retornados em solicitações de banner recolhível para maximizar a performance. Se a solicitação não carregar e o banner anterior puder ser recolhido, a API vai retornar o valor true. Para verificar se o último banner carregado é recolhível, chame o método isCollapsible:

Kotlin

override fun onAdLoaded(ad: BannerAd) {
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
  )
}
BannerSnippets.kt

Java

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  Log.i(
      TAG,
      String.format(
          "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
}
BannerSnippets.java

Mediação

Os anúncios de banner recolhível estão disponíveis apenas para a demanda do Google. Os anúncios de banner veiculados por mediação aparecem como anúncios de banner normais e não recolhíveis.