静止画広告SDKから動画広告SDKへの移行について

本ドキュメントでは静止画広告SDKを導入してあるアプリケーションに動画広告SDKを導入する際の移行について説明します。

統合後の動作につきましては、静止画広告SDKでは広告を表示するViewをアプリケーションで作成して広告読み込みをするようになってましたが、 動作広告SDKでは広告を管理するインスタンスを作成した後広告読み込みを開始すると広告が表示されるViewを含む広告情報がListenerのパラメータとして渡されますので、 それを適切な位置にAddViewするやり方になりました。

バナー広告・パネル広告

初期化

• 既存の実装

final LinearLayout root = new LinearLayout(this);
int ad_height = 50;
LayoutParams adParams = new LayoutParams(LayoutParams.MATCH_PARENT, ad_height);

adfurikunView = new AdfurikunLayout(this);
root.addView(adfurikunView, adParams);
adfurikunView.setAdfurikunAppKey(ADFURIKUN_APPID);

• 動画広告SDKの実装

AdfurikunBanner mBannerAd = null;
AdfurikunBannerAdInfo mBannerAdInfo = null;
mBannerAd = AdfurikunBanner(this, AdfurikunConst.ADFURIKUN_BANNER_AD_APPID,320,50);
mBannerAd.load();

広告取得

広告取得通知は AdfurikunBannerLoadListener に追加しました。

• 既存の実装

特になし

• 動画広告SDKの実装

void onBannerLoadFinish(AdfurikunBannerAdInfo adInfo, String appId);
void onBannerLoadError(AdfurikunMovieError errorObject, String appId);

広告再生

• 既存の実装

adfurikunView.nextAd();

• 動画広告SDKの実装

mBannerAd.play();

再生完了・破棄

• 既存の実装

adfurikunView.destroy();

• 動画広告SDKの実装

mBannerAd.remove();

Deprecatedされる機能

• テストモード廃止
• 管理画面に設定されてある「リフレッシュ頻度」による自動切り替え機能廃止
• トランジションアニメーション機能廃止

インタースティシャル広告

初期化

• 既存の実装

AdfurikunIntersAd.addIntersAdSetting(this, ADFURIKUN_APPID, *_TITLE_*, *_DEFAULT_*, *_DEFAULT_MAX, *_BUTTON_NAME, "");    // INTERSAD_DEFAULT
AdfurikunIntersAd.addIntersAdSetting(this, ADFURIKUN_APPID, *_TITLE_*, *_CUSTOM_*, *_CUSTOM_MAX, *_BUTTON_NAME, *_CUSTOM_BUTTON_NAME);    // INTERSAD_CUSTOM

• 動画広告SDKの実装

AdfurikunInter mInter = null
mInter = AdfurikunInter(AdfurikunConst.ADFURIKUN_INTER_APPID, this)
mInter.load()

広告取得

広告取得通知はOnAdfurikunIntersAdFinishListenerから AdfurikunInterListener に変わりました。

• 既存の実装

void onAdfurikunIntersAdClose(int index);
void onAdfurikunIntersAdCustomClose(int index);
void onAdfurikunIntersAdSkip(int index);
void onAdfurikunIntersAdMaxEnd(int index);
void onAdfurikunIntersAdError(int index, int err);

• 動画広告SDKの実装

void onPrepareSuccess();
void onPrepareFailure(AdfurikunMovieError error);
void onStartPlaying(InterData data);
void onFinishedPlaying(InterData data);
void onFailedPlaying(InterData data);
void onStartShowing(InterData data);
void onAdClose(InterData data);
void onClick(InterData data);

広告再生

• 既存の実装

showIntersAd(INTERSAD_DEFAULT);
showIntersAd(INTERSAD_CUSTOM);

private void showIntersAd(int index) {
    AdfurikunIntersAd.showIntersAd(IntersAd.this, index, IntersAd.this);
}

• 動画広告SDKの実装

if (mInter.isPrepared) {
    mInter.play()
}else{
    addLog("Interstitial広告の準備中です。")
}

再生完了・破棄

• 既存の実装

AdfurikunIntersAd.adfurikunIntersAdFinalizeAll();

• 動画広告SDKの実装

mInter.onDestroy()

Deprecatedされる機能

• テストモード廃止
• 表示タイトルの設定機能廃止
• 広告の表示頻度・回数制御機能廃止
• 広告の先読み機能廃止
• 広告を閉じるときのClose Type廃止

ネイティブ広告

静止画広告SDKで使われていたネイティブ広告は統合対象外になっていまして、ネイティブ広告枠に対しては使用できなくなりました。

動画ネイティブか新しくネイティブとして広告枠を再発行した上で実装方法を参考にして実装してください。