CustomEventInterstitial

Kotlin |Java

interface CustomEventInterstitial : CustomEvent

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

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

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

סיכום

פונקציות ציבוריות
`Unit`	`requestInterstitialAd( context: Context!, listener: CustomEventInterstitialListener!, serverParameter: String?, mediationAdRequest: MediationAdRequest!, customEventExtras: Bundle? )` הפונקציה נקראת על ידי הספרייה לבחירת רשת כדי לבקש מודעה מעברית.
`Unit`	`showInterstitial()` הצגת מודעת המעברון.

פונקציות שעברו בירושה

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

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

פונקציות ציבוריות

requestInterstitialAd

fun requestInterstitialAd(
    context: Context!,
    listener: CustomEventInterstitialListener!,
    serverParameter: String?,
    mediationAdRequest: MediationAdRequest!,
    customEventExtras: Bundle?
): Unit

הפונקציה נקראת על ידי הספרייה לבחירת רשת כדי לבקש מודעה מעברית.

אם הבקשה מצליחה, צריך להפעיל את onAdLoaded.

אם הבקשה לא מצליחה, צריך להפעיל את onAdFailedToLoad ב-listener עם סיבת השגיאה המתאימה.

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

פרמטרים
`context: Context!`	`Context` של `com.google.android.gms.ads.interstitial.InterstitialAd` שביקש את מודעת הביניים של האירוע בהתאמה אישית. מומלץ להשתמש ב-`android.app.Activity`.
`listener: CustomEventInterstitialListener!`	פונקציית listener לאירוע בהתאמה אישית עם קודים להתקשרות חזרה לאירועים שונים.
`serverParameter: String?`	מחרוזת שהוגדרה בממשק המשתמש של בעל התוכן הדיגיטלי כפרמטר לאירוע בהתאמה אישית.
`mediationAdRequest: MediationAdRequest!`	פרמטרים כלליים לטירגוט שמשמשים לשליחת בקשה להצגת מודעת מעברון.
`customEventExtras: Bundle?`	`Bundle` של פרמטרים שמוגדרים על ידי בעל התוכן הדיגיטלי על בסיס כל בקשה.

showInterstitial

fun showInterstitial(): Unit

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