Para adoptar las mejoras de latencia y estabilidad de Android, usa el GMA Next-Gen SDK. En esta guía, se explica cómo configurar el Google Mobile Ads Flutter Plugin para usar el GMA Next-Gen SDK en Android.
Requisitos previos
Antes de continuar, haz lo siguiente:
- Instala la versión 9.0.0 o una posterior de Google Mobile Ads Flutter Plugin.
- Configura el Google Mobile Ads Flutter Plugin.
- Asegúrate de tener un proyecto de Flutter.
Cómo establecer los parámetros de configuración de Android y Gradle
Para usar GMA Next-Gen SDK en Android, debes actualizar tus parámetros de configuración 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 los módulos
com.google.android.gmsy 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 de 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 establecer las declaraciones de 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 de tu IDE. Para obtener más detalles, consulta Especifica declaraciones de 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
En Android, actualiza la sentencia de importación para 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 del 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 ambos parámetros de configuración
Si tu proyecto debe admitir Google Mobile Ads SDK (Legacy) y
GMA Next-Gen SDK, puedes configurar el archivo android/app/build.gradle
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.