Banners adaptativos inline

Selecione a plataforma: Android iOS Flutter

Com os banners adaptativos, é possível especificar a largura de um anúncio para determinar o tamanho ideal. Os banners adaptativos também maximizam a performance ao otimizar o tamanho do anúncio para cada dispositivo. Essa abordagem resulta em oportunidades de melhoria de performance.

Em comparação com os banners adaptativos fixos, os banners adaptativos inline são maiores, mais compridos e usam alturas variáveis em vez de fixas. Os banners adaptativos inline têm altura variável e podem abranger a tela inteira ou uma altura máxima especificada por você.

Você coloca banners adaptativos inline em conteúdo com rolagem, por exemplo:

Antes de começar

Antes de continuar, confira se você concluiu o guia para iniciantes, Anúncios de banner.

Implementar banners adaptativos

Ao contrário dos banners adaptativos fixos, os banners adaptativos inline são carregados usando um tamanho de banner adaptativo inline. Para criar um tamanho de anúncio adaptável inline, faça o seguinte:

1. Receba a largura do dispositivo em uso ou defina sua própria largura se não quiser usar a largura total da tela.

   Kotlin

   private val adWidth: Int
     get() {
       val displayMetrics = resources.displayMetrics
       val adWidthPixels =
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
           val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
           windowMetrics.bounds.width()
         } else {
           displayMetrics.widthPixels
         }
       val density = displayMetrics.density
       return (adWidthPixels / density).toInt()
     }
   MainActivity.kt

   Java

   public int getAdWidth() {
     DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
     int adWidthPixels = displayMetrics.widthPixels;
   
     if (VERSION.SDK_INT >= VERSION_CODES.R) {
       WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
       adWidthPixels = windowMetrics.getBounds().width();
     }
   
     float density = displayMetrics.density;
     return (int) (adWidthPixels / density);
   }
   MainActivity.java

2. Use os métodos estáticos apropriados na classe de tamanho do anúncio, como AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) para receber um objeto de tamanho de anúncio adaptável inline para a orientação escolhida.

   Kotlin

   val adView = AdView(this@MainActivity)
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, adWidth))
   MainActivity.kt

   Java

   final AdView adView = new AdView(MainActivity.this);
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, getAdWidth()));
   MainActivity.java

Importante: os tamanhos de anúncios de reserva do Ad Manager podem ser veiculados no mesmo espaço que os anúncios de banner adaptáveis. Para usar banners adaptativos com anúncios de reserva do Ad Manager no mesmo espaço, chame setAdSizes com uma lista de tamanhos que contenha o tamanho adaptativo além de todos os tamanhos de anúncios de reserva.

Ao implementar banners adaptativos no seu app, observe estes pontos:

• Os tamanhos de banner adaptativo inline funcionam melhor quando ocupam toda a largura disponível. Na maioria dos casos, esse tamanho é a largura total da tela do dispositivo em uso ou do conteúdo principal do banner. Você precisa saber a largura da visualização a ser colocada no anúncio, a largura do dispositivo, a largura do conteúdo principal e as áreas seguras aplicáveis.

• Talvez seja necessário atualizar ou criar itens de linha para trabalhar com tamanhos adaptáveis. Saiba mais.

Orientar o tamanho do banner adaptativo inline

Para pré-carregar um anúncio de banner adaptativo inline para uma orientação específica, use os seguintes métodos:

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

Se o app oferecer suporte às visualizações retrato e paisagem e você quiser pré-carregar um anúncio de banner adaptativo na orientação atual, use AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) Esse método carrega um anúncio na orientação atual.

Limitar a altura do banner adaptativo inline

Por padrão, os banners adaptativos in-line instanciados sem um valor maxHeight têm um maxHeight igual à altura do dispositivo. Para limitar a altura do banner adaptável inline, use o método AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

Outros recursos

Exemplos no GitHub

Faça o download do aplicativo de exemplo para ver os banners adaptativos in-line em ação.

Java Kotlin