CustomEventNative

Kotlin |Java

interface CustomEventNative : CustomEvent

حدث مخصّص للسماح بالإعلانات المدمجة

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

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

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

ملخّص

الوظائف العامة
`Unit`	`requestNativeAd( context: Context!, listener: CustomEventNativeListener!, serverParameter: String?, mediationAdRequest: NativeMediationAdRequest!, customEventExtras: Bundle? )` يتمّ استدعاء هذه الوظيفة من قِبل مكتبة التوسّط لطلب إعلان مضمّن من الحدث المخصّص.

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

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

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

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

requestNativeAd

fun requestNativeAd(
    context: Context!,
    listener: CustomEventNativeListener!,
    serverParameter: String?,
    mediationAdRequest: NativeMediationAdRequest!,
    customEventExtras: Bundle?
): Unit

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

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

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

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

المعلمات
`context: Context!`	العنصر `Context` الذي سيحتوي على الحدث المخصّص
`listener: CustomEventNativeListener!`	مستمع للحدث المخصّص مع عمليات استدعاء لأحداث مختلفة
`serverParameter: String?`	السلسلة التي تم ضبطها في واجهة مستخدم الناشر كمَعلمة للحدث المخصّص.
`mediationAdRequest: NativeMediationAdRequest!`	مَعلمات الاستهداف العامة التي يجب استخدامها عند طلب عرض.
`customEventExtras: Bundle?`	`Bundle` من المَعلمات التي يحدّدها الناشر على أساس كل طلب