Pour adopter les améliorations de la latence et de la stabilité d'Android, utilisez GMA Next-Gen SDK. Ce guide explique comment configurer Google Mobile Ads Flutter Plugin pour utiliser GMA Next-Gen SDK pour Android.
Prérequis
Avant de continuer, procédez comme suit :
- Installez la version 9.0.0 ou ultérieure de Google Mobile Ads Flutter Plugin.
- Configurez Google Mobile Ads Flutter Plugin.
- Vous devez disposer d'un projet Flutter.
Configurer les paramètres Android Gradle
Pour utiliser GMA Next-Gen SDK sur Android, vous devez mettre à jour vos configurations Gradle :
- Définissez les niveaux d'API Android minimal et de compilation.
- Si vous utilisez la médiation, suivez la procédure de migration pour exclure les modules
com.google.android.gmsafin d'éviter les erreurs de classe en double.
Exécuter avec une déclaration d'environnement
Pour utiliser GMA Next-Gen SDK lors de la compilation et de l'exécution de votre application Android, vous devez fournir la déclaration d'environnement USE_NEXT_GEN_SDK définie sur la valeur true.
Chaque fois que vous compilez ou exécutez votre application, exécutez les commandes suivantes :
flutter run --dart-define USE_NEXT_GEN_SDK=true
Exécuter avec la configuration de l'IDE
Si vous exécutez votre application à l'aide d'un environnement de développement intégré (IDE), vous pouvez configurer vos déclarations d'environnement dans votre configuration de lancement au lieu de transmettre le flag à l'aide de la ligne de commande.
Par exemple, vous pouvez définir ces variables dans un fichier JSON et les ajouter à la configuration de votre IDE. Pour en savoir plus, consultez Spécifier des déclarations d'environnement.
Mettre à jour les modèles d'annonces natives
Si vous utilisez des modèles d'annonces natives, apportez les modifications suivantes pour prendre en charge GMA Next-Gen SDK :
Mettre à jour l'importation du package NativeAdFactory
Pour Android, mettez à jour l'instruction d'importation pour la 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
Mettre à jour les vues XML de mise en page des vues d'annonces natives
Dans les fichiers XML de mise en page de vos annonces natives, mettez à jour la classe de vue d'annonce native :
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Configurer les dépendances pour les deux configurations
Si votre projet doit être compatible avec Google Mobile Ads SDK (Legacy) et GMA Next-Gen SDK, vous pouvez configurer votre fichier android/app/build.gradle pour définir conditionnellement les dépendances en fonction de la déclaration d'environnement.
Google Mobile Ads Flutter Plugin fournit un exemple de configuration dans le fichier build.gradle de l'application exemple.