MediationBannerAdapter
interface MediationBannerAdapter : MediationAdapter
バナー広告をサポートするサードパーティ広告ネットワーク用のアダプタ。
アダプターの一般的なライフサイクルでは、requestBannerAd が 1 回呼び出されます。この時点で、アダプタは広告ネットワークから広告をリクエストし、onAdLoaded または onAdFailedToLoad のいずれかでリスナーに報告する必要があります。以降のリクエストは、アダプタの新しいインスタンスで実行されます。ライフサイクルの終了時に onDestroy を呼び出すよう最善を尽くしますが、保証されるものではありません。requestBannerAd は UI スレッドで呼び出されるため、そのスレッドでコードを記述する際の標準的な注意事項がすべて適用されます。特に、ブロックするメソッドを呼び出してはいけません。
アダプタは、requestBannerAd 呼び出しで渡された MediationBannerListener を介してイベントを公開することが想定されています。広告リクエストを行うために必要なすべてのパラメータは、serverParameters、MediationAdRequest、mediationExtras パラメータで渡す必要があります。
アダプタは、クライアント側で広告の自動更新を無効にするよう努める必要があります。更新された広告は、無視されたり、表示されなかったり、正しくカウントされないことがあります。
概要
パブリック関数 |
|
|---|---|
View! |
レンダリングして広告を表示できる |
Unit |
requestBannerAd(メディエーション ライブラリから呼び出され、アダプタからバナー広告をリクエストします。 |
継承された関数 |
|---|
パブリック関数
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 の |
listener: MediationBannerListener! |
さまざまなイベントのコールバックを含むアダプタへのリスナー |
serverParameters: Bundle! |
パブリッシャーがメディエーション サーバーサイドで定義した追加パラメータ |
adSize: AdSize! |
取得する広告のサイズ。返される広告サイズは、このパラメータで指定されたサイズにできるだけ近いサイズである必要があります。この広告サイズがサポートされていない場合は、リクエストが失敗し、onAdFailedToLoad が呼び出されます。 |
mediationAdRequest: MediationAdRequest! |
このパブリッシャーが広告リクエストの際に使用する一般的なパラメータ |
mediationExtras: Bundle? |
パブリッシャーがリクエストごとに設定する追加パラメータ |