CustomEventNative

Kotlin |Java

public interface CustomEventNative extends CustomEvent

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

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

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

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

ملخّص

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

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

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

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

الطرق العامة

requestNativeAd

abstract void requestNativeAd(
    Context context,
    CustomEventNativeListener listener,
    @Nullable String serverParameter,
    NativeMediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

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

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

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

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

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