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

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

目录

开始之前

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

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

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

  2. 单击右上角“新建网络”
    按钮

    Screen_Shot_2018-05-08_at_2.53.52_PM.png

    并从列表中选择“Vungle”

  1. 将 Vungle 创建为网络后,单击网络列表中相应的名称。在“设置您的广告位”部分,对于每个将要使用 Vungle SDK 来呈现视频广告的广告单元,确保 MoPub SDK 可找到用于与 Vungle SDK 交互的网络适配器:

    Screen_Shot_2018-05-08_at_3.03.03_PM.png

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

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

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

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

    • 确保在 Vungle 管理面板上将某个已设为“奖励式类型”的广告位置与已设为“奖励式视频”的 MoPub 广告单元进行链接;在 Vungle 管理面板上将已设为“插屏式广告类型”的广告位置与已设为“全屏”(320 x 480) 的 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 视频在自动关闭之前播放的秒数。

示例

 ashMap<String, Object> extras = new HashMap<>(); extras.put(VungleInterstitial.SOUND_ENABLED_KEY, false); extras.put(VungleInterstitial.ORDINAL_VIEW_COUNT_KEY, 1); extras.put(VungleInterstitial.FLEX_VIEW_CLOSE_TIME_KEY, 5); mMoPubInterstitial.setLocalExtras(extras); mMoPubInterstitial.load(); 

奖励式广告

属性

默认值

说明

withUserId

null

设置一个可传递至应用程序的唯一用户 ID,用于验证该用户因观看激励式广告所应获得的奖励。

withCancelDialogBody

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

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

withCancelDialogCloseButton

“关闭视频”

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

withCancelDialogKeepWatchingButton

“继续观看”

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

withCancelDialogTitle

“关闭视频?”

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

withSoundEnabled

true

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

withOrdinalViewCount

null

如果收到来自 Vungle 的有序数据报告,则使用此字段来传递调解序数。这是一个整数,表示此广告在游戏会话中的显示顺序(例如,如果此会话中已显示了两个广告,且 Vungle 的这个广告会在第三个显示,则传递“3”)。单击此处详细了解有序数据。

示例

 public class MainActivity extends Activity { @Override MoPubRewardedVideos.initializeRewardedVideo(this, new VungleRewardedVideo.VungleMediationSettings.Builder() .withUserId("VUNGLE_TEST_USER") .withCancelDialogTitle("TITLE") .withCancelDialogBody("BODY") .withCancelDialogCloseButton("CLOSE") .withCancelDialogKeepWatchingButton("CONTINUE") .withSoundEnabled(false) .withOrdinalViewCount(10) .build() ); MoPub.onCreate(this); // ... } 

补充说明

Android SDK - 硬件加速

如果将目标 API 级别设置为 14 或以上,则默认启用硬件加速。必须启用此选项才能使 SDK 正确显示 Dynamic Template 广告。请确保此选项在您的项目中未设置为“false”。

 < application android:hardwareAccelerated="true" ... > 

 

还有其它问题?提交请求

评论