CustomEventNative

public interface CustomEventNative extends CustomEvent


حدث مخصّص لدعم الإعلانات المدمجة مع المحتوى

تتمثّل دورة الحياة النموذجية لحدث مخصّص في استدعاء requestNativeAd مرة واحدة. في هذه المرحلة، يجب أن ينشئ المحوّل إعلانًا مدمجًا مع المحتوى وأن يرسل تقريرًا إلى CustomEventNativeListener إما 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

تفكيك وحدة التحكّم في محوّل الطاقة

abstract void

يتم استدعاء هذه الطريقة عندما يستدعي التطبيق pause.

abstract void

يتم استدعاء هذه الطريقة عندما يستدعي التطبيق 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 من المَعلمات التي يضبطها الناشر على أساس كل طلب على حدة