CustomEventInterstitial

Kotlin |Java

public interface CustomEventInterstitial extends CustomEvent

حدث مخصّص يتوافق مع الإعلانات البينية

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

من المتوقّع أن يعيد الحدث المخصّص توجيه الأحداث من خلال CustomEventInterstitialListener الذي تم تمريره في طلب requestInterstitialAd. يجب تمرير جميع المَعلمات اللازمة لتقديم طلب إعلان في المَعلمات serverParameter وMediationAdRequest وcustomEventExtras.

ملخّص

الإجراءات العامة
`abstract void`	`requestInterstitialAd( Context context, CustomEventInterstitialListener listener, @Nullable String serverParameter, MediationAdRequest mediationAdRequest, @Nullable Bundle customEventExtras )` يتم استدعاء هذه الطريقة من خلال مكتبة التوسّط لطلب إعلان بيني.
`abstract void`	`showInterstitial()` عرض الإعلان البيني

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

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

`abstract void`	`onDestroy()` تفكيك وحدة التحكّم في محوّل الطاقة
`abstract void`	`onPause()` يتم استدعاء هذه الطريقة عندما يستدعي التطبيق `pause`.
`abstract void`	`onResume()` يتم استدعاء هذه الطريقة عندما يستدعي التطبيق `resume`.

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

requestInterstitialAd

abstract void requestInterstitialAd(
    Context context,
    CustomEventInterstitialListener listener,
    @Nullable String serverParameter,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

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

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

في حال عدم نجاح الطلب، يجب استدعاء onAdFailedToLoad على listener مع تحديد سبب مناسب للخطأ.

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

المعلمات
`Context context`	`Context` الخاص بـ `com.google.android.gms.ads.interstitial.InterstitialAd` الذي طلب الإعلان البيني للحدث المخصّص. يُفضَّل استخدام `android.app.Activity`.
`CustomEventInterstitialListener listener`	متتبّع الأحداث المخصّصة مع عمليات استدعاء لأحداث مختلفة
`@Nullable String serverParameter`	السلسلة التي تمّ ضبطها في واجهة مستخدم الناشر كمَعلمة للحدث المخصّص.
`MediationAdRequest mediationAdRequest`	مَعلمات الاستهداف العامة التي يجب استخدامها عند طلب إعلان بيني
`@Nullable Bundle customEventExtras`	`Bundle` من المَعلمات التي يضبطها الناشر على أساس كل طلب على حدة

showInterstitial

abstract void showInterstitial()

عرض الإعلان البيني يمكن استدعاء هذه الدالة في أي وقت بعد استدعاء الدالة onAdLoaded.