Benutzerdefinierte Ereignisse für Interstitial-Anzeigen

Voraussetzungen

Schließen Sie die Einrichtung benutzerdefinierter Ereignisse ab.

Interstitial-Anzeige anfordern

Wenn die Werbebuchung des benutzerdefinierten Ereignisses in der abfolgebasierten Vermittlungskette erreicht wird, wirdthe loadInterstitialAd() method für den Klassennamen aufgerufen, den Sie beim Erstellen eines benutzerdefinierten Ereignisses angegeben haben. In diesem Fall befindet sich diese Methode in SampleCustomEvent, das dannthe loadInterstitialAd() method in SampleInterstitialCustomEventLoaderaufruft.

Wenn Sie eine Interstitial-Anzeige anfordern möchten, erstellen oder ändern Sie eine Klasse, die Adapter erweitert, um loadInterstitialAd() zu implementieren. Erstellen Sie außerdem eine neue Klasse, um MediationInterstitialAd zu implementieren.

In unserem Beispiel für benutzerdefinierte Ereignisse implementiert SampleCustomEventthe Adapter interface und delegiert dann anSampleInterstitialCustomEventLoader.

Java

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

import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.MediationAdConfiguration;
import com.google.android.gms.ads.mediation.MediationAdLoadCallback;
import com.google.android.gms.ads.mediation.MediationInterstitialAd;
import com.google.android.gms.ads.mediation.MediationInterstitialAdCallback;
...

public class SampleCustomEvent extends Adapter {
  private SampleInterstitialCustomEventLoader interstitialLoader;
  @Override
  public void loadInterstitialAd(
      @NonNull MediationInterstitialAdConfiguration adConfiguration,
      @NonNull
          MediationAdLoadCallback<MediationInterstitialAd, MediationInterstitialAdCallback>
              callback) {
    interstitialLoader = new SampleInterstitialCustomEventLoader(adConfiguration, callback);
    interstitialLoader.loadAd();
  }
}

SampleInterstitialCustomEventLoader ist für die folgenden Aufgaben verantwortlich:

• Wenn die Interstitial-Anzeige geladen und einMediationAdLoadCallback method aufgerufen wird, nachdem der Ladevorgang abgeschlossen ist

• MediationInterstitialAd interfaceimplementieren

• Callbacks für Anzeigenereignisse empfangen und an das Google Mobile Ads SDK melden

Der auf der AdMob -Benutzeroberfläche definierte optionale Parameter ist in der Anzeigenkonfiguration enthalten. Der Parameter kann über adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD) aufgerufen werden. Dieser Parameter ist in der Regel eine Anzeigenblock-ID, die ein Werbenetzwerk-SDK beim Instanziieren eines Anzeigenobjekts benötigt.

Java

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

import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.MediationInterstitialAdConfiguration;
import com.google.android.gms.ads.mediation.MediationAdLoadCallback;
import com.google.android.gms.ads.mediation.MediationInterstitialAd;
import com.google.android.gms.ads.mediation.MediationInterstitialAdCallback;
...

