Usar banners recolhíveis

Selecionar plataforma: Android (beta) Android iOS Unity Flutter

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. Os banners recolhíveis foram criados para melhorar o desempenho 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

• Conclua o guia de introdução aos anúncios de banner.

Implementação

Defina a visualização do banner com o tamanho que você quer que os usuários vejam no estado normal (recolhido). 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.

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.

private fun loadBannerAd() {
  // ...

  // 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 bannerAdRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize)
    .setGoogleExtrasBundle(extras)
    .build()

  BannerAd.load(
    bannerAdRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // ...
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        // ...
      }
    },
  )
}

private void loadBannerAd() {
  // ...

  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

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

  BannerAd.load(
      bannerAdRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // ...
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          // ...
        }
      });
}

Comportamento de atualização de anúncios

Para apps que usam a atualização automática dos anúncios de banner na interface da web do Ad Manager, 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 ocorre porque mostrar um banner recolhível em todas as atualizações 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 recolhível.

Verificar se um anúncio carregado é recolhível

Os anúncios de banner não recolhível podem ser retornados em solicitações de banner recolhível para maximizar a performance. Chame isCollapsible para verificar se o último banner carregado é recolhível. Se a solicitação não for carregada e o banner anterior for recolhível, a API vai retornar o valor true.

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

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

Mediação

Os anúncios de banner recolhível 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.