集成 MoPub + Vungle SDK v.5 (Android)

请使用本指南将 Vungle Android SDK 添加到您的应用程序中,并使用 MoPub 作为您的主要广告中介层。

目录

开始之前

步骤 1:将 Vungle 设置为自定义本地网络

如要确保 MoPub 服务器能够识别集成的 Vungle 适配器,请在 MoPub 管理面板中将 Vungle 设置为自定义本地网络。

  1. 登录 MoPub 管理面板,然后从主导航栏中选择“网络”

  2. 单击“添加网络…”

    image4.png

    ,然后选择页面底部的“自定义本地网络”

    image1.png
  1. “设置您的广告位”部分,对于每个将要使用 Vungle SDK 来呈现视频广告的广告单元,确保 MoPub SDK 可找到用于与 Vungle SDK 交互的网络适配器:

    image2.png

    • 如要对某个广告单元使用“MoPub 奖励式视频”,请在“定制事件类”下面添加 com.mopub.mobileads.VungleRewardedVideo

    • 如要对某个广告单元使用“全屏(插屏式)广告”,请在“定制事件类”下面添加 com.mopub.mobileads.VungleInterstitial

    • “定制事件类数据”下面,分别添加您的 Vungle 应用程序 ID、广告位置参考 ID 以及所有广告位置参考 ID(采用 JSON 格式)。

    • 设置想要与 pid 的 MoPub 广告单元相关联的广告位置参考 ID。
      注意:系统会自动为每个应用程序创建一个默认广告位置。无论是否打算利用该广告位置功能,您都必须在此初始化步骤中提供其广告位置参考 ID。如果创建了多个广告位置,请提供所有参考 ID。

    • 确保将已设为“奖励式”的广告位置的参考 ID 与已设为“奖励式视频”的 MoPub 广告单元进行链接;将未设为“奖励式”的广告位置的参考 ID 与已设为“全屏(插屏式)”的 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:将 VungleSDK 添加到您的项目中”部分中的说明来添加必要的框架。

  3. 如果需要设置 Multidex、Proguard 和 Google Play Services,请遵循“Vungle - Android SDK 入门指南”的“高级设置”部分中的说明更新项目中的 AndroidManifest.xml。

  4. 想要展示 Vungle 视频广告时,请调用 MoPubInterstitialshow 方法(或者对于奖励式广告,调用 MoPubRewardedVideosshowRewardedVideo 方法)!无需直接调用 Vungle iOS SDK 中的方法。MoPub SDK 会执行这一操作。

配置选项(可选)

插屏式广告

属性

默认值

说明

SOUND_ENABLED_KEY

true

播放广告时,可设置静音或取消静音。设置为“false”则静音。设置为“true”则播放声音。

ORDINAL_VIEW_COUNT_KEY

null

如果收到来自 Vungle 的有序数据报告,则使用此字段来传递调解序数。这是一个整数,表示此广告在游戏会话中的显示顺序(例如,如果此会话中已显示了两个广告,且 Vungle 的这个广告会在第三个显示,则传递“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

“提前关闭此视频将无法获得奖励。是否确定继续?”

设置跳过激励式广告时的确认对话窗口正文。

withCancelDialogCloseButton

“关闭视频”

设置跳过激励式广告时确认对话窗口中的“取消”按钮文字。

withCancelDialogKeepWatchingButton

“继续观看”

设置跳过激励式广告时确认对话窗口中的“继续观看”按钮文字。

withCancelDialogTitle

“关闭视频?”

设置跳过激励式广告时的确认对话窗口标题。

withSoundEnabled

true

设置广告的开始声音状态。如果为“true”,音频遵循设备的音量和声音设定。如果为“false”,视频开始时为静音,但用户可自行调节。

withOrdinalViewCount

null

如果收到来自 Vungle 的有序数据报告,则使用此字段来传递调解序数。这是一个整数,表示此广告在游戏会话中的显示顺序(例如,如果此会话中已显示了两个广告,且 Vungle 的这个广告会在第三个显示,则传递“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(); }
还有其它问题?提交请求

评论