動画リワード広告
動画リワード広告とは
動画リワード広告とは、アプリ内で使用可能なアイテムやポイントをユーザーに付与する代わりに、約15秒〜30秒程度の動画広告を表示する広告フォーマットです。
強制視聴型の動画広告と違い、動画視聴を希望したユーザーにのみインセンティブを付与する点で、一般的な動画広告とは異なるものです。
動画視聴後に付与する報酬(インセンティブ)の例としては、ゲーム内で使えるアイテムやコンティニューの権利、ツール系アプリの場合は有料の機能を限定的に開放するなどがあります。
実装手順
前提条件
- VAMP SDKがインポート済み
※まだVAMP SDKのインポートがお済みでない場合はこちらをご参考ください。
VAMP v4.4.2以前の導入手順はこちらをご参照ください。
広告を取得する
次のコードスニペットでは、MainActivity
のonCreate
メソッド内で広告の取得を開始しています。
Java
import jp.supership.vamp.VAMPError;
import jp.supership.vamp.VAMPRequest;
import jp.supership.vamp.VAMPRewardedAd;
import jp.supership.vamp.VAMPRewardedAdLoadListener;
public class MainActivity extends AppCompatActivity {
private static final String VAMP_AD_ID = "*****";
@Override
protected void onCreate(Bundle savedInstanceState) {
...
// 広告の取得を開始します。
VAMPRewardedAd.load(this,
VAMP_AD_ID,
new VAMPRequest.Builder().build(),
new VAMPRewardedAdLoadListener() {
@Override
public void onReceived(@NonNull String placementId) {
// 動画表示の準備が完了しました。
}
@Override
public void onFailedToLoad(@NonNull String placementId,
VAMPError error) {
// 広告が取得できなかったときに通知されます。
}
});
}
}
Kotlin
import jp.supership.vamp.*
const val VAMP_AD_ID = "*****"
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
...
// 広告の取得を開始します。
VAMPRewardedAd.load(
this,
VAMP_AD_ID,
VAMPRequest.Builder().build(),
object : VAMPRewardedAdLoadListener {
override fun onReceived(placementId: String) {
// 動画表示の準備が完了しました。
}
override fun onFailedToLoad(placementId: String,
error: VAMPError?) {
// 広告が取得できなかったときに通知されます。
}
}
)
}
}
*****
にAdGenerationの広告枠IDを設定して実装してください。
VAMPRewardedAd
クラスのload
クラスメソッドに広告枠ID(コードスニペットではVAMP_AD_ID)を渡して、広告の取得を開始します。
VAMPRewardedAdLoadListener
インタフェースを実装し、第4引数に渡すことで、ロードイベントを受け取ることができます。
ロードイベントの詳細については、以下の表をご覧ください。
メソッド名 | 説明 |
---|---|
onReceived | 広告の取得に成功すると通知されます。このイベントを受け取ると、広告の表示が可能になります。 |
onFailedToLoad | 広告の取得に失敗すると通知されます。広告取得時のタイムアウトや、全てのアドネットワークの在庫がない場合など。 |
VAMPRewardedAdListenerを実装する
広告の表示に関するイベントはVAMPRewardedAdListener
インタフェースを実装することで処理できます。以下のクラスは表示に関するイベントを通知する仕組みを提供します。
- VAMPEventDispatcher
- VAMPActivityEventDispatcher
VAMPRewardedAdListener
インタフェースの実装をaddListener
メソッドで登録することで、イベントを処理できます。
Java
import jp.supership.vamp.VAMPError;
import jp.supership.vamp.VAMPEventDispatcher;
import jp.supership.vamp.VAMPRewardedAdListener;
public class MainActivity extends AppCompatActivity {
private static final String VAMP_AD_ID = "*****";
@Override
protected void onCreate(Bundle savedInstanceState) {
...
// 広告の表示に関するイベントを受け取るために
// VAMPRewardedAdListenerを登録します。
VAMPEventDispatcher.getInstance()
.addListener(VAMP_AD_ID, rewardedAdListener);
}
private final VAMPRewardedAdListener rewardedAdListener =
new VAMPRewardedAdListener() {
@Override
public void onFailedToShow(@NonNull String placementId, VAMPError error) {
// 広告表示失敗
// showを実行したが、何らかの理由で広告表示が失敗したときに通知されます。
// エラーにはユーザキャンセルも含まれます。
if (error == VAMPError.USER_CANCEL) {
// ユーザが広告再生を途中でキャンセルしました。
}
}
@Override
public void onCompleted(@NonNull String placementId) {
// インセンティブ付与が可能になったタイミングで通知されます。
}
@Override
public void onOpened(@NonNull String placementId) {
// 動画が表示されたタイミングで通知されます。
}
@Override
public void onClosed(@NonNull String placementId, boolean clicked) {
// 動画プレイヤーやエンドカードが閉じられたタイミングで通知されます。
// <注意:ユーザキャンセルなども含むので、
// インセンティブ付与はonCompletedで判定してください>
}
@Override
public void onExpired(@NonNull String placementId) {
// 有効期限オーバーのときに通知されます。
// <注意:onReceivedを受けてからの有効期限が切れました。
// showするには再度loadを行う必要が有ります>
}
};
}
Kotlin
import jp.supership.vamp.*
const val VAMP_AD_ID = "*****"
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
...
// 広告の表示に関するイベントを受け取るために
// VAMPRewardedAdListenerを登録します。
VAMPEventDispatcher.getInstance()
.addListener(VAMP_AD_ID, rewardedAdListener)
}
private val rewardedAdListener: VAMPRewardedAdListener =
object : VAMPRewardedAdListener {
override fun onFailedToShow(placementId: String, error: VAMPError) {
// 広告表示失敗
// showを実行したが、何らかの理由で広告表示が失敗したときに通知されます。
// エラーにはユーザキャンセルも含まれます。
if (error == VAMPError.USER_CANCEL) {
// ユーザが広告再生を途中でキャンセルしました。
}
}
override fun onCompleted(placementId: String) {
// インセンティブ付与が可能になったタイミングで通知されます。
}
override fun onOpened(placementId: String) {
// 動画が表示されたタイミングで通知されます。
}
override fun onClosed(placementId: String, clicked: Boolean) {
// 動画プレイヤーやエンドカードが閉じられたタイミングで通知されます。
// <注意:ユーザキャンセルなども含むので、
// インセンティブ付与はonCompletedで判定してください>
}
override fun onExpired(placementId: String) {
// 有効期限オーバーのときに通知されます。
// <注意:onReceivedを受けてからの有効期限が切れました。
// showするには再度loadを行う必要が有ります>
}
}
}
広告の表示に関するイベントの詳細については、以下の表をご覧ください。
表示中のイベント(onOpened
, onCompleted
)の発生タイミングはアドネットワークにより異なります。
また、onClosed
のclicked
フラグがtrueとなる条件もアドネットワークにより異なります。
メソッド名 | 説明 |
---|---|
onFailedToShow | 広告の表示に失敗すると通知されます。視聴完了する前にユーザがキャンセルするなど。 |
onOpened | 広告が表示されると通知されます。アドネットワークから表示開始時(表示開始の通知がなければ、表示開始直前)のイベントを受け取ったタイミングで通知されます。アドネットワークによって発生タイミングが異なります。 |
onCompleted | インセンティブ付与が可能になると通知されます。ユーザが途中で動画視聴をキャンセルすると発生しません。アドネットワークによって発生タイミングが異なります。 |
onClosed | 広告(動画プレーヤー、またはエンドカード)が閉じられると通知されます。ユーザキャンセルの場合でも広告を閉じたタイミングで通知されます。 |
onExpired | RTBはロードが完了してから1時間経過すると、広告表示ができても無効扱いとなり、収益が発生しません。このイベントを受け取ったらVAMPRewardedAd.load メソッドを再度呼び出してください。イベントを受け取ってからVAMPRewardedAd.of メソッドを実行するとnullが返却されます。 |
広告の表示に関するイベントを受け取る必要がなくなったタイミングでremoveListener
メソッドを呼んでください。以下のコードスニペットでは、MainActivity
のonDestroy
メソッドでリスナーの解除をしています。
Java
public class MainActivity extends AppCompatActivity {
@Override
protected void onDestroy() {
// VAMPRewardedAdListenerを解除します。
VAMPEventDispatcher.getInstance().removeListener(VAMP_AD_ID);
super.onDestroy();
}
}
Kotlin
class MainActivity : AppCompatActivity() {
override fun onDestroy() {
// VAMPRewardedAdListenerを解除します。
VAMPEventDispatcher.getInstance().removeListener(VAMP_AD_ID)
super.onDestroy()
}
}
複数の広告枠IDがあるアプリでは、それぞれの広告枠IDに対してaddListener
およびremoveListener
メソッドを呼んでください。
Activityのライフサイクルにリスナーをバインドする
以下のコードスニペットのように、VAMPActivityEventDispatcher
をActivity
のライフサイクルコールバック内で呼ぶことで、広告の表示に関するイベントを処理することもできます。
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 広告の表示に関するイベントを受け取るために
// VAMPRewardedAdListenerを登録します。
VAMPActivityEventDispatcher.getInstance()
.onCreate(savedInstanceState, VAMP_AD_ID, rewardedAdListener);
}
@Override
protected void onDestroy() {
// VAMPRewardedAdListenerを解除します。
VAMPActivityEventDispatcher.getInstance()
.onDestroy(VAMP_AD_ID);
super.onDestroy();
}
@Override
protected void onSaveInstanceState(@NonNull Bundle outState) {
// VAMPActivityEventDispatcher#onCreate、
// VAMPActivityEventDispatcher#onDestroy、および
// VAMPActivityEventDispatcher#onSaveInstanceStateメソッドをそれぞれ呼ぶことで、
// 広告の表示中にActivityが破棄された後、再生成された場合でも
// 広告の表示に関するイベントを受け取ることができます。
VAMPActivityEventDispatcher.getInstance()
.onSaveInstanceState(outState, VAMP_AD_ID);
super.onSaveInstanceState(outState);
}
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// 広告の表示に関するイベントを受け取るために
// VAMPRewardedAdListenerを登録します。
VAMPActivityEventDispatcher.getInstance()
.onCreate(savedInstanceState, VAMP_AD_ID, rewardedAdListener)
}
override fun onDestroy() {
// VAMPRewardedAdListenerを解除します。
VAMPActivityEventDispatcher.getInstance()
.onDestroy(VAMP_AD_ID)
}
override fun onSaveInstanceState(outState: Bundle) {
// VAMPActivityEventDispatcher#onCreate、
// VAMPActivityEventDispatcher#onDestroy、および
// VAMPActivityEventDispatcher#onSaveInstanceStateメソッドをそれぞれ呼ぶことで、
// 広告の表示中にActivityが破棄された後、再生成された場合でも
// 広告の表示に関するイベントを受け取ることができます。
VAMPActivityEventDispatcher.getInstance()
.onSaveInstanceState(outState, VAMP_AD_ID)
}
広告を表示する
Java
VAMPRewardedAd rewardedAd = VAMPRewardedAd.of(VAMP_AD_ID);
// 広告の表示準備ができているか確認します。
// rewardedAdオブジェクトがnullでなければ、表示の準備ができています。
if (rewardedAd != null) {
// 準備が完了していた場合、動画広告を再生します。
rewardedAd.show(MainActivity.this);
}
Kotlin
val rewardedAd = VAMPRewardedAd.of(VAMP_AD_ID)
// 広告の表示準備ができているか確認します。
// rewardedAdオブジェクトがnullでなければ、表示の準備ができています。
if (rewardedAd != null) {
// 準備が完了していた場合、動画広告を再生します。
rewardedAd.show(this)
}
ロードが完了したVAMPRewardedAd
オブジェクトはVAMPRewardedAd.of
クラスメソッドで取得できます。このクラスメソッドは指定した広告枠IDの広告が表示できる状態になっているとき、VAMPRewardedAd
オブジェクトを返し、それ以外のときはnullを返します。
詳細なロードイベントを受け取る
VAMPRewardedAdLoadListener
インタフェースの代わりにVAMPRewardedAdLoadAdvancedListener
インタフェースを実装することにより、より詳細なロードイベントを受け取ることができます。
Java
import jp.supership.vamp.VAMPError;
import jp.supership.vamp.VAMPRequest;
import jp.supership.vamp.VAMPRewardedAd;
import jp.supership.vamp.VAMPRewardedAdLoadAdvancedListener;
public class MainActivity extends AppCompatActivity {
private static final String VAMP_AD_ID = "*****";
@Override
protected void onCreate(Bundle savedInstanceState) {
...
VAMPRewardedAd.load(this,
VAMP_AD_ID,
new VAMPRequest.Builder().build(),
new VAMPRewardedAdLoadAdvancedListener() {
@Override
public void onReceived(@NonNull String placementId) {
}
@Override
public void onFailedToLoad(@NonNull String placementId,
VAMPError error) {
}
// 追加されたロードイベント
@Override
public void onStartedLoading(@NonNull String placementId,
@NonNull String adNetworkName) {
// アドネットワークごとの広告取得が開始されたときに通知されます。
}
@Override
public void onLoaded(@NonNull String placementId,
@NonNull String adNetworkName,
boolean success,
@NonNull String message) {
// アドネットワークごとの広告取得結果が通知されます。
}
});
}
}
Kotlin
import jp.supership.vamp.*
const val VAMP_AD_ID = "*****"
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
...
VAMPRewardedAd.load(
this,
VAMP_AD_ID,
VAMPRequest.Builder().build(),
object : VAMPRewardedAdLoadAdvancedListener {
override fun onReceived(placementId: String) {
}
override fun onFailedToLoad(placementId: String,
error: VAMPError?) {
}
// 追加されたロードイベント
override fun onStartedLoading(placementId: String,
adNetworkName: String) {
// アドネットワークごとの広告取得が開始されたときに通知されます。
}
override fun onLoaded(
placementId: String,
adNetworkName: String,
success: Boolean,
message: String
) {
// アドネットワークごとの広告取得結果が通知されます。
}
}
)
}
}
VAMPRewardedAdLoadListenerインタフェースで受け取ることができるロードイベントに加え、以下のイベントを受け取ることができます。
メソッド名 | 説明 |
---|---|
onStartedLoading | アドネットワークごとの広告取得が開始されたときに通知されます。 |
onLoaded | アドネットワークごとの広告取得結果が通知されます。このイベントは、ロードの成功時、失敗時どちらの場合も通知されます。このイベントをもとに広告の表示をしないでください。イベント通知により広告の表示準備ができているか判定する場合は、onReceivedを受け取ったタイミングで判定してください。 |