Vorbereitung
Schließen Sie die Einrichtung benutzerdefinierter Ereignisse ab.
Interstitial-Anzeige anfordern
Wenn die
benutzerdefinierte Ereignis-Werbebuchung in der
Vermittlungskette der Vermittlungsabfolge erreicht ist,
Die Methode loadInterstitialAd()
wird für den Klassennamen aufgerufen, den Sie angegeben haben, als
Erstellen eines benutzerdefinierten
. In diesem Fall
befindet sich diese Methode in SampleCustomEvent
, wodurch die Methode
Methode loadInterstitialAd()
in SampleInterstitialCustomEventLoader
.
Wenn Sie eine Interstitial-Anzeige anfordern möchten, müssen Sie eine Klasse erstellen oder ändern, die Adapter
erweitert
um loadInterstitialAd()
zu implementieren. Erstellen Sie außerdem einen neuen Kurs,
MediationInterstitialAd
implementieren.
In unserem Beispiel für benutzerdefinierte Ereignisse
SampleCustomEvent
erweitert die Adapter
-Klasse und delegiert dann
SampleInterstitialCustomEventLoader
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:
Laden der Interstitial-Anzeige und Aufrufen einer
MediationAdLoadCallback
nach Abschluss des Ladevorgangs.MediationInterstitialAd
-Schnittstelle implementierenCallbacks für Anzeigenereignisse an das Google Mobile Ads SDK empfangen und melden
Der optionale Parameter auf der Ad Manager-Benutzeroberfläche ist
die in der Anzeigenkonfiguration enthalten sind. Der Zugriff auf den Parameter ist über
adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD)
Dieser Parameter ist in der Regel eine Anzeigenblock-ID, die vom SDK eines Werbenetzwerks
beim Instanziieren eines Anzeigenobjekts erforderlich ist.
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()
onSuccess()
wird aufgerufen, indem eine Instanz der Klasse übergeben wird, die
MediationInterstitialAd
.
Üblicherweise werden diese Methoden innerhalb von Callbacks aus dem
Drittanbieter-SDK Ihres Adapters. In diesem Beispiel enthält das Beispiel-SDK
hat ein SampleAdListener
mit relevanten Callbacks:
Java
@Override public void onAdFetchSucceeded() { interstitialAdCallback = mediationAdLoadCallback.onSuccess(this); } @Override public void onAdFetchFailed(SampleErrorCode errorCode) { mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode)); }
Zum Anzeigen von MediationInterstitialAd
muss die Methode showAd()
implementiert werden
die Anzeige:
Java
@Override public void showAd(@NonNull Context context) { sampleInterstitialAd.show(); }
Vermittlungsereignisse an das Google Mobile Ads SDK weiterleiten
Nach dem Aufruf von onSuccess()
wird die zurückgegebene MediationInterstitialAdCallback
-Objekt kann dann vom Adapter verwendet werden, um Präsentationsereignisse aus dem
mit dem Google Mobile Ads SDK verknüpfen. Die
Die Klasse SampleInterstitialCustomEventLoader
erweitert die SampleAdListener
zur Weiterleitung von Rückrufen vom Beispielwerbenetzwerk an die Google Mobile-
Ads SDK.
Es ist wichtig, dass Ihr benutzerdefiniertes Ereignis so viele dieser Callbacks weiterleitet wie damit Ihre App diese äquivalenten Ereignisse vom Google Mobile Ads SDK. 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 der benutzerdefinierten Ereignisse für Interstitial-Anzeigen abgeschlossen. Die vollständige Beispiel verfügbar auf GitHub Sie können es mit einem Werbenetzwerk verwenden, das bereits unterstützt wird, oder zu Interstitial-Anzeigen mit benutzerdefinierten Ereignissen ausgeliefert.