# v2.7.20240112 広告イベント取得方法の変更
# 概要
本ガイドではAndroid FiveSDK v2.7.20240112で導入された新しい広告イベント取得方法への移行手順を説明します。
新APIでは広告イベントの取得に関して次の変更が導入されました。
- 広告フォーマットごとに異なるコールバックインターフェイスを提供
- （動画リワード広告）リワード付与イベントを提供
以下ではこれらの変更に対応する方法について説明します。
# 広告フォーマットごとに異なるコールバックインターフェイスを提供
旧APIでは広告フォーマットが何であれ同じコールバックインターフェイスを提供していました。 新APIでは広告フォーマットごとに異なるコールバックインターフェイスを提供します。
NOTE
広告オブジェクトのロード完了を通知する FiveAdLoadListener コールバックインターフェイスについては移行作業は必要ありません。
各フォーマットごとに広告イベント取得コードを新APIに書き換えてください。 新旧APIの対応表および書き換えBefore-Afterのサンプルコードを以下に示します。
# カスタムレイアウト広告
# 新旧API対応表
| 広告イベント | 種別 | 旧API | 新API |
|---|---|---|---|
| エラー | 動画・静止画共通 | onFiveAdViewError | onViewError |
| インプレッション | 動画・静止画共通 | onFiveAdImpression | onImpression |
| クリック | 動画・静止画共通 | onFiveAdClick | onClick |
| カスタムレイアウト広告ビュー除去 | 動画・静止画共通 | onFiveAdClose | onRemove |
| 再生開始 | 動画広告のみ | onFiveAdStart | onPlay |
| 一時停止 | 動画広告のみ | onFiveAdPause | onPause |
| 再生完了 | 動画広告のみ | onFiveAdViewThrough | onViewThrough |
| 再生再開 | 動画広告のみ | onFiveAdResume | 廃止 (onPlay に統合) |
| リプレイ | 動画広告のみ | onFiveAdReplay | 廃止 (onPlay に統合) |
| ストール | 動画広告のみ | onFiveAdStall | 廃止 |
| ストール復帰 | 動画広告のみ | onFiveAdRecover | 廃止 |
# Before(旧API)
# After(新API)
# 動画リワード広告
# 新旧API対応表
| 広告イベント | 種別 | 旧API | 新API |
|---|---|---|---|
| エラー | 動画・静止画共通 | onFiveAdViewError | onViewError |
| リワード | 動画・静止画共通 | 該当なし (onFiveAdClose に統合) | onReward |
| インプレッション | 動画・静止画共通 | onFiveAdImpression | onImpression |
| クリック | 動画・静止画共通 | onFiveAdClick | onClick |
| フルスクリーン広告ビューオープン | 動画・静止画共通 | 該当なし | onFullScreenOpen |
| フルスクリーン広告ビュークローズ | 動画・静止画共通 | onFiveAdClose | onFullScreenClose |
| 再生開始 | 動画広告のみ | onFiveAdStart | onPlay |
| 一時停止 | 動画広告のみ | onFiveAdPause | onPause |
| 再生完了 | 動画広告のみ | onFiveAdViewThrough | onViewThrough |
| 再生再開 | 動画広告のみ | onFiveAdResume | 廃止 (onPlay に統合) |
| リプレイ | 動画広告のみ | onFiveAdReplay | 廃止 (onPlay に統合) |
| ストール | 動画広告のみ | onFiveAdStall | 廃止 |
| ストール復帰 | 動画広告のみ | onFiveAdRecover | 廃止 |
# Before(旧API)
# After(新API)
# インタースティシャル広告
# 新旧API対応表
| 広告イベント | 種別 | 旧API | 新API |
|---|---|---|---|
| エラー | 動画・静止画共通 | onFiveAdViewError | onViewError |
| インプレッション | 動画・静止画共通 | onFiveAdImpression | onImpression |
| クリック | 動画・静止画共通 | onFiveAdClick | onClick |
| フルスクリーン広告ビューオープン | 動画・静止画共通 | 該当なし | onFullScreenOpen |
| フルスクリーン広告ビュークローズ | 動画・静止画共通 | onFiveAdClose | onFullScreenClose |
| 再生開始 | 動画広告のみ | onFiveAdStart | onPlay |
| 一時停止 | 動画広告のみ | onFiveAdPause | onPause |
| 再生完了 | 動画広告のみ | onFiveAdViewThrough | onViewThrough |
| 再生再開 | 動画広告のみ | onFiveAdResume | 廃止 (onPlay に統合) |
| リプレイ | 動画広告のみ | onFiveAdReplay | 廃止 (onPlay に統合) |
| ストール | 動画広告のみ | onFiveAdStall | 廃止 |
| ストール復帰 | 動画広告のみ | onFiveAdRecover | 廃止 |
# Before(旧API)
# After(新API)
# ネイティブ広告
# 新旧API対応表
| 広告イベント | 種別 | 旧API | 新API |
|---|---|---|---|
| エラー | 動画・静止画共通 | onFiveAdViewError | onViewError |
| インプレッション | 動画・静止画共通 | onFiveAdImpression | onImpression |
| クリック | 動画・静止画共通 | onFiveAdClick | onClick |
| ネイティブ広告ビュー除去 | 動画・静止画共通 | onFiveAdClose | onRemove |
| 再生開始 | 動画広告のみ | onFiveAdStart | onPlay |
| 一時停止 | 動画広告のみ | onFiveAdPause | onPause |
| 再生完了 | 動画広告のみ | onFiveAdViewThrough | onViewThrough |
| 再生再開 | 動画広告のみ | onFiveAdResume | 廃止 (onPlay に統合) |
| リプレイ | 動画広告のみ | onFiveAdReplay | 廃止 (onPlay に統合) |
| ストール | 動画広告のみ | onFiveAdStall | 廃止 |
| ストール復帰 | 動画広告のみ | onFiveAdRecover | 廃止 |
# Before(旧API)
# After(新API)
# （動画リワード広告）リワード付与イベントを提供
旧APIは広告枠が閉じるタイミングのイベントをもってリワードを付与することを推奨してきました。 新APIからは独立したリワード付与イベントを提供しています。 今後はリワード付与についてはそちらの新しいイベントをご利用ください。
ユーザーにリワードを付与するコードを次のように書き換えてください。