MediationInterstitialAdapter

Kotlin |Java

interface MediationInterstitialAdapter : MediationAdapter

---

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

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

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

تتم عادةً استدعاء 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 على com.google.android.gms.ads.AdView. Unit onResume() يتم استدعاؤه عندما يستدعي التطبيق onResume على com.google.android.gms.ads.AdView.

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

requestInterstitialAd

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

يتم استدعاؤها من خلال مكتبة التوسّط لطلب إعلان من المحوّل.

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

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

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

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

showInterstitial

fun showInterstitial(): Unit

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