MediationNativeAdapter

Kotlin |Java

interface MediationNativeAdapter : MediationAdapter

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

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

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

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

ملخّص

الوظائف العامة
`Unit`	`requestNativeAd( context: Context!, listener: MediationNativeListener!, serverParameters: Bundle!, mediationAdRequest: NativeMediationAdRequest!, mediationExtras: Bundle? )` يتمّ استدعاء هذه الوظيفة من قِبل مكتبة التوسّط لطلب إعلان مُدمَج مع المحتوى من المُحوِّل.

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

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

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

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

requestNativeAd

fun requestNativeAd(
    context: Context!,
    listener: MediationNativeListener!,
    serverParameters: Bundle!,
    mediationAdRequest: NativeMediationAdRequest!,
    mediationExtras: Bundle?
): Unit

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

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

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

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

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