Premiers pas

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

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.

Pour les enchères : SDK Google Mobile Ads 7.53.1 ou version ultérieure.

Initialiser le SDK Google Mobile Ads

Le guide de démarrage rapide vous explique comment initialiser le SDK Google 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 vérifier la 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.

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    MobileAds.shared.start { status in
      // Optional: Log each adapter's initialization latency.
      let adapterStatuses = status.adapterStatusesByClassName
      for adapter in adapterStatuses {
        let adapterStatus = adapter.value
        NSLog("Adapter Name: %@, Description: %@, Latency: %f", adapter.key,
        adapterStatus.description, adapterStatus.latency)
      }

      // Start loading ads here...
    }

    return true
  }

}

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  GADMobileAds *ads = [GADMobileAds sharedInstance];
  [ads startWithCompletionHandler:^(GADInitializationStatus *status) {
    // Optional: Log each adapter's initialization latency.
    NSDictionary *adapterStatuses = [status adapterStatusesByClassName];
    for (NSString *adapter in adapterStatuses) {
      GADAdapterStatus *adapterStatus = adapterStatuses[adapter];
      NSLog(@"Adapter Name: %@, Description: %@, Latency: %f", adapter,
            adapterStatus.description, adapterStatus.latency);
    }

    // Start loading ads here...
  }];
  return YES;
}

@end

Savoir quel réseau publicitaire remporte l'enchère

Chaque classe de format d'annonce possède une propriété GADResponseInfo qui contient adNetworkClassName, laquelle renvoie le nom de la classe du réseau publicitaire pour l'annonce actuelle. adNetworkClassName n'a de valeur qu'une fois qu'une annonce a été chargée. Le code suivant vous montre comment obtenir ces informations pour les bannières publicitaires.

func adViewDidReceiveAd(_ bannerView: AdManagerBannerView) {
  print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}

- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
  NSLog(@"Banner adapter class name: %@", bannerView.responseInfo.adNetworkClassName);
}

Pour en savoir plus, consultez Récupérer des informations sur la réponse de l'annonce.

Utiliser des bannières avec la médiation

Assurez-vous de désactiver l'actualisation dans toutes les UI 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 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 lorsque vous implémentez la médiation native.

Règles relatives à la présentation des annonces natives

Chaque réseau publicitaire possède 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.

Évitez d'utiliser la classe GADMultipleAdsAdLoaderOptions lorsque vous envoyez des requêtes.

Les demandes de plusieurs annonces natives ne diffusent que des annonces Google. La fonctionnalité permettant d'afficher plusieurs annonces natives n'est pas compatible avec la médiation.

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 à la liste des partenaires publicitaires des États américains ou du RGPD dans la section "Confidentialité et messages" d'Ad Manager. Si vous ne le faites pas, vos partenaires risquent de ne pas pouvoir diffuser d'annonces dans votre application.

Découvrez comment activer le traitement restreint des données et obtenir le consentement RGPD avec le SDK Google User Messaging Platform (UMP).