MediationBannerAdapter

Kotlin |Java

public interface MediationBannerAdapter extends MediationAdapter

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

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

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

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

ملخّص

الطرق العامة
`abstract View`	`getBannerView()` تعرِض هذه السمة `View` الذي يمكن عرضه لعرض الإعلان.
`abstract void`	`requestBannerAd( Context context, MediationBannerListener listener, Bundle serverParameters, AdSize adSize, MediationAdRequest mediationAdRequest, @Nullable Bundle mediationExtras )` يتمّ استدعاء هذه الوظيفة من قِبل مكتبة التوسّط لطلب إعلان بانر من المحوِّل.

الطرق المكتسَبة

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

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

الطرق العامة

getBannerView

abstract View getBannerView()

تعرِض View التي يمكن عرضها لعرض الإعلان.

يجب ألا يكون هذا الحقل فارغًا بعد طلب requestBannerAd وقبل طلب onDestroy. وقد يكون فارغًا في أي وقت آخر.

requestBannerAd

abstract void requestBannerAd(
    Context context,
    MediationBannerListener listener,
    Bundle serverParameters,
    AdSize adSize,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

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

إذا كان الطلب ناجحًا، يجب استدعاء الأسلوب onAdLoaded.

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

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

المعلمات
`Context context`	`Context` لعرض الإعلان الذي سيحتوي على عرض البانر. يُفضّل استخدام
`MediationBannerListener listener`	مستمع إلى المُحوِّل مع عمليات ردّ اتصال لأحداث مختلفة
`Bundle serverParameters`	مَعلمات إضافية يحدّدها الناشر من جهة خادم التوسّط
`AdSize adSize`	حجم الإعلان الذي تريد استرجاعه. يجب أن يكون حجم الإعلان الذي يتم إرجاعه أقرب ما يمكن إلى الحجم المحدّد في هذه المَعلمة. إذا كان حجم الإعلان هذا غير متوافق، من المفترض أن يفشل الطلب وأن يتمّ استدعاء onAdFailedToLoad.
`MediationAdRequest mediationAdRequest`	مَعلمات عامة يمكن لهذا الناشر استخدامها عند تقديم طلب الإعلان
`@Nullable Bundle mediationExtras`	مَعلمات إضافية يحدّدها الناشر لكل طلب على حدة