アプリ起動時広告クラスの説明 - glossom-dev/AdfurikunSDK-Android GitHub Wiki
AdfurikunAppOpenAd
コンストラクタ
AdfurikunAppOpenAd(appId: String?, context: Context?)
パラメータ | 説明 |
---|---|
appId |
広告枠ID |
context |
コンテキスト |
プロパティ
val isPrepared: Boolean
広告が準備完了したかを返します。
インスタンスメソッド
initialize(appLogoIcon: Int?)
各アドネットワークの初期化を開始します。
パラメータ | 説明 |
---|---|
appLogoIcon |
DrawableのリソースIDをセットすることで、広告に任意のアイコンを重ねて表示します。(Pangle,Mintegralのみ対応) |
fun setAdfurikunAppOpenAdListener(listener: AdfurikunAppOpenAdListener?)
パラメータ | 説明 |
---|---|
listener |
リスナーオブジェクト |
fun load(timeout: Long)
各アドネットワークの広告ロードを開始します。
広告の取得結果に関するコールバック
(AdfurikunAppOpenAdListener.onPrepareSuccess
またはonPrepareFailure
)は、
必ずtimeout
引数で設定された時間内に呼び出されます。詳細はベストプラクティスをご確認ください。
パラメータ | 説明 |
---|---|
timeout |
ロードの成否が確定するまでの時間(単位:ミリ秒) |
fun play(activity: Activity)
広告を表示します。再生準備が完了したアドネットワークの中から、1つ広告が選択されます。
パラメータ | 説明 |
---|---|
activity |
広告を表示するActivity |
fun destroy()
状態管理の破棄を行います。
ActivityのonDestroy()
メソッド内で実行するか、あるいは明示的に破棄したい時に実行してください。
AdfurikunAppOpenAdListener
fun onPrepareSuccess(appId: String?)
広告のロード成功時に呼ばれます。
パラメータ | 説明 |
---|---|
appId |
広告枠ID |
fun onStartPlaying(data: AppOpenAdData)
広告の再生開始時に呼ばれます。
パラメータ | 説明 |
---|---|
data |
データ |
AppOpenAdData
プロパティ | 説明 |
---|---|
adfurikunAppId |
広告枠ID |
adnetworkKey |
アドネットワークキー |
adnetworkName |
アドネットワーク名 |
fun onAdClose(data: AppOpenAdData)
広告を閉じた時に呼ばれます。
パラメータ | 説明 |
---|---|
data |
データ |
fun onPrepareFailure(appId: String?, error: AdfurikunMovieError?)
広告ロード失敗時に呼ばれます。
パラメータ | 説明 |
---|---|
appId |
広告枠ID |
error |
エラー情報詳細はエラーコードリファレンスをご参照ください |
fun onFailedPlaying(data: AppOpenAdData, error: AdfurikunMovieError?)
広告の表示が失敗した場合に呼ばれます。
パラメータ | 説明 |
---|---|
data |
データ |
error |
エラー情報詳細はエラーコードリファレンスをご参照ください |
再生失敗が発生する理由は以下が考えられます。
発生理由 |
---|
既に広告を再生している |
オフライン状態でPlay関数を実行した |
アドネットワークの広告再生関数の呼び出し時に異常が発生した |
アドネットワーク側で広告再生時のエラーを検知した |
この関数が呼ばれた際は、onAdClose
は呼ばれません。
必要に応じて、再度広告読み込みを行ってください。