CustomEventInterstitial

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?
)

הספרייה לבחירת רשת (Mediation) קוראת ל-method הזה כדי לבקש מודעה מעברון.

Unit

מציגים את המעברון.

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

מ-com.google.android.gms.ads.mediation.customevent.CustomEvent
Unit

הורדת הבקרה של המתאם.

Unit

הפונקציה נקראת כשהאפליקציה קוראת ל-pause.

Unit

הפונקציה נקראת כשהאפליקציה קוראת ל-resume.

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

requestInterstitialAd

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

הספרייה לבחירת רשת (Mediation) קוראת ל-method הזה כדי לבקש מודעה מעברון.

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

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

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

פרמטרים
context: Context!

ה-Context של המודעות ששלחו את הבקשה להצגת המודעות האנכיות המעבריות של האירוע בהתאמה אישית. עדיף להשתמש ב-android.app.Activity.

listener: CustomEventInterstitialListener!

מאזין לאירוע בהתאמה אישית עם קריאות חוזרות (callbacks) לאירועים שונים.

serverParameter: String?

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

mediationAdRequest: MediationAdRequest!

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

customEventExtras: Bundle?

Bundle של פרמטרים שהוגדרו על ידי בעל התוכן הדיגיטלי על בסיס בקשה.

showInterstitial

fun showInterstitial(): Unit

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