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

public interface MediationInterstitialAdapter extends MediationAdapter


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

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

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

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

خلاصه

روش‌های عمومی

abstract void
requestInterstitialAd (
Context context,
MediationInterstitialListener listener,
Bundle serverParameters,
MediationAdRequest mediationAdRequest,
@ Nullable Bundle mediationExtras
)

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

abstract void

بینابینی را نشان می‌دهد.

روش‌های ارثی

از com.google.android.gms.ads.mediation.MediationAdapter
abstract void

کنترل آداپتور را پاره می‌کند.

abstract void

زمانی فراخوانی می‌شود که برنامه، متد onPause روی com.google.android.gms.ads.AdView فراخوانی کند.

abstract void

زمانی فراخوانی می‌شود که برنامه، onResume روی com.google.android.gms.ads.AdView فراخوانی کند.

روش‌های عمومی

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

abstract void requestInterstitialAd(
    Context context,
    MediationInterstitialListener listener,
    Bundle serverParameters,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

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

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

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

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

پارامترها
Context context

Context مربوط به AdView که شامل نمای بنر خواهد بود. android.app.Activity ترجیح داده می‌شود.

MediationInterstitialListener listener

شنونده آداپتور با فراخوانی‌های مجدد برای رویدادهای مختلف

Bundle serverParameters

پارامترهای اضافی تعریف شده توسط ناشر در سمت سرور میانجیگری

MediationAdRequest mediationAdRequest

پارامترهای عمومی برای استفاده این ناشر هنگام ارسال درخواست تبلیغ

@ Nullable Bundle mediationExtras

پارامترهای اضافی که توسط ناشر بر اساس هر درخواست تنظیم می‌شوند

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

abstract void showInterstitial()

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