MoPub と Vungle SDK v.5 (Android) の統合

このガイドでは、MoPub をメインの広告仲介レイヤとして使用して、 Vungle Android SDK をアプリケーションに追加する方法について説明します。

目次

はじめに

  • Vungle Android SDK は MoPub 4.15 ではテストされていないため、MoPub 4.14 と統合する必要があります。

  • MoPub ダッシュボードには、Vungle の配置広告はまだ導入されていません。配置広告レベルのパフォーマンスを確認するには、Vungle が提供するパブリッシャー用レポート API を使用してください。

  • このチュートリアルを開始する前に、アプリケーション内で MoPub を設定する必要があります。詳細な設定方法については、「Android 用 MoPub のスタート ガイド」を参照してください。

  • Vungle のアプリケーション ID と、アプリケーションで使用するすべての広告配置参照 ID が必要になります。これらの ID は、Vungle ダッシュボードで確認することができます (「広告配置の設定とレポート作成」を参照)。

  • Vungle SDK には以下が必要です。
    • Android 3.0 (Honeycomb - API バージョン 11) 以降
    • Java 1.7 - Android 5.+ との互換性を保つため、JDK 7 が必要です
    • Java 1.8 - Android 7.+ との互換性を保つため、JDK 8 が必要です

手順 1. Vungle をカスタム ネイティブ ネットワークとしてセットアップする

MoPub サーバーによって統合 Vungle アダプタが認識されるようにするには、MoPub ダッシュボードで Vungle をカスタム ネイティブ ネットワークとしてセットアップします。

  1. MoPub ダッシュボードにログインし、メイン ナビゲーション バーで [Networks] を選択します。

  2. [Add a Network …] をクリックします。

    image4.png

    ページ下部の [Custom Native Network] を選択します。

    image1.png
  1. 次に、[Set Up Your Inventory] セクションで、Vungle SDK を使用して動画広告を表示する広告ユニットごとに、Vungle SDK と通信するためのネットワーク アダプターを MoPub SDK で検出できるかどうかを確認します。

    image2.png

    • 広告ユニットに対して MoPub の報酬型動画を使用する場合は、[Custom Event Class] セクションに com.mopub.mobileads.VungleRewardedVideo を追加します。

    • 広告ユニットに対して [Fullscreen (Interstitial)] を使用する場合は、[Custom Event Class] セクションに com.mopub.mobileads.VungleInterstitial を追加します。

    • Vungle アプリケーション ID、広告配置参照 ID、すべての広告配置参照 ID を、[Custom Event Class Data] セクションに JSON 形式で追加します。

    • pid で、MoPub の広告ユニットにリンクする広告配置参照 ID を設定します。
      注: 各アプリケーションで、デフォルトの配置広告が自動的に作成されます。広告配置機能を使用するかどうかにかかわらず、この初期化手順で広告配置参照 ID を指定する必要があります。複数の配置広告を作成する場合は、すべての参照 ID を指定してください。

    • 「報酬型」に設定されている広告配置参照 ID を [Rewarded Video] に設定されている MoPub 広告ユニットにリンクし、「報酬型」に設定されていない広告配置参照 ID を [Fullscreen (Interstitial) ] に設定されている MoPub 広告ユニットにリンクしてください。
      { "appId":"5935efecc802d63d5100000f", "pid":"DEFAULT05223", "pids":"DEFAULT05223, PADUNIT49379, PADUNIT68848, PADUNIT04241, PADUNIT53279, PADUNIT08448" }

注意: Vungle SDK では、Vungle ダッシュボードで自動キャッシュ 対象として選択した広告配置の広告が自動的にキャッシュされます。最初に表示される MoPub 広告ユニットまたは最も頻繁に表示される広告ユニットを自動キャッシュ 対象の広告配置に選択することを強くお勧めします。

手順 2. Vungle をサードパーティ広告ネットワークとして追加する

