広告イベントの取得

FiveSDKは広告視聴時の各種イベントの発生をFiveAdViewEventListenerに通知します。 通知先はSetViewEventListenerで登録できます。

以下では広告イベントの種類と対応するメソッドを解説します。

静止画広告・動画広告共通イベント

インプレッションイベント

広告の視聴が開始されたときに発生するイベントです。 各広告で一度のみ発生します。

このイベントの発生には、広告ビューが他のビューに隠されておらず、視認可能であると判定される必要があります。 広告枠を実装する際は、このイベントが発生することを確認することを推奨しています。

public void OnFiveAdImpression(FiveAdInterface f)

クローズイベント

広告を閉じたときに発生するイベントです。 FiveSDKではこのイベントの発生地点でリワードを付与する実装を推奨しています。

public void OnFiveAdClose(FiveAdInterface f)

クリックイベント

広告がクリックされ、遷移が発生したときに発生するイベントです。 アプリ内のWebViewに遷移した場合でも発生します。 1つの広告で複数回発生することがあります。

public void OnFiveAdClick(FiveAdInterface f)

エラーイベント

広告表示中になんらかのエラーが発生した場合に発生するイベントです。 原因の特定に役立つエラーコードの取得が可能です。

public void OnFiveAdViewError(FiveAdInterface f, FiveAdErrorCode errorCode)

想定されるエラーコードとその対応は以下の通りです。

エラーコード	エラー名称	対応
5	StorageError	デバイスのストレージに問題があります。別のデバイスを利用してください。
12	PlayerError	デバイスの処理性能の限界の可能性があります。複数の広告枠を同時に貼っている場合、その数を減らすことで改善する可能性があります。
6	InternalError	FiveSDKの実装側の問題の可能性があります。お問い合わせください。

動画広告のイベント

再生開始イベント

動画の再生が開始されたときに発生するイベントです。 各広告で一度のみ発生します。

public void OnFiveAdStart(FiveAdInterface f)

再生完了イベント

動画が最後まで再生されたときに発生するイベントです。 1つの広告で複数回発生することがあります。

public void OnFiveAdViewThrough(FiveAdInterface f)

リプレイイベント

動画がリプレイされたときに発生するイベントです。 1つの広告で複数回発生することがあります。

public void OnFiveAdReplay(FiveAdInterface f)

一時停止イベント

動画の再生が一時停止したときに発生するイベントです。 1つの広告で複数回発生することがあります。

public void OnFiveAdPause(FiveAdInterface f)

再生再開イベント

動画の再生が一時停止から復帰したときに発生するイベントです。 1つの広告で複数回発生することがあります。

public void OnFiveAdResume(FiveAdInterface f)