Ön koşullar
Özel etkinlik kurulumunu tamamlayın.
Geçiş reklamı isteme
Şelale uyumlulaştırma zincirinde özel etkinlik satır öğesine ulaşıldığında, özel etkinlik oluştururken sağladığınız sınıf adınathe loadInterstitialAd()
method çağrılır. Bu örnekte, bu yöntem SampleCustomEvent
içindedir ve daha sonrathe loadInterstitialAd()
method içinde SampleInterstitialCustomEventLoader
çağrısı yapar.
Bir geçiş reklamı istemek için, loadInterstitialAd()
uygulamasını uygulamak üzere Adapter
kapsamını genişleten bir sınıf oluşturun veya mevcut bir sınıfı değiştirin. Ayrıca, MediationInterstitialAd
yöntemini uygulamak için yeni bir sınıf oluşturun.
Özel etkinlik örneğimizde SampleCustomEvent
,the Adapter
interface uygulamasını uygular ve ardındanSampleInterstitialCustomEventLoader
öğesine yetki verir.
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
aşağıdaki görevlerden sorumludur:
Geçiş reklamı yükleme ve yükleme tamamlandıktan sonra bir
MediationAdLoadCallback
method çağırmaMediationInterstitialAd
interfaceReklam etkinliği geri çağırmalarını Google Mobile Ads SDK'sına alma ve raporlama
Kullanıcı arayüzünde tanımlanan AdMob isteğe bağlı parametre, reklam yapılandırmasına dahildir. Parametreye adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD)
üzerinden erişilebilir.
Bu parametre, genellikle reklam ağı SDK'sının bir reklam nesnesi örneği oluştururken ihtiyaç duyduğu reklam birimi tanımlayıcısıdır.
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; } }
Reklamın başarıyla getirilip getirilmediğine veya bir hatayla karşılaşıp karşılaşmadığına bağlı olarak onSuccess()
veya onFailure()
yöntemini çağırırsınız.
onSuccess()
, MediationInterstitialAd
uygulayan sınıfın bir örneğine geçirilerek çağrılır.
Genellikle bu yöntemler, bağdaştırıcınızın uyguladığı üçüncü taraf SDK'sından gelen geri çağırmaların içinde uygulanır. Bu örnekte Örnek SDK'da alakalı geri çağırma işlevleri olan bir SampleAdListener
bulunur:
Java
@Override public void onAdFetchSucceeded() { interstitialAdCallback = mediationAdLoadCallback.onSuccess(this); } @Override public void onAdFetchFailed(SampleErrorCode errorCode) { mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode)); }
MediationInterstitialAd
, reklamı görüntülemek için bir showAd()
yönteminin uygulanmasını gerektirir:
Java
@Override public void showAd(@NonNull Context context) { sampleInterstitialAd.show(); }
Uyumlulaştırma etkinliklerini Google Mobile Ads SDK'sına yönlendirme
onSuccess()
çağrıldıktan sonra, döndürülen MediationInterstitialAdCallback
nesnesi daha sonra bağdaştırıcı tarafından, sunu etkinliklerini üçüncü taraf SDK'dan Google Mobile Ads SDK'sına yönlendirmek için kullanılabilir. SampleInterstitialCustomEventLoader
sınıfı, örnek reklam ağından Google Mobile Ads SDK'sına geri çağırmaları yönlendirmek için SampleAdListener
arayüzünü genişletir.
Uygulamanızın Google Mobile Ads SDK'sından bu eşdeğer etkinlikleri alması için özel etkinliğinizin bu geri çağırmaları mümkün olduğunca fazla yönlendirmesi önemlidir. Geri çağırma işlevinin kullanımına ilişkin bir örneği burada bulabilirsiniz:
Java
@Override public void onAdFullScreen() { interstitialAdCallback.reportAdImpression(); interstitialAdCallback.onAdOpened(); } @Override public void onAdClosed() { interstitialAdCallback.onAdClosed(); }
Böylece geçiş reklamlarına yönelik özel etkinlik uygulamaları tamamlanmış olur. Tam örneği GitHub'da bulabilirsiniz. Bunu, desteklenen bir reklam ağıyla kullanabilir veya özel etkinlik geçiş reklamlarını görüntüleyecek şekilde değiştirebilirsiniz.