Médiation

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 dans votre application:

• Bannières
• Annonces interstitielles
• Annonces natives
• Annonces avec récompense
• Annonces interstitielles avec récompense

Vous découvrez la médiation ? Consultez la présentation de la médiation.

Initialiser le SDK Mobile Ads

Le guide de démarrage rapide vous explique comment initialiser le SDK Mobile Ads. 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 garantir la participation complète de chaque réseau publicitaire lors de la première demande d'annonce.

L'exemple de code suivant montre comment vérifier l'état d'initialisation de chaque adaptateur avant d'envoyer 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());
}

Mettre à jour vos paramètres Gradle (Android uniquement)

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

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

Ajouter des dépendances pour les réseaux partenaires

Vous devez ajouter les adaptateurs de médiation et leurs dépendances à vos projets Android et iOS. Pour les ajouter, mettez à jour votre fichier build.gradle au niveau de l'application sur Android et Podfile sur iOS. Google propose des adaptateurs Open Source sur GitHub pour Android et iOS.

Consultez la documentation Android et iOS de chaque chaîne partenaire pour obtenir des instructions détaillées sur l'ajout de leur 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 consigner le nom de la classe de réseau publicitaire pour une bannière publicitaire:

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

Utiliser des bannières avec la médiation

Assurez-vous de désactiver l'actualisation dans toutes les interfaces utilisateur des sources d'annonces tierces pour les blocs d'annonces de type bannière utilisés dans la médiation. Cela évite une double actualisation, car Ad Manager déclenche également une actualisation en fonction de la fréquence d'actualisation de votre bloc de 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 sur la 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 médiatisé qui a fourni l'annonce.

Lois des États américains sur la confidentialité et RGPD

Si vous devez respecter les lois des États américains sur la confidentialité ou le Règlement général sur la protection des données (RGPD), suivez les étapes décrites dans les paramètres des réglementations des États américains ou les paramètres du RGPD pour ajouter vos partenaires de médiation dans la liste des partenaires publicitaires des États américains ou du RGPD dans la section "Confidentialité et messages" d'Ad Manager. Sinon, les partenaires ne pourront pas diffuser d'annonces dans votre application.