MediationBannerAdapter

Kotlin |Java

interface MediationBannerAdapter : MediationAdapter

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

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

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

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

סיכום

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

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

‫com.google.android.gms.ads.mediation.MediationAdapter

`Unit`	`onDestroy()` הפונקציה מפרקת את בקר המתאם.
`Unit`	`onPause()` הפונקציה נקראת כשהאפליקציה קוראת ל-`onPause` ב-`com.google.android.gms.ads.AdView`.
`Unit`	`onResume()` הפונקציה נקראת כשהאפליקציה קוראת ל-`onResume` ב-`com.google.android.gms.ads.AdView`.

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

getBannerView

fun getBannerView(): View!

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

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

requestBannerAd

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

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

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

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

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

פרמטרים
`context: Context!`	ה-`Context` של AdView שיכיל את תצוגת הבאנר. עדיף להשתמש ב-`android.app.Activity`.
`listener: MediationBannerListener!`	פונקציית listener למתאם עם קריאות חוזרות (callbacks) לאירועים שונים
`serverParameters: Bundle!`	פרמטרים נוספים שהוגדרו על ידי בעל האתר בצד השרת של תהליך הגישור
`adSize: AdSize!`	גודל המודעה לאחזור. הגודל של המודעה שמוחזרת צריך להיות קרוב ככל האפשר לגודל שצוין בפרמטר הזה. אם גודל המודעה הזה לא נתמך, הבקשה צריכה להיכשל והשיטה onAdFailedToLoad צריכה להיקרא.
`mediationAdRequest: MediationAdRequest!`	פרמטרים כלליים שבעל התוכן הדיגיטלי יכול להשתמש בהם כשהוא שולח בקשה להצגת מודעה
`mediationExtras: Bundle?`	פרמטרים נוספים שהלייבל מגדיר על בסיס כל בקשה