Предварительные условия
Завершите настройку пользовательских событий .
Запросить межстраничную рекламу
Когда в каскадной цепочке медиации достигается позиция специального события, вызывается метод loadInterstitialAd()
для имени класса, указанного вами при создании специального события . В данном случае этот метод находится в SampleCustomEvent
, который затем вызывает метод loadInterstitialAd()
в SampleInterstitialCustomEventLoader
.
Чтобы запросить межстраничную рекламу, создайте или измените класс, расширяющий Adapter
для реализации loadInterstitialAd()
. Кроме того, создайте новый класс для реализации MediationInterstitialAd
.
В нашем примере пользовательского события SampleCustomEvent
расширяет класс Adapter
, а затем делегирует его SampleInterstitialCustomEventLoader
.
Ява
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
отвечает за следующие задачи:
Загрузка межстраничного объявления и вызов метода
MediationAdLoadCallback
после завершения загрузки.Реализация интерфейса
MediationInterstitialAd
.Получение обратных вызовов рекламных событий и передача отчетов в Google Mobile Ads SDK.
Необязательный параметр, определенный в пользовательском интерфейсе AdMob, включается в конфигурацию объявления. Доступ к параметру можно получить через adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD)
. Обычно этот параметр представляет собой идентификатор рекламного блока, который требуется SDK рекламной сети при создании экземпляра рекламного объекта.
Ява
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; } }
В зависимости от того, было ли объявление успешно получено или возникла ошибка, вы должны вызвать либо onSuccess()
, либо onFailure()
. onSuccess()
вызывается путем передачи экземпляра класса, реализующего MediationInterstitialAd
.
Обычно эти методы реализуются внутри обратных вызовов из стороннего SDK, который реализует ваш адаптер. В этом примере в Sample SDK есть SampleAdListener
с соответствующими обратными вызовами:
Ява
@Override public void onAdFetchSucceeded() { interstitialAdCallback = mediationAdLoadCallback.onSuccess(this); } @Override public void onAdFetchFailed(SampleErrorCode errorCode) { mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode)); }
MediationInterstitialAd
требует реализации метода showAd()
для отображения объявления:
Ява
@Override public void showAd(@NonNull Context context) { sampleInterstitialAd.show(); }
Пересылать события медиации в Google Mobile Ads SDK.
После вызова onSuccess()
возвращенный объект MediationInterstitialAdCallback
может использоваться адаптером для пересылки событий презентации из стороннего SDK в Google Mobile Ads SDK. Класс SampleInterstitialCustomEventLoader
расширяет интерфейс SampleAdListener
для перенаправления обратных вызовов из примера рекламной сети в Google Mobile Ads SDK.
Важно, чтобы ваше специальное событие пересылало как можно больше таких обратных вызовов, чтобы ваше приложение получало эти эквивалентные события из Google Mobile Ads SDK. Вот пример использования обратных вызовов:
Ява
@Override public void onAdFullScreen() { interstitialAdCallback.reportAdImpression(); interstitialAdCallback.onAdOpened(); } @Override public void onAdClosed() { interstitialAdCallback.onAdClosed(); }
На этом реализация пользовательских событий для межстраничной рекламы завершена. Полный пример доступен на GitHub . Вы можете использовать его с уже поддерживаемой рекламной сетью или изменить ее для отображения межстраничной рекламы настраиваемых событий.