Configurer la médiation

Sélectionnez une plate-forme : Android iOS Unity Flutter Android (ancien)

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

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 :

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

Pour les enchères : Google Mobile Ads SDK (Legacy) 18.3.0 ou version ultérieure.

Initialiser Google Mobile Ads SDK (Legacy)

Le guide de démarrage rapide vous explique comment initialiser Google Mobile Ads SDK (Legacy). 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.

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

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

Voici un exemple de code qui consigne le nom de la classe du réseau publicitaire pour une bannière :

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)

Pour en savoir plus sur cette méthode, consultez la documentation ResponseInfo sur getMediationAdapterClassName().

Initialisez votre objet d'annonce avec une instance d'activité.

Dans le constructeur d'un nouvel objet d'annonce (par exemple, AdManagerAdView), vous devez transmettre un objet de type Context. Ce Context est transmis à d'autres réseaux publicitaires lors de l'utilisation de la médiation. Certains réseaux publicitaires nécessitent un Context plus restrictif de type Activity et peuvent ne pas être en mesure de diffuser des annonces sans instance Activity. Par conséquent, nous vous recommandons de transmettre une instance Activity lors de l'initialisation des objets d'annonce afin de vérifier que l'expérience est cohérente avec vos réseaux publicitaires de médiation.

Veillez à désactiver l'actualisation dans toutes les interfaces utilisateur des sources d'annonces tierces pour les blocs d'annonces 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 d'annonces de type bannière.

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, n'oubliez pas que votre application doit toujours respecter les règles du réseau de médiation qui a fourni l'annonce.
Utilisez loadAd() à la place de loadAds().
La méthode loadAds() ne diffuse que des annonces Google. Pour les annonces avec médiation, utilisez plutôt loadAd().

Lois sur la confidentialité des États américains 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 la procédure décrite dans Paramètres des réglementations des États américains ou Paramètres du RGPD pour ajouter vos partenaires de médiation à la liste des partenaires publicitaires pour les États américains ou le RGPD dans la section "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 le consentement RGPD avec le SDK Google User Messaging Platform (UMP).

Suivant
Choisir des sources d'annonces