Para adoptar las mejoras de latencia y estabilidad de Android, usa 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 Google Mobile Ads Flutter Plugin.
- Tener un proyecto de Flutter
Cómo configurar los parámetros de Gradle para Android
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 los módulos
com.google.android.gmsy evitar errores de clases duplicadas.
Ejecutar con la declaración del entorno
Para usar GMA Next-Gen SDK cuando compiles y ejecutes 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, haz lo siguiente:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Ejecutar con la configuración del IDE
Si ejecutas tu app con un entorno de desarrollo integrado (IDE), puedes configurar las declaraciones de tu entorno en la configuración de inicio en lugar de pasar la marca a través de 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 información, consulta cómo especificar 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 de diseño de la vista de anuncios nativos
En los archivos de diseño XML 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 las dependencias para ambos parámetros de configuración
Si tu proyecto debe admitir tanto Google Mobile Ads SDK (Legacy) como GMA Next-Gen SDK, puedes configurar tu 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 de la app de ejemplo build.gradle.