Configurer la médiation

Sélectionnez une plate-forme : Android (bêta)

Ce guide vous explique comment intégrer un adaptateur de médiation à votre application Flutter.

Prérequis

Avant de pouvoir intégrer la médiation pour un format d'annonce, vous devez intégrer ce format d'annonce à votre application :

Vous ne connaissez pas la médiation ? Consultez la section Introduction à la médiation.

Initialiser Google Mobile Ads Flutter Plugin

Le guide de démarrage rapide vous explique comment initialiser le Google Mobile Ads Flutter Plugin. Lors de cet appel d'initialisation, les adaptateurs de médiation sont également initialisés. Il est important d'attendre la fin de l'initialisation avant de charger des annonces afin de vérifier la participation complète de chaque réseau publicitaire à la première demande d'annonce.

Google Mobile Ads Flutter Plugin

L'exemple de code suivant montre comment vérifier l'état d'initialisation de chaque adaptateur avant d'effectuer une demande d'annonce.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Modifier vos paramètres Gradle (Android uniquement)

Ajoutez les lignes suivantes à votre fichier settings.gradle pour pouvoir utiliser les API Android du plug-in :

def flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

Ajouter des dépendances pour les réseaux partenaires

Les adaptateurs de médiation et leurs dépendances doivent être ajoutés à vos projets Android et iOS. Pour ce faire, modifiez le fichier build.gradle au niveau de l'application sur Android et le fichier Podfile sur iOS. Google propose des adaptateurs Open Source sur GitHub pour Android et iOS.

Consultez la Android et la iOS documentation de chaque réseau partenaire pour obtenir des instructions détaillées sur l'ajout de son adaptateur dans votre application.

Vérifier quelle classe d'adaptateur de réseau publicitaire a chargé l'annonce

L'exemple de code suivant montre comment enregistrer le nom de la classe de réseau publicitaire pour une bannière :

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

Assurez-vous de désactiver l'actualisation dans toutes les interfaces utilisateur de sources d'annonces tierces pour les blocs d'annonces de type bannières utilisés dans la médiation. Cela évite une double actualisation, car Ad Manager déclenche également une actualisation en fonction du taux d'actualisation de votre bloc d'annonces de type bannières.

Utiliser des annonces natives avec la médiation

Voici quelques bonnes pratiques à prendre en compte lors de l'implémentation de la médiation native.

Règles de présentation des annonces natives: Chaque réseau publicitaire a ses propres règles. Lorsque vous utilisez la médiation, il est important de vous rappeler que votre application doit toujours respecter les règles du réseau de médiation qui a fourni l'annonce.