کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) در حالت تعمیر و نگهداری است. برای دریافت آخرین به‌روزرسانی‌ها و ویژگی‌ها، کیت توسعه نرم‌افزاری نسل بعدی GMA را منتقل و راه‌اندازی کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

کاتلین | جاوا

interface MediationInterstitialAdapter : MediationAdapter

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

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

انتظار می‌رود که آداپتور رویدادها را از طریق MediationInterstitialListener که در فراخوانی requestInterstitialAd ارسال شده است، ارسال کند. تمام پارامترهای لازم برای ایجاد یک درخواست تبلیغ باید در پارامترهای serverParameters ، MediationAdRequest و mediationExtras ارسال شوند.

توسعه‌دهندگان باید تلاش کنند تا به‌روزرسانی خودکار تبلیغات را در سمت کلاینت غیرفعال کنند. تبلیغاتی که به‌روزرسانی می‌شوند ممکن است نادیده گرفته شوند، نمایش داده نشوند و به اشتباه شمارش شوند.

خلاصه

کارکردهای عمومی
`Unit`	`requestInterstitialAd ( context: Context !, listener: MediationInterstitialListener !, serverParameters: Bundle !, mediationAdRequest: MediationAdRequest !, mediationExtras: Bundle ? )` توسط کتابخانه میانجیگری فراخوانی می‌شود تا از آداپتور درخواست تبلیغ کند.
`Unit`	`showInterstitial ()` بینابینی را نشان می‌دهد.

توابع ارثی

از 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 requestInterstitialAd(
    context: Context!,
    listener: MediationInterstitialListener!,
    serverParameters: Bundle!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
): Unit

توسط کتابخانه میانجیگری فراخوانی می‌شود تا از آداپتور درخواست تبلیغ کند.

اگر درخواست موفقیت‌آمیز باشد، متد onAdLoaded باید فراخوانی شود. در این مرحله، متن بینابینی نباید به طور خودکار نمایش داده شود. کتابخانه میانجیگری، متد showInterstitial را هنگام نمایش متن بینابینی فراخوانی می‌کند.

اگر درخواست ناموفق باشد، متد onAdFailedToLoad باید با یک علت خطای مناسب در listener فراخوانی شود.

توجه داشته باشید که این متد در نخ رابط کاربری (UI thread) فراخوانی می‌شود، بنابراین تمام اقدامات احتیاطی عمومی برای نوشتن کد در آن نخ اعمال می‌شود. به طور خاص، کد نباید هیچ متد مسدودکننده‌ای را فراخوانی کند.

پارامترها
`context: Context !`	`Context` مربوط به AdView که شامل نمای بنر خواهد بود. `android.app.Activity` ترجیح داده می‌شود.
`listener: MediationInterstitialListener !`	شنونده آداپتور با فراخوانی‌های مجدد برای رویدادهای مختلف
`serverParameters: Bundle !`	پارامترهای اضافی تعریف شده توسط ناشر در سمت سرور میانجیگری
`mediationAdRequest: MediationAdRequest !`	پارامترهای عمومی برای استفاده این ناشر هنگام ارسال درخواست تبلیغ
`mediationExtras: Bundle ?`	پارامترهای اضافی که توسط ناشر بر اساس هر درخواست تنظیم می‌شوند

نمایشبینابینی

fun showInterstitial(): Unit

نمایش بینابینی. این تابع می‌تواند هر زمانی پس از فراخوانی onAdLoaded فراخوانی شود.