Para adoptar las mejoras de latencia y estabilidad de Android, usa GMA Next-Gen SDK. En esta guía, se explica cómo configurar Google Mobile Ads Flutter Plugin para usar GMA Next-Gen SDK para Android.
Requisitos previos
Antes de continuar, haz lo siguiente:
- Instala Google Mobile Ads Flutter Plugin versión 9.0.0 o posterior.
- Configura Google Mobile Ads Flutter Plugin.
- Asegúrate de tener un proyecto de Flutter.
Configura los parámetros de configuración de Android Gradle
Para usar GMA Next-Gen SDK en Android, debes actualizar tus configuraciones de Gradle:
- Establece los niveles de API de Android mínimos y de compilación.
- Si usas la mediación, sigue los pasos de migración para
excluir
com.google.android.gmsmódulos y evitar errores de clases duplicadas.
Ejecuta con la declaración del entorno
Para usar GMA Next-Gen SDK cuando compilas y ejecutas tu app para Android,
debes proporcionar la declaración del entorno USE_NEXT_GEN_SDK establecida en el
valor true.
Cada vez que compiles o ejecutes tu app, ejecuta lo siguiente:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Ejecuta con la configuración del IDE
Si ejecutas tu app con un entorno de desarrollo integrado (IDE), puedes configurar las declaraciones del entorno en la configuración de inicio en lugar de pasar la marca con la línea de comandos.
Por ejemplo, puedes definir estas variables en un archivo JSON y agregarlas a la configuración del IDE. Para obtener más información, consulta cómo especificar declaraciones del entorno.
Actualiza las plantillas de anuncios nativos
Si usas plantillas de anuncios nativos, realiza las siguientes actualizaciones para admitir GMA Next-Gen SDK:
Actualiza la importación del paquete NativeAdFactory
Para Android, actualiza la sentencia de importación de la clase 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
Actualiza las vistas XML de diseño de la vista de anuncio nativo
En los archivos XML de diseño de tus anuncios nativos, actualiza la clase de vista de anuncio nativo:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Configura dependencias para ambas configuraciones
Si tu proyecto debe admitir tanto Google Mobile Ads SDK como
GMA Next-Gen SDK, puedes configurar tu android/app/build.gradle
archivo para definir dependencias de forma condicional según la declaración del entorno.
Google Mobile Ads Flutter Plugin proporciona una configuración de muestra en el
archivo build.gradle de la app de ejemplo.