MoPub の広告仲介を使用するアプリに Vungle の Android SDK を追加するには、以下の手順に従います。

  1. Vungle に関するすべてのアダプター ファイル (MoPub アダプター リポジトリ/extras/src/com/mopub/mobileads/ ディレクトリ内のファイル) を、アプリケーションのプロジェクトの /src/main/java/com/mopub/mobileads/ ディレクトリに追加します。MoPub SDK は、ディレクトリ内でこれらのファイルを「カスタム イベント クラスのプロパティ」として参照するため、この手順が必要になります。

    • VungleInterstitial.java
    • VungleRewardedVideo.java
    • VungleRouter.java
    • VungleRouterListener.java

  2. Vungle スタート ガイド - Android SDK」の「手順 1. Vungle SDK をプロジェクトに含める」セクションに記載されている手順に従い、必要なフレームワークを追加します。

  3. Multidex、Proguard、Google Play Services を設定する必要がある場合は、「Vungle スタート ガイド - Android SDK」の「詳細設定」セクションに記載されている手順に従い、プロジェクト内の AndroidManifest.xml ファイルを更新します。

  4. Vungle 動画広告を提示する場合は、MoPubInterstitial の show メソッドを呼び出します (または、報酬型広告の場合は MoPubRewardedVideos の showRewardedVideo メソッドを呼び出します) (Vungle Android SDK のメソッドを直接呼び出す必要はありません。MoPub SDK によって呼び出されます)。

構成オプション (任意指定)

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

属性

デフォルト値

説明

SOUND_ENABLED_KEY

true

広告を再生する際の音声のミュートを切り替えます。ミュート状態で広告を再生する場合は false、音声付きで再生する場合は true を指定します。

ORDINAL_VIEW_COUNT_KEY

null

Vungle から序数データ レポートを受け取った場合は、このオプションを使用して媒介序数を渡します。このオプションは、ゲーム セッション内でこの広告が表示された順序を示す整数です。たとえば、現在のセッション内で 2 つの広告がすでに表示されていて、Vungle の広告が 3 番目に表示された場合は、「3」を渡します。序数データの詳細については、こちらを参照してください。

FLEX_VIEW_CLOSE_TIME_KEY

null

秒数を指定します。この秒数が経過すると、Flex View 動画が自動的に終了します。

private Map<String, Object> getLocalExtras() { HashMap<String, Object> extras = new HashMap<>(); extras.put(VungleInterstitial.SOUND_ENABLED_KEY, mPreferences.getBoolean(SettingsActivity.KEY_PREF_SOUND_ENABLED, true)); extras.put(VungleInterstitial.ORDINAL_VIEW_COUNT_KEY, Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_ORDINAL, "3"), 0)); return extras;

報酬型広告

属性

デフォルト値

説明

withUserId

null

アプリケーションに渡す一意のユーザー ID を指定します。これにより、指定のユーザーがインセンティブ広告を視聴した場合に、そのユーザーに報酬が与えられます。

withCancelDialogBody

"Closing this video early will prevent you from earning your reward. Are you sure?"

インセンティブ広告をスキップするときに表示される確認メッセージの本文を設定します。

withCancelDialogCloseButton

“Close Video”

インセンティブ広告をスキップした場合に表示される確認ダイアログのキャンセル ボタンのテキストを設定します。

withCancelDialogKeepWatchingButton

“Keep Watching”

インセンティブ広告をスキップするときに表示される確認ダイアログの、このまま広告を表示するかどうかを確認するためのボタンのテキストを設定します。

withCancelDialogTitle

“Close Video?”

インセンティブ広告をスキップするときに表示される確認メッセージのタイトルを設定します。

withSoundEnabled

true

広告開始時の音声の状態を設定します。true を指定すると、デバイスの音量とサウンド設定に基づいて音声が再生されます。false を指定すると、ミュート状態で動画が再生されます。ただし、ユーザーは、ミュートのオンとオフを切り替えることができます。

withOrdinalViewCount

null

Vungle から序数データ レポートを受け取った場合は、このオプションを使用して媒介序数を渡します。このオプションは、ゲーム セッション内でこの広告が表示された順序を示す整数です。たとえば、現在のセッション内で 2 つの広告がすでに表示されていて、Vungle の広告が 3 番目に表示された場合は、「3」を渡します。序数データの詳細については、こちらを参照してください。

private VungleMediationSettings getSettings() { return new VungleMediationSettings.Builder() .withUserId(mPreferences.getString(SettingsActivity.KEY_PREF_USER_ID, "user")) .withCancelDialogBody(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_BODY, "")) .withCancelDialogCloseButton(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_CLOSE, "")) .withFlexViewCloseTimeInSec(Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_FLEXVIEW_CLOSE_TIME, "5"), 0)) .withCancelDialogKeepWatchingButton(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_KEEP, "")) .withCancelDialogTitle(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_TITLE, "")) .withSoundEnabled(mPreferences.getBoolean(SettingsActivity.KEY_PREF_SOUND_ENABLED, true)) .withOrdinalViewCount(Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_ORDINAL, "13"), 0)) .build(); }
他にご質問がございましたら、リクエストを送信してください

コメント