כדי לדון במוצרים שלנו ולספק משוב, אתם יכולים להצטרף לערוץ הרשמי של AdMob ב-Discord בשרת Google Advertising and Measurement Community.

דף זה תורגם על ידי Cloud Translation API.

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 )` הספרייה לבחירת רשת (Mediation) קוראת ל-method הזה כדי לבקש מודעה מעברון.
`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
)

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

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

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

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

פרמטרים
`Context context`	ה-`Context` של המודעות ששלחו את הבקשה להצגת המודעות האנכיות המעבריות של האירוע בהתאמה אישית. עדיף להשתמש ב-`android.app.Activity`.
`CustomEventInterstitialListener listener`	מאזין לאירוע בהתאמה אישית עם קריאות חוזרות (callbacks) לאירועים שונים.
`@Nullable String serverParameter`	המחרוזת שמוגדרת בממשק המשתמש של בעל התוכן הדיגיטלי כפרמטר של האירוע המותאם אישית.
`MediationAdRequest mediationAdRequest`	פרמטרים כלליים של טירגוט לשימוש כששולחים בקשה להצגת מודעה מעברון.
`@Nullable Bundle customEventExtras`	`Bundle` של פרמטרים שהוגדרו על ידי בעל התוכן הדיגיטלי על בסיס בקשה.

showInterstitial

abstract void showInterstitial()

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