インフィード広告クラスの説明

AdfurikunNativeAd

コンストラクタ

AdfurikunNativeAd(activity: Activity?, private val mAppId: String?, width: Int = 320, height: Int = 180)

パラメータ	説明
activity	広告を表示するActivity
mAppId	広告枠ID
width	広告の横幅
height	広告の縦幅

プロパティ

val isPrepared: Boolean

広告が準備完了したかを返します。

---

val nativeAdView: View?

ネイティブ広告のビューを返します。

---

インスタンスメソッド

fun setAdfurikunNativeAdLoadListener(listener: AdfurikunNativeAdLoadListener?)

ロードコールバックを受け取るリスナーを登録します。

パラメータ	説明
listener	ロードコールバックを受け取るリスナーオブジェクト

---

fun setAdfurikunNativeAdVideoListener(listener: AdfurikunNativeAdVideoListener?)

広告イベントコールバックを受け取るリスナーを登録します。

パラメータ	説明
listener	広告イベントコールバックを受け取るリスナーオブジェクト

---

fun load()
fun loadWithTimeout(timeout: Float)

各アドネットワークの広告ロードを開始します。

Timeoutが設定されていると広告読み込みの結果Callbackは必ずTimeout以内に発生します。Timeout設定について詳細内容はリワード広告実装のベストプラクティスを確認してください。

---

fun play()
fun play(customParams: Map<String, String>?)

広告を表示します。再生準備が完了したアドネットワークの中から、1つ動画が選択されます。

パラメータ	説明
customParams	イベントにcustomParams情報が送信されます

---

fun remove()

状態管理の破棄を行います。 ActivityのonDestroy()、もしく 明示的に破棄したい時に実行してください。実行後に再開することはできません。必ず動画リワードインスタンスを破棄してください。

---

fun releaseNativeAdView()

広告ビューを解放します。

---

fun setIsAutoCenterAlign(autoCenterAlign: Boolean)

trueを設定すると広告が中央に表示されます。

---

fun changeAdSize(width: Int, height: Int)

広告のサイズを変更します。

---

fun pauseByOperation()

広告の再生を一時停止します

---

AdfurikunNativeAdLoadListener

fun onNativeAdLoadFinish(adInfo: AdfurikunNativeAdInfo?, appId: String?)

広告のロード成功時に呼ばれます。

パラメータ	説明
adInfo	広告情報

adInfoプロパティ	説明
adNetworkKey	アドネットワークキー
title	広告のタイトル (アドネットワークによっては非対応)
description	広告の説明文 (アドネットワークによっては非対応)

---

fun onNativeAdLoadError(error: AdfurikunMovieError?, appId: String?)

ロード失敗時に呼ばれます。

パラメータ	説明
error	エラー情報
error.adNetworkErrorList	アドネットワークから発生したエラー内容です。詳細はアドネットワーク別エラーコード情報
appId	広告枠ID

エラータイプ	コード	内容
NO_AD	0	広告の在庫がない場合
NO_NETWORK	1	オフラインまたはフライトモードの場合
LOADING	2	広告読み込み中の場合
INVALID_APP_ID	3	広告IDが登録されている内容と異なる場合
API_REQUEST_FAILURE	4	リクエストが失敗した場合
NO_SUPPORT_API_VERSION	5	API Levelが14以下の場合
PLAYER_ITEM_LOAD_FAILURE	6	広告の読み込みが失敗した場合
PLAYER_ITEM_PLAY_FAILURE	7	広告の再生が失敗した場合
OTHER_ERROR	8	その他の予期せぬエラーが発生した場合

---

AdfurikunNativeAdVideoListener

fun onNativeAdViewPlayStart(appId: String?)

広告の再生開始時に呼ばれます。

パラメータ	説明
appId	広告枠ID

---

fun onNativeAdViewPlayFinish(appId: String?, isVideoAd: Boolean)

広告を最後まで視聴した時に呼ばれます。

パラメータ	説明
appId	広告枠ID
isVideoAd	動画かどうか

---

fun onNativeAdViewPlayFail(appId: String?, error: AdfurikunMovieError?)

広告の表示時にアドネットワーク側でエラーを検知した際に呼ばれます。アプリの実装に応じて必要であれば再度広告読み込みを行ってください。

パラメータ	説明
appId	広告ID
error	エラー情報
error.adNetworkErrorList	アドネットワークから発生したエラー内容です。詳細はアドネットワーク別エラーコード情報

---

fun onNativeAdViewClicked(appId: String?)

動画がクリックされた時に呼ばれます。

パラメータ	説明
appId	広告枠ID