MediationBannerAdapter

interface MediationBannerAdapter : MediationAdapter


バナー広告をサポートする第三者広告ネットワーク用のアダプタ。

アダプターの一般的なライフサイクルでは、requestBannerAd が 1 回呼び出されます。この時点で、アダプタは広告ネットワークに広告をリクエストし、onAdLoaded または onAdFailedToLoad のいずれかをリスナーに報告する必要があります。以降のリクエストは、アダプタの新しいインスタンスを使用して行われます。ライフサイクルの終了時に、onDestroy の呼び出しが試みられますが、保証はされません。requestBannerAd は UI スレッドで呼び出されるため、そのスレッドでコードを記述する際の標準的な注意事項がすべて適用されます。特に、コードでブロック メソッドを呼び出すことはできません。

アダプタは、requestBannerAd 呼び出しで渡された MediationBannerListener を介してイベントを公開することが想定されています。広告リクエストを行うために必要なすべてのパラメータは、serverParametersMediationAdRequestmediationExtras の各パラメータで渡す必要があります。

アダプタは、クライアント サイドで広告の自動更新を無効にするよう努める必要があります。更新された広告は無視され、表示されず、正しくカウントされない可能性があります。

概要

パブリック関数

View!

広告を表示するためにレンダリングできる View を返します。

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

メディエーション ライブラリによって呼び出され、アダプタからバナー広告をリクエストします。

継承される関数

継承元: com.google.android.gms.ads.mediation.MediationAdapter
Unit

アダプター コントロールを破棄します。

Unit

アプリケーションが com.google.android.gms.ads.AdViewonPause を呼び出すと呼び出されます。

Unit

アプリケーションが com.google.android.gms.ads.AdViewonResume を呼び出すと呼び出されます。

パブリック関数

getBannerView

fun getBannerView(): View!

広告を表示するためにレンダリングできる View を返します。

requestBannerAd の呼び出し後、onDestroy の呼び出し前は null にしてはなりません。それ以外のときは null になることがあります。

requestBannerAd

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

メディエーション ライブラリによって呼び出され、アダプタからバナー広告をリクエストします。

リクエストが成功すると、onAdLoaded メソッドが呼び出されます。

リクエストが失敗した場合は、適切なエラー原因とともに listener で onAdFailedToLoad メソッドを呼び出す必要があります。

このメソッドは UI スレッドで呼び出されるため、そのスレッドでコードを記述する際の標準的な注意事項がすべて適用されます。特に、コードでブロック メソッドを呼び出さないようにする必要があります。

パラメータ
context: Context!

バナービューを含む AdView の Contextandroid.app.Activity が推奨されます。

listener: MediationBannerListener!

さまざまなイベントのコールバックを含むアダプタへのリスナー

serverParameters: Bundle!

メディエーション サーバー側でパブリッシャーが定義した追加パラメータ

adSize: AdSize!

取得する広告のサイズ。返される広告のサイズは、このパラメータで指定されたサイズにできるだけ近いサイズである必要があります。この広告サイズがサポートされていない場合、リクエストは失敗し、onAdFailedToLoad が呼び出されます。

mediationAdRequest: MediationAdRequest!

このパブリッシャーが広告リクエストを行う際に使用する汎用パラメータ

mediationExtras: Bundle?

パブリッシャーがリクエストごとに設定する追加パラメータ