آداپتور بنر میانجیگری

کاتلین | جاوا

interface MediationBannerAdapter : MediationAdapter

---

این رابط منسوخ شده است.

به جای آن Adapter استفاده کنید.

آداپتور برای شبکه‌های تبلیغاتی شخص ثالث که از تبلیغات بنری پشتیبانی می‌کنند.

چرخه حیات معمول برای یک آداپتور این است که requestBannerAd یک بار فراخوانی شود. در این مرحله، آداپتور باید یک تبلیغ را از شبکه تبلیغ درخواست کند و به شنونده گزارش دهد که آیا onAdLoaded است یا onAdFailedToLoad. درخواست‌های بعدی با یک نمونه جدید از آداپتور انجام می‌شوند. در پایان چرخه حیات، تمام تلاش برای فراخوانی onDestroy انجام می‌شود، اگرچه این تضمین شده نیست. توجه داشته باشید که requestBannerAd در نخ UI فراخوانی می‌شود، بنابراین تمام اقدامات احتیاطی استاندارد برای نوشتن کد در آن نخ اعمال می‌شود. به طور خاص، کد نباید هیچ روش مسدودکننده‌ای را فراخوانی کند.

انتظار می‌رود که آداپتور رویدادها را از طریق 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 فراخوانی کند.

کارکردهای عمومی

دریافت بنر ویو

fun getBannerView(): View!

یک View برمی‌گرداند که می‌تواند برای نمایش تبلیغ رندر شود.

این مقدار نباید بعد از فراخوانی requestBannerAd و قبل از فراخوانی onDestroy تهی (null) باشد. می‌تواند در هر زمان دیگری تهی (null) باشد.

درخواست بنر تبلیغاتی

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 !	شنونده آداپتور با فراخوانی‌های مجدد برای رویدادهای مختلف
serverParameters: Bundle !	پارامترهای اضافی تعریف شده توسط ناشر در سمت سرور میانجیگری
adSize: AdSize !	اندازه تبلیغی که باید دریافت شود. اندازه تبلیغ برگردانده شده باید تا حد امکان به اندازه مشخص شده در این پارامتر نزدیک باشد. اگر این اندازه تبلیغ پشتیبانی نشود، درخواست باید با شکست مواجه شود و onAdFailedToLoad باید فراخوانی شود.
mediationAdRequest: MediationAdRequest !	پارامترهای عمومی برای استفاده این ناشر هنگام ارسال درخواست تبلیغ
mediationExtras: Bundle ?	پارامترهای اضافی که توسط ناشر بر اساس هر درخواست تنظیم می‌شوند