MediationInterstitialAdapter

Kotlin |Java

interface MediationInterstitialAdapter : MediationAdapter

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

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

من المتوقّع أن يعيد المُحوِّل توجيه الأحداث من خلال MediationInterstitialListener الذي تم تمريره في طلب requestInterstitialAd. يجب تمرير جميع المَعلمات اللازمة لتقديم طلب إعلان في المَعلمات serverParameters وMediationAdRequest وmediationExtras.

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

ملخّص

الوظائف العامة
`Unit`	`requestInterstitialAd( context: Context!, listener: MediationInterstitialListener!, serverParameters: Bundle!, mediationAdRequest: MediationAdRequest!, mediationExtras: Bundle? )` يتمّ استدعاء هذه الوظيفة من قِبل مكتبة التوسّط لطلب إعلان من المحوِّل.
`Unit`	`showInterstitial()` تعرِض هذه السمة الإعلان البيني.

الدوال المُكتسَبة

من com.google.android.gms.ads.mediation.MediationAdapter

`Unit`	`onDestroy()` تمّت إزالة وحدة التحكّم في المحوِّل.
`Unit`	`onPause()` يتم استدعاؤه عندما يستدعي التطبيق `onPause` على
`Unit`	`onResume()` يتم استدعاؤه عندما يستدعي التطبيق `onResume` على

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

requestInterstitialAd

fun requestInterstitialAd(
    context: Context!,
    listener: MediationInterstitialListener!,
    serverParameters: Bundle!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
): Unit

يتمّ استدعاء هذه الوظيفة من قِبل مكتبة التوسّط لطلب إعلان من المحوِّل.

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

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

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

المعلمات
`context: Context!`	`Context` لعرض الإعلان الذي سيحتوي على عرض البانر. يُفضّل استخدام
`listener: MediationInterstitialListener!`	مستمع إلى المُحوِّل مع عمليات ردّ اتصال لأحداث مختلفة
`serverParameters: Bundle!`	مَعلمات إضافية يحدّدها الناشر من جهة خادم التوسّط
`mediationAdRequest: MediationAdRequest!`	مَعلمات عامة يمكن لهذا الناشر استخدامها عند تقديم طلب الإعلان
`mediationExtras: Bundle?`	مَعلمات إضافية يحدّدها الناشر لكل طلب على حدة

showInterstitial

fun showInterstitial(): Unit

تعرِض هذه السمة الإعلان البيني. ويمكن استدعاء هذا الإجراء في أي وقت بعد استدعاء onAdLoaded.