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 establecer los parámetros de configuración de Android Gradle
Para usar GMA Next-Gen SDK en Android, debes actualizar la configuración de Gradle:
- Configura 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 declaración de 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, 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 de tu entorno en la configuración de lanzamiento 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 detalles, 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 de XML de diseño de la vista de anuncios nativos
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
Si tu proyecto debe admitir Google Mobile Ads SDK y GMA Next-Gen SDK, puedes configurar tu archivo android/app/build.gradle para definir condicionalmente las dependencias 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.