Banners adaptativos inline

Os banners adaptativos permitem 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 desempenho.

Em comparação com os banners adaptativos fixos, os inline são maiores, mais altos 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.

Você coloca banners adaptativos inline em conteúdo rolável, por exemplo:

Antes de começar

Antes de continuar, conclua 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 inline. Para criar um tamanho de anúncio adaptativo inline, siga estas instruções:

1. Receba a largura do dispositivo em uso ou defina sua própria largura se não quiser usar a largura total da tela.
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 adaptativo inline para a orientação escolhida.
3. Se você quiser limitar a altura do banner, use o método estático AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) .

O exemplo abaixo demonstra essas etapas:

Java

// Step 1: Create an inline adaptive banner ad size using the activity context.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
AdManagerAdView bannerView = new AdManagerAdView(this);
bannerView.setAdUnitId("ad unit ID");

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER);

// Step 3: Load an ad.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
bannerView.loadAd(adRequest);
// TODO: Insert banner view in list view or scroll view, etc.

Kotlin

// Step 1: Create an inline adaptive banner ad size using the activity context.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
val bannerView = AdManagerAdView(this)
bannerView.adUnitId = "ad unit ID"

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER)

// Step 3: Load an ad.
val adRequest = AdManagerAdRequest.Builder().build()
bannerView.loadAd(adRequest)
// TODO: Insert banner view in list view or scroll view, etc.

Importante: os tamanhos de reserva do Ad Manager podem ser veiculados no mesmo espaço do anúncio que os anúncios de banner adaptável. Para usar banners adaptativos com anúncios de reserva do Ad Manager no mesmo espaço do anúncio, 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 usam a largura total disponível. Na maioria dos casos, esse tamanho é a largura total da tela do dispositivo em uso ou a largura total do conteúdo pai 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 pai e as áreas seguras aplicáveis.

• Talvez seja necessário atualizar ou criar novos 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 inline instanciados sem um valor maxHeight têm um maxHeight igual à altura do dispositivo. Para limitar a altura do banner adaptativo 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 conferir os banners adaptativos inline em ação.

Java Kotlin