# 広告イベントの取得
FiveSDKは広告視聴時の各種イベントの発生を各種コールバックプロトコルに通知します。
通知先はsetEventListenerで登録できます。
| 広告フォーマット | イベント通知プロトコル |
|---|---|
| カスタムレイアウト広告 | FADCustomLayoutEventListener |
| 動画リワード広告 | FADVideoRewardEventListener |
| インタースティシャル広告 | FADInterstitialEventListener |
| ネイティブ広告 | FADNativeEventListener |
以下では広告イベントの種類と対応するメソッドを解説します。
# 静止画広告・動画広告共通イベント
# インプレッションイベント
広告の視聴が開始されたときに発生するイベントです。 各広告で一度のみ発生します。
このイベントの発生には、広告ビューが他のビューに隠されておらず、視認可能であると判定される必要があります。 広告枠を実装する際は、このイベントが発生することを確認することを推奨しています。
# クリックイベント
広告がクリックされ、遷移が発生したときに発生するイベントです。 アプリ内のWebViewやStoreKitに遷移した場合でも発生します。 1つの広告で複数回発生することがあります。
# エラーイベント
広告表示中になんらかのエラーが発生した場合に発生するイベントです。 原因の特定に役立つエラーコードの取得が可能です。
想定されるエラーコードとその対応は以下の通りです。
| エラーコード | エラー名称 | 対応 |
|---|---|---|
| 5 | StorageError | デバイスのストレージに問題があります。別のデバイスを利用してください。 |
| 12 | PlayerError | デバイスの処理性能の限界の可能性があります。複数の広告枠を同時に貼っている場合、その数を減らすことで改善する可能性があります。 |
| 6 | InternalError | FiveSDKの実装側の問題の可能性があります。お問い合わせください。 |
# リワードイベント
リワード広告においてリワード条件を満たしたときに発生するイベントです。
# カスタムレイアウト/ネイティブ広告ビュー除去イベント
カスタムレイアウト/ネイティブ広告ビューが除去されたときに発生するイベントです。 広告テンプレートの閉じるボタンがタップされたときなどに発生します。
# フルスクリーン広告ビューオープンイベント
フルスクリーン広告ビューが開始したときに発生するイベントです。
# フルスクリーン広告ビュークローズイベント
フルスクリーン広告ビューが終了したときに発生するイベントです。
# 動画広告のイベント
# 再生開始イベント
動画の再生が開始されたときに発生するイベントです。 初回再生時だけでなく一時停止からの再開時やリプレイ時にも発生します。
# 再生完了イベント
動画が最後まで再生されたときに発生するイベントです。 1つの広告で複数回発生することがあります。
# 一時停止イベント
動画の再生が一時停止したときに発生するイベントです。 1つの広告で複数回発生することがあります。