Esta página foi traduzida pela API Cloud Translation.

Banners adaptativos fixos

Os banners adaptativos são a próxima geração de anúncios responsivos, que maximizam a performance otimizando o tamanho do anúncio para cada dispositivo. Com a melhoria dos banners inteligentes, que são compatíveis apenas com alturas fixas, os banners adaptativos permitem especificar a largura do anúncio e usar essa informação para determinar o tamanho ideal do anúncio.

Para escolher o melhor tamanho de anúncio, os banners adaptativos usam proporções fixas em vez de alturas fixas. Isso resulta em anúncios de banner que ocupam uma parte mais consistente da tela em todos os dispositivos e oferece oportunidades para melhorar a performance.

Ao trabalhar com banners adaptativos, eles sempre vão retornar um tamanho constante para determinado dispositivo e largura. Depois de testar seu layout em um determinado dispositivo, você pode ter certeza de que o tamanho do anúncio não será alterado. No entanto, o tamanho do criativo de banner pode mudar em dispositivos diferentes. Consequentemente, recomendamos que o layout acomode variações na altura do anúncio. Em casos raros, o tamanho adaptável total pode não ser preenchido, e um criativo de tamanho padrão será centralizado nesse slot.

Pré-requisitos

Siga as instruções do Guia explicativo sobre como importar o plug-in dos anúncios para dispositivos móveis do Flutter.

Quando usar banners adaptativos

Os banners adaptativos foram projetados para substituir o tamanho de banner padrão do setor (320 x 50) e o formato de banner inteligente, que é substituído.

Esses tamanhos de banner costumam ser usados como banners fixos, que geralmente ficam fixados na parte de cima ou de baixo da tela.

Para esses banners fixos, a proporção ao usar banners adaptativos será semelhante à de um anúncio padrão de 320 x 50, como nos três exemplos abaixo:

Banner de 320 x 50

Banner adaptativo

Banner inteligente

O banner adaptativo usa melhor o tamanho de tela disponível. Além disso, em comparação com um banner inteligente, um banner adaptativo é uma escolha melhor porque:

Ele usa qualquer largura fornecida em vez de forçar a largura para ser exibida em tela cheia, permitindo que você considere a área segura no iOS e cortes de tela no Android.
Ele seleciona uma altura ideal para o dispositivo específico, em vez de ter uma altura constante em dispositivos de diferentes tamanhos, atenuando os efeitos da fragmentação de dispositivos.

Observações sobre implementação

Ao implementar banners adaptativos no seu app, tenha em mente os seguintes pontos:

Você precisa saber a largura da visualização em que o anúncio será colocado, além de considerar a largura do dispositivo e quaisquer cortes ou áreas seguras aplicáveis.
Verifique se o plano de fundo da visualização do anúncio é opaco para obedecer às políticas da AdMob quando tamanhos de anúncios menores são veiculados e não preenchem o espaço do anúncio.
Verifique se você está usando a versão mais recente do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Os tamanhos de banner adaptativo são projetados para funcionar melhor ao usar a largura total disponível. Na maioria dos casos, essa será a largura total da tela do dispositivo em uso. Considere as áreas de segurança aplicáveis.
O SDK dos anúncios para dispositivos móveis do Google dimensionará o banner com uma altura de anúncio otimizada para a largura especificada ao usar as APIs AdSize adaptativas.
Existem dois métodos para definir um tamanho de anúncio para adaptável: AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) para solicitar uma orientação específica e AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width) para a orientação atual no momento da execução.
O tamanho retornado para uma determinada largura em um determinado dispositivo sempre será o mesmo. Portanto, depois de testar o layout em um determinado dispositivo, você pode ter certeza de que o tamanho do anúncio não vai mudar.
A altura do banner fixo nunca é maior que 15% da altura do dispositivo ou menos de 50 pixels de densidade independente.

Guia de início rápido

Siga as etapas abaixo para implementar um banner adaptativo fixo simples.

