Configuration

Les événements personnalisés vous permettent d'ajouter une médiation en cascade pour un réseau publicitaire qui n'est pas un réseau publicitaire compatible. Vous en implémentant un adaptateur d'événement personnalisé pour le réseau publicitaire à intégrer.

Vous trouverez un exemple complet de projet d'événement personnalisé sur notre page GitHub repo.

Prérequis

Avant de pouvoir créer des événements personnalisés, vous devez intégrer l'un des le format d'annonce suivant dans votre application:

Créer un événement personnalisé dans l'UI

Vous devez d'abord créer un événement personnalisé dans AdMob UI. Consultez les instructions fournies dans l'article Ajoutez un événement personnalisé.

Vous devez fournir les éléments suivants:

Nom de la classe

Nom complet de la classe qui implémente l'événement personnalisé. adaptateur secteur, par exemple com.google.ads.mediation.sample.customevent.SampleCustomEvent Nous vous recommandons nous vous recommandons d'utiliser une classe d'adaptateur unique pour toutes les annonces d'événements personnalisés. .

Libellé

Nom unique définissant la source d'annonces.

Paramètre

Argument de chaîne facultatif transmis à votre adaptateur d'événement personnalisé.

Initialiser l'adaptateur

Lorsque le SDK Google Mobile Ads s'initialise, initialize() est appelé sur tous les adaptateurs tiers compatibles et les événements personnalisés configurés pour l'application dans l'interface utilisateur AdMob. Utilisez cette méthode pour effectuer les opérations de configuration ou d'initialisation nécessaires sur le SDK tiers requis pour votre événement personnalisé.

Java

package com.google.ads.mediation.sample.customevent;

import com.google.android.gms.ads.AdFormat;
import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.InitializationCompleteCallback;
import com.google.android.gms.ads.mediation.MediationConfiguration;

public class SampleAdNetworkCustomEvent extends Adapter {
  private static final String SAMPLE_AD_UNIT_KEY = "parameter";

  @Override
  public void initialize(Context context,
      InitializationCompleteCallback initializationCompleteCallback,
      List<MediationConfiguration> mediationConfigurations) {
    // This is where you will initialize the SDK that this custom
    // event is built for. Upon finishing the SDK initialization,
    // call the completion handler with success.
    initializationCompleteCallback.onInitializationSucceeded();
  }
}

Kotlin

package com.google.ads.mediation.sample.customevent

import com.google.android.gms.ads.AdFormat
import com.google.android.gms.ads.mediation.Adapter
import com.google.android.gms.ads.mediation.InitializationCompleteCallback
import com.google.android.gms.ads.mediation.MediationConfiguration

class SampleCustomEvent : Adapter() {
  private val SAMPLE_AD_UNIT_KEY = "parameter"

  override fun initialize(
    context: Context,
    initializationCompleteCallback: InitializationCompleteCallback,
    mediationConfigurations: List<MediationConfiguration>
  ) {
    // This is where you will initialize the SDK that this custom
    // event is built for. Upon finishing the SDK initialization,
    // call the completion handler with success.
    initializationCompleteCallback.onInitializationSucceeded()
  }
}

Numéros de version des rapports

Tous les événements personnalisés doivent signaler au SDK Google Mobile Ads les deux versions l'adaptateur d'événement personnalisé et la version du SDK tiers d'événements personnalisés. Les versions sont signalées comme VersionInfo Objets:

Java

package com.google.ads.mediation.sample.customevent;

public class SampleCustomEvent extends Adapter {

  @Override
  public VersionInfo getVersionInfo() {
    String versionString = new VersionInfo(1, 2, 3);
    String[] splits = versionString.split("\\.");

    if (splits.length >= 4) {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]) * 100 + Integer.parseInt(splits[3]);
      return new VersionInfo(major, minor, micro);
    }

    return new VersionInfo(0, 0, 0);
  }

  @Override
  public VersionInfo getSDKVersionInfo() {
    String versionString = SampleAdRequest.getSDKVersion();
    String[] splits = versionString.split("\\.");

    if (splits.length >= 3) {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    }

    return new VersionInfo(0, 0, 0);
  }
}

Kotlin

package com.google.ads.mediation.sample.customevent

class SampleCustomEvent : Adapter() {
  override fun getVersionInfo(): VersionInfo {
    val versionString = VersionInfo(1,2,3).toString()
    val splits: List<String> = versionString.split("\\.")

    if (splits.count() >= 4) {
      val major = splits[0].toInt()
      val minor = splits[1].toInt()
      val micro = (splits[2].toInt() * 100) + splits[3].toInt()
      return VersionInfo(major, minor, micro)
    }

    return VersionInfo(0, 0, 0)
  }

  override fun getSDKVersionInfo(): VersionInfo {
    val versionString = VersionInfo(1,2,3).toString()
    val splits: List<String> = versionString.split("\\.")

    if (splits.count() >= 3) {
      val major = splits[0].toInt()
      val minor = splits[1].toInt()
      val micro = splits[2].toInt()
      return VersionInfo(major, minor, micro)
    }

    return VersionInfo(0, 0, 0)
  }
}

Demander une annonce

Pour demander une annonce, reportez-vous aux instructions spécifiques au format d'annonce: