Pour bénéficier des 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 Google Mobile Ads Flutter Plugin version 9.0.0 ou ultérieure.
- Configurez Google Mobile Ads Flutter Plugin.
- Disposez d'un projet Flutter.
Configurer les paramètres Gradle Android
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 les étapes de migration pour
exclure les modules
afin d'éviter les erreurs de classe en double.
com.google.android.gms
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
true valeur.
Chaque fois que vous compilez ou exécutez votre application, exécutez la commande suivante :
flutter run --dart-define USE_NEXT_GEN_SDK=true
Exécuter avec une configuration 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 à votre configuration 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 de 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 prendre en charge à la fois Google Mobile Ads SDK et
GMA Next-Gen SDK, vous pouvez configurer votre android/app/build.gradle
fichier pour définir de manière conditionnelle 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.