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

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

CustomEventBanner

Kotlin |Java

public interface CustomEventBanner extends CustomEvent

אירוע מותאם אישית לתמיכה במודעות באנר.

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

המתאם אמור לחשוף אירועים דרך CustomEventBannerListener שמועברים בקריאה ל-requestBannerAd. צריך להעביר את כל הפרמטרים הנדרשים לשליחת בקשה להצגת מודעה באמצעות הפרמטרים serverParameter,‏ MediationAdRequest ו-customEventExtras.

סיכום

שיטות ציבוריות
`abstract void`	`requestBannerAd( Context context, CustomEventBannerListener listener, @Nullable String serverParameter, AdSize size, MediationAdRequest mediationAdRequest, @Nullable Bundle customEventExtras )` הספרייה לבחירת רשת קוראת ל-method הזה כדי לבקש צפייה מהאירוע המותאם אישית.

שיטות שעברו בירושה

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

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

שיטות ציבוריות

requestBannerAd

abstract void requestBannerAd(
    Context context,
    CustomEventBannerListener listener,
    @Nullable String serverParameter,
    AdSize size,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

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

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

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

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

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