Commencer

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

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

Vous découvrez la médiation ? Lue Présentation de la médiation

Pour les enchères: SDK Google Mobile Ads 18.3.0 ou supérieur.

Initialiser le SDK Mobile Ads

Le guide de démarrage rapide vous explique comment initialiser les annonces pour mobile. SDK. Pendant cet appel d'initialisation, les adaptateurs de médiation s'initialiser. Il est important d'attendre la fin de l'initialisation avant de vous chargez des annonces afin de garantir une participation complète de chaque réseau publicitaire sur le première demande d'annonce.

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

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        initializationStatus -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

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

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

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

Consultez la documentation ResponseInfo sur getMediationAdapterClassName(). pour en savoir plus sur cette méthode.

Initialiser votre objet d'annonce avec une instance Activity

Dans le constructeur d'un nouvel objet d'annonce (par exemple, AdManagerAdView), vous devez transmettre un objet de type Context. Ce Context est transmis aux autres réseaux publicitaires lorsque vous utilisez la médiation. Un peu les réseaux publicitaires exigent un Context plus restrictif de type Activity et risquent de ne pas pouvoir diffuser d'annonces sans instance Activity. Par conséquent, nous vous recommandons de transmettre une instance Activity lors de l'initialisation des objets d'annonce. pour garantir une expérience cohérente avec vos réseaux publicitaires par médiation.

Utiliser des bannières avec la médiation

Veillez à désactiver l'actualisation dans toutes les interfaces utilisateur des sources d'annonces tierces pour les bannières. utilisées dans la médiation. Cela permet d'éviter double actualiser, car Ad Manager déclenche aussi une actualisation selon la fréquence d'actualisation de votre bloc de bannières.

Utiliser des annonces natives avec la médiation

Voici quelques bonnes pratiques à suivre lorsque vous implémentez des annonces natives la médiation.

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 de la médiation réseau ayant fourni l'annonce.

Utilisez loadAd() à la place de loadAds().

La méthode loadAds() ne diffuse que des annonces Google. Pour les annonces par médiation, utilisez loadAd() à la place.

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

Si vous devez respecter les confidentialité des états de confidentialité ou sur la Protection générale des données Règlement général (RGPD), suivez les étapes dans les réglementations des États américains paramètres ou RGPD pour ajouter votre partenaires de médiation dans Ad Manager messagerie Liste des États américains ou des partenaires publicitaires conformément au RGPD. À défaut, des partenaires peuvent de l'échec de la diffusion d'annonces dans votre application.