CustomEventBanner

Kotlin |Java

public interface CustomEventBanner extends CustomEvent

حدث مخصّص للسماح بعرض إعلانات البانر

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

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

ملخّص

الطرق العامة
`abstract void`	`requestBannerAd( Context context, CustomEventBannerListener listener, @Nullable String serverParameter, AdSize size, MediationAdRequest mediationAdRequest, @Nullable Bundle customEventExtras )` يتمّ استدعاؤها من مكتبة التوسّط لطلب عرض من الحدث المخصّص.

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

من com.google.android.gms.ads.mediation.customevent.CustomEvent

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

الطرق العامة

requestBannerAd

abstract void requestBannerAd(
    Context context,
    CustomEventBannerListener listener,
    @Nullable String serverParameter,
    AdSize size,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

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

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

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

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

المعلمات
`Context context`	`Context` لعرض الإعلان الذي سيحتوي على الحدث المخصّص . يُفضّل استخدام `android.app.Activity`.
`CustomEventBannerListener listener`	مستمع للحدث المخصّص مع عمليات استدعاء لأحداث مختلفة
`@Nullable String serverParameter`	السلسلة التي تم ضبطها في واجهة مستخدم الناشر كمَعلمة للحدث المخصّص.
`AdSize size`	حجم العرض الذي تريد استرجاعه. يجب أن يكون حجم العرض أقرب ما يمكن إلى الحجم المحدّد في هذه المَعلمة. إذا لم يكن حجم العرض هذا متوافقًا، من المفترض أن يفشل الطلب وأن يتمّ استدعاء onAdFailedToLoad.
`MediationAdRequest mediationAdRequest`	مَعلمات الاستهداف العامة التي يجب استخدامها عند طلب عرض.
`@Nullable Bundle customEventExtras`	`Bundle` من المَعلمات التي يحدّدها الناشر على أساس كل طلب