MediationInterstitialAdapter

interface MediationInterstitialAdapter : MediationAdapter


适用于支持插页式广告的第三方广告联盟的适配器。

适配器的典型生命周期是调用一次 requestInterstitialAd。此时,适配器应向广告联盟请求广告,并向监听器报告 onAdLoaded 或 onAdFailedToLoad。后续请求将使用新的适配器实例发出。在生命周期结束时,系统会尽力调用 onDestroy,但无法保证一定能调用。请注意,requestInterstitialAd 是在界面线程上调用的,因此适用于在该线程上编写代码的所有标准预防措施也适用于此方法。具体而言,代码不应调用任何阻塞方法。

适配器应通过 requestInterstitialAd 调用中传入的 MediationInterstitialListener 转发事件。发出广告请求所需的所有参数都应在 serverParametersMediationAdRequest mediationExtras 参数中传递。

适配器应尽力在客户端停用自动广告刷新。刷新后的广告可能会被忽略、不显示,并被错误地统计。

摘要

公共函数

Unit
requestInterstitialAd(
    context: Context!,
    listener: MediationInterstitialListener!,
    serverParameters: Bundle!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
)

由中介库调用,以向适配器请求广告。

Unit

显示插页式广告。

继承的函数

来自 com.google.android.gms.ads.mediation.MediationAdapter
Unit

拆除适配器控制。

Unit

当应用在 com.google.android.gms.ads.AdView 上调用 onPause 时调用。

Unit

当应用在 com.google.android.gms.ads.AdView 上调用 onResume 时调用。

公共函数

requestInterstitialAd

fun requestInterstitialAd(
    context: Context!,
    listener: MediationInterstitialListener!,
    serverParameters: Bundle!,
    mediationAdRequest: MediationAdRequest!,
    mediationExtras: Bundle?
): Unit

由中介库调用,以向适配器请求广告。

如果请求成功,则应调用 onAdLoaded 方法。此时,插页式广告不应自动展示。当需要展示插页式广告时,中介库会调用 showInterstitial 方法。

如果请求失败,应使用适当的错误原因对 listener 调用 onAdFailedToLoad 方法。

请注意,此方法是在界面线程上调用的,因此适用于在该线程上编写代码的所有一般注意事项也适用于此方法。具体而言,代码不应调用任何阻塞方法。

参数
context: Context!

将包含横幅视图的 AdView 的 Context。建议使用 android.app.Activity

listener: MediationInterstitialListener!

监听器,用于向适配器提供各种事件的回调

serverParameters: Bundle!

发布商在中介服务器端定义的其他参数

mediationAdRequest: MediationAdRequest!

发布商在发出广告请求时使用的通用参数

mediationExtras: Bundle?

发布商根据具体请求设置的其他参数

showInterstitial

fun showInterstitial(): Unit

显示插页式广告。可以在调用 onAdLoaded 之后的任何时间调用此方法。