Instalar o SDK do GMA Next-Gen

Para adotar melhorias de latência e estabilidade do Android, use o GMA Next-Gen SDK. Este guia aborda a configuração do Google Mobile Ads Flutter Plugin para usar o GMA Next-Gen SDK no Android.

Pré-requisitos

Antes de continuar, faça o seguinte:

Configurar as definições do Android Gradle

Para usar o GMA Next-Gen SDK no Android, atualize as configurações do Gradle:

Executar com declaração de ambiente

Para usar GMA Next-Gen SDK ao criar e executar seu app Android, forneça a declaração de ambiente USE_NEXT_GEN_SDK definida como o valor true.

Sempre que você criar ou executar o app, execute o seguinte:

flutter run --dart-define USE_NEXT_GEN_SDK=true

Executar com configuração do ambiente de desenvolvimento integrado

Se você executar o app usando um ambiente de desenvolvimento integrado (IDE), poderá configurar as declarações de ambiente na configuração de inicialização em vez de transmitir a flag usando a linha de comando.

Por exemplo, é possível definir essas variáveis em um arquivo JSON e adicioná-las à configuração do IDE. Para mais detalhes, consulte como especificar declarações de ambiente.

Atualizar modelos de anúncios nativos

Se você usa modelos de anúncios nativos, faça as seguintes atualizações para oferecer suporte a GMA Next-Gen SDK:

Atualizar a importação do pacote NativeAdFactory

No Android, atualize a instrução de importação da classe NativeAdFactory:

Java

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;

Kotlin

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory

Atualizar visualizações XML de layout de visualização de anúncio nativo

Nos arquivos XML de layout dos seus anúncios nativos, atualize a classe de visualização de anúncio nativo:

<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />

<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />

Configurar dependências para as duas configurações

Se o projeto precisar oferecer suporte a Google Mobile Ads SDK e GMA Next-Gen SDK, configure o arquivo android/app/build.gradle para definir condicionalmente as dependências com base na declaração do ambiente.

O Google Mobile Ads Flutter Plugin fornece um exemplo de configuração no arquivo do app de exemplo build.gradle.