CustomEventInterstitial

Kotlin |Java

public interface CustomEventInterstitial extends CustomEvent

אירוע בהתאמה אישית שתומך במודעות מעברון.

מחזור החיים הטיפוסי של אירוע בהתאמה אישית הוא שקוראים לו requestInterstitialAd פעם אחת. בשלב הזה, המתאם צריך לבקש מודעה ולדווח על onAdLoaded או על onAdFailedToLoad למאזין. בקשות עוקבות יתבצעו עם מופע חדש של האירוע המותאם אישית. בסוף מחזור החיים, אנחנו עושים כמיטב יכולתנו כדי להתקשר אל onDestroy, אבל אין לנו אפשרות להתחייב לכך. חשוב לזכור שהפונקציה requestInterstitialAd מופעלת בשרשור של ממשק המשתמש, ולכן חלות עליה כל אמצעי הזהירות הרגילים של כתיבת קוד בשרשור הזה. באופן ספציפי, הקוד לא צריך לקרוא לשיטות חסימה.

האירוע המותאם אישית צפוי להעביר אירועים באמצעות CustomEventInterstitialListener שהועבר בקריאה requestInterstitialAd. כל הפרמטרים שנדרשים כדי לשלוח בקשה להצגת מודעה צריכים להיות מועברים בפרמטרים serverParameter, MediationAdRequest ו-customEventExtras.

סיכום

‫methods ציבוריות
`abstract void`	`requestInterstitialAd( Context context, CustomEventInterstitialListener listener, @Nullable String serverParameter, MediationAdRequest mediationAdRequest, @Nullable Bundle customEventExtras )` הפונקציה נקראת על ידי הספרייה לבחירת רשת כדי לבקש מודעה מעברית.
`abstract void`	`showInterstitial()` הצגת מודעת המעברון.

‫methods שעברו בירושה

From com.google.android.gms.ads.mediation.customevent.CustomEvent

`abstract void`	`onDestroy()` הפונקציה מפרקת את בקר המתאם.
`abstract void`	`onPause()` הפונקציה מופעלת כשהאפליקציה מתקשרת אל `pause`.
`abstract void`	`onResume()` הפונקציה מופעלת כשהאפליקציה מתקשרת אל `resume`.

‫methods ציבוריות

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`	פונקציית listener לאירוע בהתאמה אישית עם קודים להתקשרות חזרה לאירועים שונים.
`@Nullable String serverParameter`	מחרוזת שהוגדרה בממשק המשתמש של בעל התוכן הדיגיטלי כפרמטר לאירוע בהתאמה אישית.
`MediationAdRequest mediationAdRequest`	פרמטרים כלליים לטירגוט שמשמשים לשליחת בקשה להצגת מודעת מעברון.
`@Nullable Bundle customEventExtras`	`Bundle` של פרמטרים שמוגדרים על ידי בעל התוכן הדיגיטלי על בסיס כל בקשה.

showInterstitial

abstract void showInterstitial()

הצגת מודעת המעברון. אפשר לקרוא לשיטה הזו בכל שלב אחרי קריאה ל-onAdLoaded.