public class SampleInterstitialCustomEventLoader extends SampleAdListener
    implements MediationInterstitialAd {

  /** A sample third-party SDK interstitial ad. */
  private SampleInterstitial sampleInterstitialAd;

  /** Configuration for requesting the interstitial ad from the third-party network. */
  private final MediationInterstitialAdConfiguration mediationInterstitialAdConfiguration;

  /** Callback for interstitial ad events. */
  private MediationInterstitialAdCallback interstitialAdCallback;

  /** Callback that fires on loading success or failure. */
  private final MediationAdLoadCallback<MediationInterstitialAd, MediationInterstitialAdCallback>
      mediationAdLoadCallback;

  /** Constructor. */
  public SampleInterstitialCustomEventLoader(
      @NonNull MediationInterstitialAdConfiguration mediationInterstitialAdConfiguration,
      @NonNull MediationAdLoadCallback<MediationInterstitialAd, MediationInterstitialAdCallback>
              mediationAdLoadCallback) {
    this.mediationInterstitialAdConfiguration = mediationInterstitialAdConfiguration;
    this.mediationAdLoadCallback = mediationAdLoadCallback;
  }

  /** Loads the interstitial ad from the third-party ad network. */
  public void loadAd() {
    // All custom events have a server parameter named "parameter" that returns
    // back the parameter entered into the UI when defining the custom event.
    Log.i("InterstitialCustomEvent", "Begin loading interstitial ad.");
    String serverParameter = mediationInterstitialAdConfiguration.getServerParameters().getString(
        MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD);
    Log.d("InterstitialCustomEvent", "Received server parameter.");

    sampleInterstitialAd =
        new SampleInterstitial(mediationInterstitialAdConfiguration.getContext());
    sampleInterstitialAd.setAdUnit(serverParameter);

    // Implement a SampleAdListener and forward callbacks to mediation.
    sampleInterstitialAd.setAdListener(this);

    // Make an ad request.
    Log.i("InterstitialCustomEvent", "start fetching interstitial ad.");
    sampleInterstitialAd.fetchAd(
        SampleCustomEvent.createSampleRequest(mediationInterstitialAdConfiguration));
  }

public SampleAdRequest createSampleRequest(
      MediationAdConfiguration mediationAdConfiguration) {
    SampleAdRequest request = new SampleAdRequest();
    request.setTestMode(mediationAdConfiguration.isTestRequest());
    request.setKeywords(mediationAdConfiguration.getMediationExtras().keySet());
    return request;
  }
}

Je nachdem, ob die Anzeige erfolgreich abgerufen wurde oder ein Fehler auftritt, rufen Sie entweder onSuccess() oder onFailure() auf. onSuccess() wird durch Übergeben einer Instanz der Klasse aufgerufen, die MediationInterstitialAd implementiert.

In der Regel werden diese Methoden innerhalb von Callbacks des Drittanbieter-SDKs implementiert, das Ihr Adapter implementiert. In diesem Beispiel enthält das Sample SDK einen SampleAdListener mit relevanten Callbacks:

Java

@Override
public void onAdFetchSucceeded() {
  interstitialAdCallback = mediationAdLoadCallback.onSuccess(this);
}

@Override
public void onAdFetchFailed(SampleErrorCode errorCode) {
  mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode));
}

Für MediationInterstitialAd muss eine showAd()-Methode implementiert werden, damit die Anzeige ausgeliefert werden kann:

Java

@Override
public void showAd(@NonNull Context context) {
  sampleInterstitialAd.show();
}

Vermittlungsereignisse an das Google Mobile Ads SDK weiterleiten

Sobald onSuccess() aufgerufen wird, kann das zurückgegebene MediationInterstitialAdCallback-Objekt vom Adapter verwendet werden, um Präsentationsereignisse vom Drittanbieter-SDK an das Google Mobile Ads SDK weiterzuleiten. Die Klasse SampleInterstitialCustomEventLoader erweitert die SampleAdListener-Schnittstelle so, dass Callbacks vom Beispielwerbenetzwerk an das Google Mobile Ads SDK weitergeleitet werden.

Über Ihr benutzerdefiniertes Ereignis müssen so viele dieser Callbacks wie möglich weitergeleitet werden, damit die entsprechenden Ereignisse vom Google Mobile Ads SDK an Ihre App gesendet werden. Hier ist ein Beispiel für die Verwendung von Callbacks:

Java

@Override
public void onAdFullScreen() {
  interstitialAdCallback.reportAdImpression();
  interstitialAdCallback.onAdOpened();
}

@Override
public void onAdClosed() {
  interstitialAdCallback.onAdClosed();
}

Damit ist die Implementierung benutzerdefinierter Ereignisse für Interstitial-Anzeigen abgeschlossen. Das vollständige Beispiel steht auf GitHub zur Verfügung. Sie können es mit einem Werbenetzwerk verwenden, das bereits unterstützt wird, oder es so ändern, dass benutzerdefinierte Ereignis-Interstitial-Anzeigen ausgeliefert werden.