المتطلبات الأساسية
أكمِل إعداد الأحداث المخصَّصة.
طلب إعلان بيني
عند الوصول إلى عنصر الحدث المخصّص في سلسلة توسّط العرض الإعلاني بدون انقطاع،
يتم استدعاء طريقة loadInterstitialAd()
باسم الفئة الذي قدمته عند
إنشاء تخصيص
. وفي هذه الحالة،
تكون تلك الطريقة في SampleCustomEvent
، والتي تستدعي بعد ذلك
طريقة loadInterstitialAd()
في SampleInterstitialCustomEventLoader
.
لطلب إعلان بيني، عليك إنشاء أو تعديل فئة تمتد إلى Adapter
.
تنفيذ loadInterstitialAd()
. بالإضافة إلى ذلك، قم بإنشاء صف جديد
تنفيذ MediationInterstitialAd
.
في مثال الحدث المخصّص،
يوسع SampleCustomEvent
فئة Adapter
ثم يفوض إلى
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
" مسؤولية المهام التالية:
جارٍ تحميل الإعلان البيني واستدعاء
MediationAdLoadCallback
بعد اكتمال التحميل.تنفيذ واجهة
MediationInterstitialAd
.تلقّي استدعاءات أحداث الإعلانات وإعداد تقارير عنها إلى حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
المعلمة الاختيارية المحددة في واجهة مستخدم AdMob هي
مضمّنة في إعدادات الإعلان. يمكن الوصول إلى المعلمة من خلال
adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD)
تكون هذه المَعلمة عادةً معرّف وحدة إعلانية تستخدمه حزمة تطوير برامج (SDK) لشبكة الإعلانات
مطلوبة عند إنشاء مثيل لعنصر إعلان.
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; } }
استنادًا إلى ما إذا كان قد تم جلب الإعلان بنجاح أو واجه خطأ،
يتصل بأي منهما
onSuccess()
أو
onFailure()
يتم استدعاء onSuccess()
من خلال تمرير مثيل للفئة التي تنفذ
MediationInterstitialAd
عادةً، يتم تنفيذ هذه الطرق داخل استدعاءات من
حزمة تطوير البرامج (SDK) التابعة لجهة خارجية التي ينفّذها المحوّل. في هذا المثال، نموذج حزمة SDK
لدى SampleAdListener
مع استدعاءات ذات صلة:
Java
@Override public void onAdFetchSucceeded() { interstitialAdCallback = mediationAdLoadCallback.onSuccess(this); } @Override public void onAdFetchFailed(SampleErrorCode errorCode) { mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode)); }
تتطلب ميزة "MediationInterstitialAd
" تنفيذ طريقة showAd()
للعرض
الإعلان:
Java
@Override public void showAd(@NonNull Context context) { sampleInterstitialAd.show(); }
إعادة توجيه أحداث التوسّط إلى "SDK لإعلانات Google على الأجهزة الجوّالة"
بعد طلب onSuccess()
، يتم عرض MediationInterstitialAdCallback
عن طريق المحول لإعادة توجيه أحداث العرض التقديمي من
حزمة تطوير البرامج (SDK) التابعة لجهة خارجية إلى حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". تشير رسالة الأشكال البيانية
تُوسّع فئة واحدة (SampleInterstitialCustomEventLoader
) نطاق SampleAdListener
.
واجهة لإعادة توجيه الاستدعاءات من نموذج شبكة الإعلانات إلى Google للجوّال
حزمة تطوير البرامج (SDK) لعرض الإعلانات
من المهمّ أن يُعيد الحدث المخصّص توجيه أكبر عدد ممكن من طلبات معاودة الاتصال هذه. حتى يتلقّى تطبيقك هذه الأحداث المماثلة من نظام التشغيل SDK لإعلانات الأجهزة الجوّالة. إليك مثال على استخدام عمليات معاودة الاتصال:
Java
@Override public void onAdFullScreen() { interstitialAdCallback.reportAdImpression(); interstitialAdCallback.onAdOpened(); } @Override public void onAdClosed() { interstitialAdCallback.onAdClosed(); }
وبذلك، تكون قد أكملت تنفيذ الأحداث المخصّصة للإعلانات البينية. يتوفر المثال على GitHub. يمكنك استخدامه مع شبكة إعلانات متوافقة أو تعديلها إلى عرض الإعلانات البينية للأحداث المخصّصة