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. Pour ce faire, vous devez implémenter un adaptateur d'événement personnalisé pour le réseau publicitaire que vous souhaitez intégrer.

Vous trouverez un exemple de projet d'événement personnalisé complet dans notre dépôt GitHub.

Conditions préalables

Avant de pouvoir créer des événements personnalisés, vous devez d'abord intégrer l'un des formats d'annonces suivants dans votre application:

Créer un événement personnalisé dans l'interface utilisateur

Vous devez d'abord créer un événement personnalisé dans l'interface utilisateur AdMob. Consultez les instructions dans Ajouter un événement personnalisé.

Vous devez fournir les éléments suivants:

Nom du cours

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

Libellé

Nom unique définissant la source d'annonces.

Paramètres

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 tous les événements personnalisés configurés pour l'application dans AdMob l'UI. Utilisez cette méthode pour effectuer la configuration ou l'initialisation nécessaire 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";

    private InitializationCompleteCallback initializationCallback;

    @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();
    }
}

Numéros de version des rapports

Tous les événements personnalisés doivent signaler au SDK Google Mobile Ads à la fois la version de l'adaptateur d'événement personnalisé lui-même et la version du SDK tiers avec laquelle l'événement personnalisé interagit. Les versions sont signalées en tant qu'objets VersionInfo :

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);
  }
}

Demander l'annonce

Pour demander une annonce, reportez-vous aux instructions spécifiques à ce format: