インタースティシャル広告 - waffs702/mv_to_android GitHub Wiki

概要

ss1

  • RPGツクールのプロジェクトに、インタースティシャル広告の機能を追加できます。
  • インタースティシャル広告を表示し、広告の終了時に呼び出すコモンイベントを指定できます。
  • 広告配信のプラットフォームとして、AdMobを使用しています。

使い方

  1. こちらから、以下のRPGツクールMZ/MV向けのプラグインをダウンロードします。

  2. MVZxNativeCore.js,MZxNativeInterstitialAd.jsの順番でRPGツクール上にプラグインを登録します。

    MVZxNativeCore.jsのプラグインパラメータの デプロイ環境について、 Android向けにデプロイメントする場合は、Androidを選択し、 iOS向けにデプロイメントする場合はiOSに切り替えるようにしてください。

  3. RPGツクール上で、各種コモンイベントを実装します。

    ss3

    • 広告の表示成功したとき
      • 次のシーンに移動する、ゲームを再開などのイベントを実装します。
    • 広告の表示が失敗したとき
      • ネットワークのトラブル等で広告の読込みが失敗する場合があります。
      • 失敗した場合にユーザに何か通知をする場合はメッセージなどのイベントを実装します。
      • 特に意識しないのであれば、広告の表示が失敗したときのコモンイベントの実装は不要です。

  4. インタースティシャル広告を呼び出すためのイベントを実装します。

    • 以下は例です。

      ss1

    • ※プラグインコマンドを呼び出す前に、BGMやBGS、SEを停止した上で呼び出してください。

      • 広告表示後にゲームに戻った際に、BGMやSEが再生されなくなる問題があります。

    • プラグインコマンドとして、MZxNativeInterstitialAd インタースティシャル広告の表示を呼び出します。

    • 呼び出し時の引数に、実装したコモンイベント番号を指定します。

      • 広告表示成功コモンイベント番号

      • 広告表示失敗コモンイベント番号

        ss2

    • このプラグインコマンドが実行されると、インタースティシャル広告が表示されます。

    • 広告表示失敗コモンイベント番号がない場合は、広告表示成功コモンイベント番号と同じ番号を指定してください。

    • RPGツクールMVの場合はプラグインコマンドでMVxNativeInterstitialAd X Yを呼び出します。

      引数名 説明
      X 広告表示成功コモンイベント コモンイベント番号を指定してください。
      Y 広告表示失敗コモンイベント コモンイベント番号を指定してください。 
      例.  MVxNativeInterstitialAd 15 16
広告表示成功コモンイベントを15番のコモンイベントに指定
広告表示失敗コモンイベントを16番のコモンイベントに指定

  5. Android側のプロジェクトに、AdMobの各種IDを設定します。

    • app\src\main\res\values\strings.xmlを開きます。

      <resources>
  <string name="ad_application_id">ca-app-pub-3940256099942544~3347511713</string>
  <string name="ad_interstitial_id">ca-app-pub-3940256099942544/1033173712</string>
</resources>
<!-- こちらのIDは、AdMobが用意しているテスト用のIDになります。 -->

    • AdMob側のアプリIDを、<string name="ad_application_id">に設定します。

      ss4

    • 同様に、AdMob側の広告ユニットIDを、<string name="ad_interstitial_id">に設定します。

      ss5

    • インタースティシャル広告を採用しない場合は、app\src\main\res\values\strings.xml の ad_interstitial_id を空白にしてください。

      <resources>
  <string name="ad_application_id">ca-app-pub-3940256099942544~3347511713</string>
  <string name="ad_interstitial_id"></string>
</resources>
<!-- インタースティシャル広告を採用しない場合は空白にしてください。 -->
⚠️ **GitHub.com Fallback** ⚠️