حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في وضع الصيانة للحصول على آخر التحديثات والميزات، عليك migrate وإعداد "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".

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

MediationNativeAdapter

Kotlin |Java

public interface MediationNativeAdapter extends MediationAdapter

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

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

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

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

ملخّص

الإجراءات العامة
`abstract void`	`requestNativeAd( Context context, MediationNativeListener listener, Bundle serverParameters, NativeMediationAdRequest mediationAdRequest, @Nullable Bundle mediationExtras )` يتم استدعاء هذه الطريقة من خلال مكتبة التوسّط لطلب إعلان مُدمَج مع المحتوى من المحوّل.

الإجراءات المكتسبة

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

`abstract void`	`onDestroy()` تفكيك وحدة التحكّم في محوّل الطاقة
`abstract void`	`onPause()` يتم استدعاؤه عندما يستدعي التطبيق `onPause` على `com.google.android.gms.ads.AdView`.
`abstract void`	`onResume()` يتم استدعاؤه عندما يستدعي التطبيق `onResume` على `com.google.android.gms.ads.AdView`.

الإجراءات العامة

requestNativeAd

abstract void requestNativeAd(
    Context context,
    MediationNativeListener listener,
    Bundle serverParameters,
    NativeMediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

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

في حال نجاح الطلب، يجب استدعاء الطريقة onAdLoaded.

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

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

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