リワード広告実装方法

動画リワード広告

実装準備

プロジェクトにSDKを追加していない場合、以下のいずれかの方法でSDKを追加してください。

• SDKの組み込み

動画リワード広告の初期化

AdfurikunMovieReward クラスのインスタンスを生成します。
“アドフリくん管理画面で発行された広告枠 ID” 、広告を表示するActivityを引数に指定して下さい。
AdfurikunMovieRewardインスタンスの内部状態はActivityのライフサイクルに合わせて管理する為、それぞれのライフサイクルに合わせて関数を実装して下さい。

Kotlin

//AdfurikunMovieReward インスタンス変数を定義
private var mReward: AdfurikunMovieReward? = null
//リスナーを定義
private val mListener = object : AdfurikunMovieRewardListener {
    override fun onPrepareSuccess(isManualMode: Boolean) {
        // 広告の準備完了直後に実行する処理を記述してください
    }

    override fun onPrepareFailure(error: AdfurikunMovieError?) {
        // 広告の準備失敗直後に実行する処理を記述してください
    }

    override fun onStartPlaying(data: MovieRewardData) {
        // 動画の再生開始直後に実行する処理を記述してください        
    }

    override fun onFinishedPlaying(data: MovieRewardData) {
        // 広告の再生が完了した時に実行する処理を記述してください
    }

    override fun onFailedPlaying(data: MovieRewardData, error: AdfurikunMovieError?) {
        // 動画の再生に失敗した時に実行する処理を記述してください
    }

    override fun onAdClose(data: MovieRewardData) {
        // 動画の画面を閉じた時に実行する処理を記述してください
    }
}

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 広告枠ID・Activityを指定し、動画リワードのインスタンスを生成
    mReward = AdfurikunMovieReward(広告枠ID, this)
    mReward.setAdfurikunMovieRewardListener(mListener)
}

override fun onDestroy() {
    mReward?.onDestroy()
    super.onDestroy()
}

Java

//AdfurikunMovieReward インスタンス変数を定義
AdfurikunMovieReward mReward;
//リスナーを定義
AdfurikunMovieRewardListener mListener = new AdfurikunMovieRewardListener(){
    @Override
    public void onPrepareSuccess(boolean isManualMode) {
    // 動画の再生が可能になりました。
    // 状態をフラグなどで管理してください
    }

    @Override
    public void onPrepareFailure(AdfurikunMovieError error) {
    // 広告の読み込みが失敗になりました。
    // もう一度広告の読み込みしてください。
    }

    @Override
    public void onStartPlaying(MovieRewardData data) {
        // 動画の再生を開始します。
        // 各アドネットワークが用意したActivityが起動して、動画再生が始まります。
    }

    @Override
    public void onFinishedPlaying(MovieRewardData data) {
        // 動画の再生が完了しました。
        // リワード 付与など、ユーザへの対応を行ってください。
    }

    @Override
    public void onFailedPlaying(MovieRewardData data, AdfurikunMovieError error) {
        // 動画の再生が失敗しました。
        // 再生開始時にネットワークへ接続していない場合も、失敗として通知します。
    }

    @Override
    public void onAdClose(MovieRewardData data) {
        // 動画広告のActivityが終了しました。
        // アプリのActivityが復帰します。
    }
}

@Override
protected void onCreate(Bundle bundle) {
    // 広告枠ID・Activityを指定し、動画リワードのインスタンスを生成
    mReward = new AdfurikunMovieReward(広告枠ID, this);
    mReward.setAdfurikunMovieRewardListener(mListener);
}

@Override
protected void onDestroy() {
    mReward.onDestroy();
    super.onDestroy();
}

動画リワード広告のロード

loadメソッドを呼ぶことで各アドネットワークへの表示準備を開始します。

Kotlin

mReward.load()

Java

mReward.load();

動画リワード広告の表示

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

Kotlin

if ( mReward.isPrepared() ) {
    // 再生開始
    mReward.play()
}

Java

if ( mReward.isPrepared() ) {
    // 再生開始。
    mReward.play();
}