Use um tamanho de anúncio de banner adaptativo. O tamanho definido será usado para solicitar seu banner adaptativo. Para conferir o tamanho do anúncio adaptável, faça o seguinte:
1. Descubra a largura do dispositivo em uso em pixels de densidade independente ou defina sua própria largura, se você não quiser usar a largura total da tela. Você pode usar MediaQuery.of(context) para saber a largura da tela.
2. Use os métodos estáticos adequados na classe de tamanho do anúncio, como AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width) para acessar um objeto AdSize adaptável para a orientação atual.
Crie um objeto BannerAd com o ID do bloco de anúncios, o tamanho do anúncio adaptável e um objeto de solicitação de anúncio.
Carregue o anúncio como faria com um anúncio de banner normal e exiba-o usando um AdWidget, assim como você faria com uma visualização de anúncio normal.

Exemplo de código

Confira um exemplo de widget que carrega um banner adaptativo fixo para se ajustar à largura da tela:

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:google_mobile_ads/google_mobile_ads.dart';

/// This example demonstrates anchored adaptive banner ads.
class AnchoredAdaptiveExample extends StatefulWidget {
  @override
  _AnchoredAdaptiveExampleState createState() =>
      _AnchoredAdaptiveExampleState();
}

class _AnchoredAdaptiveExampleState extends State<AnchoredAdaptiveExample> {
  BannerAd? _anchoredAdaptiveAd;
  bool _isLoaded = false;

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    _loadAd();
  }

  Future<void> _loadAd() async {
    // Get an AnchoredAdaptiveBannerAdSize before loading the ad.
    final AnchoredAdaptiveBannerAdSize? size =
        await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
            MediaQuery.of(context).size.width.truncate());

    if (size == null) {
      print('Unable to get height of anchored banner.');
      return;
    }

    _anchoredAdaptiveAd = BannerAd(
      // TODO: replace these test ad units with your own ad unit.
      adUnitId: Platform.isAndroid
          ? 'ca-app-pub-3940256099942544/6300978111'
          : 'ca-app-pub-3940256099942544/2934735716',
      size: size,
      request: AdRequest(),
      listener: BannerAdListener(
        onAdLoaded: (Ad ad) {
          print('$ad loaded: ${ad.responseInfo}');
          setState(() {
            // When the ad is loaded, get the ad size and use it to set
            // the height of the ad container.
            _anchoredAdaptiveAd = ad as BannerAd;
            _isLoaded = true;
          });
        },
        onAdFailedToLoad: (Ad ad, LoadAdError error) {
          print('Anchored adaptive banner failedToLoad: $error');
          ad.dispose();
        },
      ),
    );
    return _anchoredAdaptiveAd!.load();
  }

  @override
  Widget build(BuildContext context) => Scaffold(
        appBar: AppBar(
          title: Text('Anchored adaptive banner example'),
        ),
        body: Center(
          child: Stack(
            alignment: AlignmentDirectional.bottomCenter,
            children: <Widget>[
              ListView.separated(
                  padding: const EdgeInsets.symmetric(horizontal: 16.0),
                  itemBuilder: (context, index) {
                    return Text(
                      'Placeholder text',
                      style: TextStyle(fontSize: 24),
                    );
                  },
                  separatorBuilder: (context, index) {
                    return Container(height: 40);
                  },
                  itemCount: 20),
              if (_anchoredAdaptiveAd != null && _isLoaded)
                Container(
                  color: Colors.green,
                  width: _anchoredAdaptiveAd!.size.width.toDouble(),
                  height: _anchoredAdaptiveAd!.size.height.toDouble(),
                  child: AdWidget(ad: _anchoredAdaptiveAd!),
                )
            ],
          ),
        ),
      );

  @override
  void dispose() {
    super.dispose();
    _anchoredAdaptiveAd?.dispose();
  }
}

Aqui, a função AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize é usada para conseguir o tamanho de um banner em uma posição ancorada para a orientação atual da interface. Para pré-carregar um banner fixo em uma determinada orientação, use AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) e transmita a orientação desejada.

Exemplo completo no GitHub

Para ver o exemplo completo, consulte o Exemplo de banner do repositório do GitHub.