Vorbereitung
Schließen Sie die Einrichtung benutzerdefinierter Ereignisse ab.
Banneranzeige anfordern
Wenn die
benutzerdefinierte Ereignis-Werbebuchung in der
Vermittlungskette der Vermittlungsabfolge erreicht ist,
Die Methode loadBannerAd()
wird für den Klassennamen aufgerufen, den Sie angegeben haben, als
Erstellen eines benutzerdefinierten
. In diesem Fall
Diese Methode befindet sich in SampleCustomEvent
, womit dann die Methode loadBannerAd()
aufgerufen wird.
in SampleBannerCustomEventLoader
.
Wenn Sie eine Banneranzeige anfordern möchten, müssen Sie eine Klasse erstellen oder ändern, die Adapter
erweitert auf
loadBannerAd()
implementieren. Erstellen Sie außerdem eine neue Klasse, die implementiert werden soll.
MediationBannerAd
In unserem Beispiel für benutzerdefinierte Ereignisse
SampleCustomEvent
erweitert die Adapter
-Klasse und delegiert dann
SampleBannerCustomEventLoader
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.MediationBannerAd; import com.google.android.gms.ads.mediation.MediationBannerAdCallback; ... public class SampleCustomEvent extends Adapter { private SampleBannerCustomEventLoader bannerLoader; @Override public void loadBannerAd( @NonNull MediationBannerAdConfiguration adConfiguration, @NonNull MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback> callback) { bannerLoader = new SampleBannerCustomEventLoader(adConfiguration, callback); bannerLoader.loadAd(); } }
SampleBannerCustomEventLoader
ist für die folgenden Aufgaben verantwortlich:
Laden der Banneranzeige und Aufrufen einer
MediationAdLoadCallback
nach Abschluss des Ladevorgangs.MediationBannerAd
-Schnittstelle implementierenEmpfangen und Melden von Callbacks für Anzeigenereignisse an das Google Mobile Ads SDK
Der optionale Parameter, der in der Benutzeroberfläche definiert wird, 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.MediationBannerAdConfiguration; import com.google.android.gms.ads.mediation.MediationAdLoadCallback; import com.google.android.gms.ads.mediation.MediationBannerAd; import com.google.android.gms.ads.mediation.MediationBannerAdCallback; ... public class SampleBannerCustomEventLoader extends SampleAdListener implements MediationBannerAd { /** View to contain the sample banner ad. */ private SampleAdView sampleAdView; /** Configuration for requesting the banner ad from the third-party network. */ private final MediationBannerAdConfiguration mediationBannerAdConfiguration; /** Callback that fires on loading success or failure. */ private final MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback> mediationAdLoadCallback; /** Callback for banner ad events. */ private MediationBannerAdCallback bannerAdCallback; /** Constructor. */ public SampleBannerCustomEventLoader( @NonNull MediationBannerAdConfiguration mediationBannerAdConfiguration, @NonNull MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback> mediationAdLoadCallback) { this.mediationBannerAdConfiguration = mediationBannerAdConfiguration; this.mediationAdLoadCallback = mediationAdLoadCallback; } /** Loads a banner 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("BannerCustomEvent", "Begin loading banner ad."); String serverParameter = mediationBannerAdConfiguration.getServerParameters().getString( MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD); Log.d("BannerCustomEvent", "Received server parameter."); Context context = mediationBannerAdConfiguration.getContext(); sampleAdView = new SampleAdView(context); // Assumes that the serverParameter is the ad unit of the Sample Network. sampleAdView.setAdUnit(serverParameter); AdSize size = mediationBannerAdConfiguration.getAdSize(); // Internally, smart banners use constants to represent their ad size, which // means a call to AdSize.getHeight could return a negative value. You can // accommodate this by using AdSize.getHeightInPixels and // AdSize.getWidthInPixels instead, and then adjusting to match the device's // display metrics. int widthInPixels = size.getWidthInPixels(context); int heightInPixels = size.getHeightInPixels(context); DisplayMetrics displayMetrics = Resources.getSystem().getDisplayMetrics(); int widthInDp = Math.round(widthInPixels / displayMetrics.density); int heightInDp = Math.round(heightInPixels / displayMetrics.density); sampleAdView.setSize(new SampleAdSize(widthInDp, heightInDp)); sampleAdView.setAdListener(this); SampleAdRequest request = createSampleRequest(mediationBannerAdConfiguration); Log.i("BannerCustomEvent", "Start fetching banner ad."); sampleAdView.fetchAd(request); } 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
MediationBannerAd
.
Ü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() { bannerAdCallback = mediationAdLoadCallback.onSuccess(this); } @Override public void onAdFetchFailed(SampleErrorCode errorCode) { mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode)); }
Für MediationBannerAd
muss eine View
-Getter-Methode implementiert werden:
Java
@Override @NonNull public View getView() { return sampleAdView; }
Vermittlungsereignisse an das Google Mobile Ads SDK weiterleiten
Nach dem Aufruf von onSuccess()
wird das zurückgegebene MediationBannerAdCallback
-Objekt
können dann vom Adapter verwendet werden, um Präsentationsereignisse aus dem
mit dem Google Mobile Ads SDK verknüpfen. Die
Die SampleBannerCustomEventLoader
-Klasse erweitert die SampleAdListener
-Oberfläche.
, um Rückrufe vom Beispielwerbenetzwerk an das Google Mobile Ads SDK weiterzuleiten.
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() { bannerAdCallback.onAdOpened(); bannerAdCallback.reportAdClicked(); } @Override public void onAdClosed() { bannerAdCallback.onAdClosed(); }
Damit ist die Implementierung der benutzerdefinierten Ereignisse für Banneranzeigen abgeschlossen. Vollständiges Beispiel ist verfügbar auf GitHub Sie können es mit einem Werbenetzwerk verwenden, das bereits unterstützt wird, oder zu Benutzerdefinierte Ereignisbanneranzeigen zu schalten.