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:

Definir as configurações do Android para 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 o 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 a 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 ambiente de desenvolvimento integrado. 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 as visualizações XML de layout de visualização de anúncios nativos

Nos arquivos XML de layout dos seus 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 as duas configurações

Se o projeto precisar ser compatível com Google Mobile Ads SDK (Legacy) e GMA Next-Gen SDK, configure o arquivo android/app/build.gradle para definir dependências condicionalmente com base na declaração de ambiente.

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