MediationBannerListener

interface MediationBannerListener


تذكير لمحوِّل للتواصل مع مكتبة التوسّط. يجب إرسال الأحداث مرة أخرى إلى مكتبة التوسّط لإدارة تدفق الإعلانات بشكلٍ صحيح.

إنّ طريقة onAdClicked على وجه الخصوص مطلوبة لكي تعمل المقاييس بشكلٍ صحيح.

ملخّص

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

Unit

يشير إلى أنّ المستخدِم قد نقر على هذا الإعلان.

Unit

يشير إلى أنّ عنصر التحكّم في الإعلان عرض محتوى في وضع ملء الشاشة، وهو الآن يعيد التحكّم إلى التطبيق.

Unit

يشير ذلك إلى تعذّر تحميل طلب إعلان.

Unit

تم إيقاف هذه الوظيفة نهائيًا.

استخدِم onAdFailedToLoad بدلاً من ذلك.

Unit

يشير ذلك إلى أنّ الإعلان يتسبب في تبديل الجهاز إلى تطبيق مختلف (مثل متصفّح ويب).

Unit

يشير إلى أنّه تم طلب إعلان واستلامه بنجاح.

Unit

يشير ذلك إلى أنّ عنصر التحكّم في الإعلان يعرض محتوى بملء الشاشة.

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

onAdClicked

fun onAdClicked(adapter: MediationBannerAdapter!): Unit

يشير إلى أنّ المستخدِم قد نقر على هذا الإعلان. يُستخدَم هذا الحدث لمقاييس الناشر، ويجب استدعاؤه بالإضافة إلى أيّ أحداث أخرى، ولا تستنتج مكتبة التوسّط هذا الحدث أبدًا. على سبيل المثال، يعني الحدث onAdLeftApplication بشكل عام أنّ المستخدِم قد نقر على إعلان، ولكن يجب استدعاء الحدث onAdClicked بغض النظر عن ذلك.

المعلمات
adapter: MediationBannerAdapter!

محوِّل التوسّط الذي أثار الحدث.

onAdClosed

fun onAdClosed(adapter: MediationBannerAdapter!): Unit

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

المعلمات
adapter: MediationBannerAdapter!

محوِّل التوسّط الذي أثار الحدث.

انظر أيضًا
onAdOpened

onAdFailedToLoad

fun onAdFailedToLoad(adapter: MediationBannerAdapter!, adError: AdError): Unit

يشير ذلك إلى تعذّر تحميل طلب إعلان.

المعلمات
adapter: MediationBannerAdapter!

محوِّل التوسّط الذي أثار الحدث.

adError: AdError

AdError تفاصيل سبب تعذُّر الإجراء

انظر أيضًا
onAdLoaded

onAdFailedToLoad

fun onAdFailedToLoad(adapter: MediationBannerAdapter!, error: Int): Unit

يشير ذلك إلى تعذُّر عرض طلب إعلان مع السبب الأساسي. قد يكون العُطل خطأ فعليًا أو مجرد عدم ملء البيانات.

بعد طلب إعلان، يجب أن يُبلغ المُحوِّل عن نجاح العملية أو تعذّرها. في حال عدم تلقّي أيّ ردّ خلال مهلة زمنية محدّدة، قد تنتقل مكتبة التوسّط إلى محوِّل آخر، ما يؤدي إلى عدم عرض إعلان قد يكون ناجحًا.

المعلمات
adapter: MediationBannerAdapter!

محوِّل التوسّط الذي أثار الحدث.

error: Int

رمز خطأ يوضّح سبب تعذُّر الإجراء

انظر أيضًا
onAdLoaded

onAdLeftApplication

fun onAdLeftApplication(adapter: MediationBannerAdapter!): Unit

يشير ذلك إلى أنّ الإعلان يتسبب في تبديل الجهاز إلى تطبيق مختلف (مثل متصفّح ويب). يجب استدعاء هذا الإجراء قبل وضع التطبيق الحالي في الخلفية.

المعلمات
adapter: MediationBannerAdapter!

محوِّل التوسّط الذي أثار الحدث.

onAdLoaded

fun onAdLoaded(adapter: MediationBannerAdapter!): Unit

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

بعد طلب إعلان، يجب أن يُبلغ المُحوِّل عن نجاح العملية أو تعذّرها. في حال عدم تلقّي أيّ ردّ خلال مهلة زمنية محدّدة، قد تنتقل مكتبة التوسّط إلى محوِّل آخر، ما يؤدي إلى عدم عرض إعلان قد يكون ناجحًا.

من لحظة استدعاء هذه الطريقة إلى أن يتمّ إتلاف المُحوِّل، يجب أن يعرض getBannerView عنصر android.view.View، ولا يُسمح بعرض null. يجب عرض عنصر android.view.View نفسه في كل طلب.

المعلمات
adapter: MediationBannerAdapter!

محوِّل التوسّط الذي أثار الحدث.

انظر أيضًا
onAdFailedToLoad

onAdOpened

fun onAdOpened(adapter: MediationBannerAdapter!): Unit

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

بعد إغلاق هذه الشاشة، يجب استدعاء onAdClosed.

المعلمات
adapter: MediationBannerAdapter!

محوِّل التوسّط الذي أثار الحدث.