MediationBannerAdapter

interface MediationBannerAdapter : MediationAdapter

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

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

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

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

סיכום

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

הפונקציה מחזירה View שאפשר ליצור ממנו עיבוד (render) כדי להציג את המודעה.
Unit
requestBannerAd(
    context: Context!,
    listener: MediationBannerListener!,
    serverParameters: Bundle!,
    adSize: AdSize!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
)

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

פונקציות שעברו בירושה
מ-com.google.android.gms.ads.mediation.MediationAdapter
Unit

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

הפונקציה נקראת כשהאפליקציה קוראת ל-onPause ב-.
Unit

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

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

getBannerView

fun getBannerView(): View!

הפונקציה מחזירה View שאפשר ליצור ממנו עיבוד (render) כדי להציג את המודעה.

הערך לא יכול להיות null אחרי קריאה ל-requestBannerAd ולפני קריאה ל-onDestroy. הוא יכול להיות null בכל שלב אחר.

requestBannerAd

fun requestBannerAd(
    context: Context!,
    listener: MediationBannerListener!,
    serverParameters: Bundle!,
    adSize: AdSize!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
): Unit

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

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

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

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

פרמטרים
context: Context!

ה-Context של AdView שיכיל את תצוגת הבאנר. מומלץ להשתמש ב-.
listener: MediationBannerListener!

מאזין למתאם עם קריאות חוזרות (callbacks) לאירועים שונים
serverParameters: Bundle!

פרמטרים נוספים שמוגדרים על ידי בעל התוכן הדיגיטלי בצד שרת בחירת הרשת
adSize: AdSize!

גודל המודעה שאמורה להתאחז. גודל המודעה שהמערכת מחזירה צריך להיות קרוב ככל האפשר לגודל שצוין בפרמטר הזה. אם גודל המודעה הזה לא נתמך, הבקשה אמורה להיכשל והפונקציה onAdFailedToLoad אמורה להופעל.
mediationAdRequest: MediationAdRequest!

פרמטרים כלליים שבעלי התוכן הדיגיטלי הזה ישתמש בהם כשישלח בקשה להצגת מודעה
mediationExtras: Bundle?

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