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, maximizando o desempenho otimizando o tamanho do anúncio para cada dispositivo. Ao melhorar os banners inteligentes, que são compatíveis apenas com alturas fixas, os banners adaptativos permitem especificar largura do anúncio e use isso para determinar o tamanho ideal.

Para escolher o melhor tamanho de anúncio, os banners adaptativos usam proporções fixas em vez de alturas fixas. Assim, os anúncios de banner ocupam uma parte mais consistente da tela em vários dispositivos e oferece oportunidades para melhorias desempenho.

Ao trabalhar com banners adaptativos, observe que eles sempre retornarão uma 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 do banner pode mudar em diferentes dispositivos. Consequentemente, recomendamos que seu layout acomode variações na altura do anúncio. Em casos raros, o tamanho totalmente adaptável pode não ser preenchido, e um criativo de tamanho padrão será centralizado nesse slot.

Pré-requisitos

Siga as instruções do guia de primeiros passos para importar o plug-in de anúncios para dispositivos móveis do Flutter.

Quando usar banners adaptativos

Os banners adaptativos foram projetados para substituir o tamanho padrão do setor de 320 x 50 e o formato de banner inteligente.

Esses tamanhos de banner são normalmente usados como banners ancorados, que geralmente são fixado na parte de cima ou de baixo da tela.

Para esses banners fixos, a proporção ao usar banners adaptativos será semelhante ao de um anúncio padrão de 320 x 50, como pode ser visto 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, o banner adaptativo é uma escolha melhor porque:

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

Observações sobre implementação

Ao implementar banners adaptativos no seu app, tenha em mente o seguinte:

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

Guia de início rápido

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

Usar um tamanho de anúncio de banner adaptativo. O tamanho obtido será usado para solicitar seu banner adaptativo. Para conferir o tamanho do anúncio adaptável, você precisa:
1. Receba a largura do dispositivo em uso em pixels independentes de densidade ou defina sua própria largura se 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 de anúncio, como AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width), para receber 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 adaptativo e um objeto de solicitação de anúncio.
Carregue o anúncio como se fosse um anúncio de banner normal e exiba-o de uma AdWidget, assim como em uma visualização normal de anúncios.

Exemplo de código

Confira um exemplo de widget que carrega um banner adaptativo ancorado 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 é usado para conseguir o tamanho de um banner em uma posição ancorada para a interface atual orientação. Para pré-carregar um banner fixo em uma determinada orientação, use AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) e passe para a orientação desejada.

Exemplo completo no GitHub

Para conferir o exemplo completo, consulte o exemplo de banner no repositório do GitHub.