Prasyarat
Selesaikan penyiapan peristiwa kustom.
Meminta iklan interstisial
Saat item baris peristiwa kustom tercapai dalam rantai mediasi waterfall,
the loadInterstitialAd()
method akan dipanggil pada nama class yang Anda berikan saat
membuat peristiwa
kustom. Dalam hal ini,
metode tersebut ada di SampleCustomEvent
, yang kemudian memanggil
the loadInterstitialAd()
method dalam SampleInterstitialCustomEventLoader
.
Untuk meminta iklan interstisial, buat atau ubah kelas yang memperluas Adapter
untuk menerapkan loadInterstitialAd()
. Selain itu, buat class baru untuk
mengimplementasikan MediationInterstitialAd
.
Dalam contoh peristiwa kustom kami, SampleCustomEvent
mengimplementasikanthe Adapter
interface , lalu mendelegasikan keSampleInterstitialCustomEventLoader
.
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
bertanggung jawab atas tugas-tugas berikut:
Memuat iklan interstisial dan memanggil
MediationAdLoadCallback
method setelah pemuatan selesaiMengimplementasikan
MediationInterstitialAd
interfaceMenerima dan melaporkan callback peristiwa iklan ke Google Mobile Ads SDK
Parameter opsional yang ditentukan dalam UI Ad Manager
disertakan dalam konfigurasi iklan. Parameter ini dapat diakses melalui
adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD)
.
Parameter ini biasanya merupakan ID unit iklan yang diperlukan SDK jaringan iklan
saat membuat instance objek iklan.
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; } }
Bergantung pada apakah iklan berhasil diambil atau mengalami error, Anda
akan memanggil
onSuccess()
atau
onFailure()
.
onSuccess()
dipanggil dengan meneruskan instance class yang mengimplementasikan
MediationInterstitialAd
.
Biasanya, metode ini diimplementasikan di dalam callback dari SDK pihak ketiga yang diterapkan oleh adaptor Anda. Untuk contoh ini, SDK Sampel memiliki SampleAdListener
dengan callback yang relevan:
Java
@Override public void onAdFetchSucceeded() { interstitialAdCallback = mediationAdLoadCallback.onSuccess(this); } @Override public void onAdFetchFailed(SampleErrorCode errorCode) { mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode)); }
MediationInterstitialAd
memerlukan penerapan metode showAd()
untuk menampilkan
iklan:
Java
@Override public void showAd(@NonNull Context context) { sampleInterstitialAd.show(); }
Meneruskan peristiwa mediasi ke Google Mobile Ads SDK
Setelah onSuccess()
dipanggil, objek MediationInterstitialAdCallback
yang ditampilkan kemudian dapat digunakan oleh adaptor untuk meneruskan peristiwa presentasi dari SDK pihak ketiga ke Google Mobile Ads SDK. Class SampleInterstitialCustomEventLoader
memperluas antarmuka SampleAdListener
untuk meneruskan callback dari contoh jaringan iklan ke Google Mobile Ads SDK.
Peristiwa kustom Anda harus meneruskan callback ini sebanyak mungkin, agar aplikasi Anda menerima peristiwa yang setara dari Google Mobile Ads SDK. Berikut adalah contoh penggunaan callback:
Java
@Override public void onAdFullScreen() { interstitialAdCallback.reportAdImpression(); interstitialAdCallback.onAdOpened(); } @Override public void onAdClosed() { interstitialAdCallback.onAdClosed(); }
Ini menyelesaikan penerapan peristiwa kustom untuk iklan interstisial. Contoh lengkapnya tersedia di GitHub. Anda dapat menggunakannya dengan jaringan iklan yang sudah didukung atau mengubahnya untuk menampilkan iklan interstisial peristiwa kustom.