MediationBannerAdapter

Kotlin |Java

interface MediationBannerAdapter : MediationAdapter

---

تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا.

يمكنك استخدام Adapter بدلاً من ذلك.

محوّل لشبكات الإعلانات التابعة لجهات خارجية التي تتيح إعلانات البانر

تتم عادةً استدعاء requestBannerAd مرة واحدة خلال دورة حياة المحوّل. في هذه المرحلة، يجب أن يطلب المحوّل الإعلاني إعلانًا من شبكة الإعلانات وأن يرسل تقريرًا إلى أداة الاستماع بشأن onAdLoaded أو onAdFailedToLoad. سيتم تقديم الطلبات اللاحقة باستخدام مثيل جديد للمحوّل. في نهاية دورة الحياة، يتم بذل أقصى جهد للاتصال بـ onDestroy، ولكن لا يمكن ضمان ذلك. يُرجى العِلم أنّه يتم استدعاء requestBannerAd في سلسلة التعليمات الخاصة بواجهة المستخدم، لذا تنطبق جميع احتياطات كتابة الرمز البرمجي في سلسلة التعليمات هذه. وعلى وجه الخصوص، يجب ألا يستدعي الرمز أي طرق حظر.

من المتوقّع أن يعرض المحوّل الأحداث من خلال MediationBannerListener التي تم تمريرها في طلب requestBannerAd. يجب تمرير جميع المَعلمات اللازمة لتقديم طلب إعلان في المَعلمات serverParameters وMediationAdRequest وmediationExtras.

يجب أن تبذل برامج الربط جهدًا لإيقاف إعادة تحميل الإعلانات تلقائيًا من جهة العميل. قد يتم تجاهل الإعلانات التي يتم إعادة تحميلها، وعدم عرضها، واحتسابها بشكل غير صحيح.

ملخّص

الوظائف العامة
View!	getBannerView() تعرض هذه الطريقة View يمكن عرضه لعرض الإعلان.
Unit	requestBannerAd(     context: Context!,     listener: MediationBannerListener!,     serverParameters: Bundle!,     adSize: AdSize!,     mediationAdRequest: MediationAdRequest!,     mediationExtras: Bundle? ) يتم استدعاء هذه الطريقة من خلال مكتبة التوسّط لطلب إعلان بانر من محوّل الشبكة.

الدوال الموروثة
من com.google.android.gms.ads.mediation.MediationAdapter Unit onDestroy() تفكيك وحدة التحكّم في محوّل الطاقة Unit onPause() يتم استدعاؤه عندما يستدعي التطبيق onPause على com.google.android.gms.ads.AdView. Unit onResume() يتم استدعاؤه عندما يستدعي التطبيق onResume على com.google.android.gms.ads.AdView.

الوظائف العامة

getBannerView

fun getBannerView(): View!

تعرض هذه الطريقة View يمكن عرضه لعرض الإعلان.

يجب ألا تكون هذه القيمة فارغة بعد إجراء مكالمة requestBannerAd وقبل إجراء مكالمة onDestroy. وقد تكون القيمة فارغة في أي وقت آخر.

requestBannerAd

fun requestBannerAd(
    context: Context!,
    listener: MediationBannerListener!,
    serverParameters: Bundle!,
    adSize: AdSize!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
): Unit

يتم استدعاء هذه الطريقة من خلال مكتبة التوسّط لطلب إعلان بانر من محوّل الشبكة.

في حال نجاح الطلب، يجب استدعاء الطريقة onAdLoaded.

إذا لم ينجح الطلب، يجب استدعاء الطريقة onAdFailedToLoad في listener مع تحديد سبب الخطأ المناسب.

يتم استدعاء هذه الطريقة في سلسلة التعليمات الرئيسية لواجهة المستخدم، لذا تنطبق جميع احتياطات كتابة الرمز البرمجي في سلسلة التعليمات هذه. على وجه الخصوص، يجب ألا يستدعي الرمز أي طرق حظر.

المعلمات
context: Context!	تمثّل هذه السمة Context عنصر AdView الذي سيحتوي على عنصر البانر View. يُفضَّل استخدام android.app.Activity.
listener: MediationBannerListener!	أداة معالجة الحدث للمحوّل مع عمليات ردّ الاتصال لمختلف الأحداث
serverParameters: Bundle!	مَعلمات إضافية يحدّدها الناشر على جهة خادم التوسّط
adSize: AdSize!	حجم الإعلان المطلوب جلبه. يجب أن يكون حجم الإعلان الذي يتم عرضه قريبًا قدر الإمكان من الحجم المحدّد في هذه المَعلمة. إذا كان حجم الإعلان هذا غير متاح، يجب أن يفشل الطلب ويجب استدعاء onAdFailedToLoad.
mediationAdRequest: MediationAdRequest!	مَعلمات عامة يمكن لهذا الناشر استخدامها عند تقديم طلب الإعلان
mediationExtras: Bundle?	المَعلمات الإضافية التي يضبطها الناشر على أساس كل طلب