Médiation

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

Conditions préalables

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

Vous découvrez la médiation ? Consultez la page 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 et d'enchères sont également initialisés. Il est important d'attendre la fin de l'initialisation avant de charger des annonces afin de garantir une participation complète de chaque réseau publicitaire à 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

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

Consultez la documentation Android et iOS pour chaque réseau partenaire pour savoir comment ajouter son adaptateur dans votre application.

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

L'exemple de code suivant montre comment consigner le nom de classe du 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(),
    );

Veillez à désactiver l'actualisation dans l'interface utilisateur de tous les réseaux publicitaires tiers pour les blocs d'annonces au format bannière utilisés dans la médiation Ad Manager. Cela permet d'éviter 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.

Médiation des annonces natives

Voici quelques bonnes pratiques à prendre en compte lors de la mise en œuvre de la médiation native.

Règlement concernant la présentation des annonces natives
Chaque réseau publicitaire a ses propres règles. Lorsque vous utilisez la médiation, n'oubliez pas que votre application doit toujours respecter les règles du réseau de médiation qui a fourni l'annonce.

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

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

Découvrez comment activer le traitement restreint des données (TRD) et obtenir votre consentement concernant le RGPD à l'aide du SDK Google User Messaging Platform (UMP).
Suivant
Sélectionner des réseaux