Pour profiter des améliorations apportées à la latence et à 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.
- Configurer Google Mobile Ads Flutter Plugin
- avoir 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.gmset éviter ainsi 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 l'indicateur à 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 de la vue d'annonce native
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 prendre en charge à la fois Google Mobile Ads SDK 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.