Instalar o SDK do GMA Next-Gen

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

Pré-requisitos

Antes de continuar, faça o seguinte:

Definir as configurações do Android Gradle

Para usar 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 true valor.

Sempre que você criar ou executar o app, faça 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, você pode definir essas variáveis em um arquivo JSON e adicioná-las à configuração do ambiente de desenvolvimento integrado. Para mais detalhes, consulte 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 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úncios nativos

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

<!-- 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 ambas as configurações

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

Google Mobile Ads Flutter Plugin oferece uma configuração de amostra no app de exemplo build.gradle arquivo.