集成 MoPub + Vungle SDK Android

请使用该文档来集成Vungle SDK。MoPub Adapter 6.8.0.0适配了Vungle Android SDK 6.8.0。

开始之前

CCPA

自2020年7月1日, California Consumer Privacy Act (CCPA)将开始实行。开发者必须更新到SDK 6.7.0和Mopub Adapter 6.7.0.0来满足该协议。

为了传递CCPA值,您必须要直接调用Vungle SDK API。这也是唯一的一个功能,您需要直接调用Vungle SDK的API。 其他 optional features,例如 Android IDmemory settings 请使用 VungleAdapterConfiguration

请使用 Vungle.updateCCPAStatus 来设置用户选择。如果用户禁止,则传入 Vungle.CCPAStatus.OPTED_OUT。请使用 Vungle.getCCPAStatus 来获取当前CCPA状态。

CCPA API
updateCCPAStatus getCCPAStatus
public static void updateCCPAStatus(@NonNull final Vungle.Consent status)
示例代码
// To set the user's CCPA status to opted out:
Vungle.updateCCPAStatus(Vungle.Consent.OPTED_OUT);
// To find out what the user's current consent status is:
Vungle.Consent currentCCPAStatus = Vungle.getCCPAStatus();

Banner Ad

Vungle支持3种banner尺寸:Banner, Medium rectangle, Leaderboard。请使用不小于这些广告尺寸大小的容器来展示这些广告。请使用MoPubView.MoPubAdSize高度来加载特定Banner广告。请注意,与其他配置为横幅的横幅尺寸相比,MREC(300dp x 250dp)必须具有从VungleDashboard上配置为MREC的单独的放置参考 reference ID。

MoPubAdSize Size
HEIGHT_50 320dp x 50dp
HEIGHT_90 728dp x 90dp
HEIGHT_250 300dp x 250dp
HEIGHT_280 300dp x 250dp
MATCH_VIEW 请使用合适的尺寸的view作为其容器。

示例代码

@Override
public MoPubView.MoPubAdSize getAdSize() {
    return MoPubView.MoPubAdSize.HEIGHT_250;
}

高级设置

SDK提前初始化(强烈建议)

自MoPub5.5.0及以后版本,允许您可以在初始化MoPub后即刻初始化Ad Network SDK。我们强烈建议您使用该功能,这能让Vungle SDK有更多的时间来预缓存广告以增加展示的机会。

示例代码

SharedPreferences mPreferences = PreferenceManager.getDefaultSharedPreferences(this);
Map<String, String> vungleSettings = new HashMap<>();

vungleSettings.put("appId", "YOUR_VUNGLE_APP_ID");

SdkConfiguration configBuilder = new SdkConfiguration.Builder("MOPUB_AD_UNIT_WITH_VUNGLE_PLACEMENT")
        .withMediatedNetworkConfiguration(VungleAdapterConfiguration.class.getName(), vungleSettings)
        .build();

MoPub.initializeSdk(this, configBuilder, initSdkListener());

Memory Settings

自SDK 6.4.0以后,您可以通过设置最小初始化和请求广告的存储空间来阻止SDK初始化和请求广告。

具体设置

Keys

Type/Value

说明

pre_key_min_space_for_init

String, value in bytes (default 51 MB)

设置最小初始化的存储空间

pre_key_min_space_for_ad

String, value in bytes (default 50 MB)

Sets the required minimum available free storage space to be able to request an ad

 

示例代码

Map<String, String> vungleSettings = new HashMap<>();

vungleSettings.put("appId", "YOUR_VUNGLE_APP_ID");

vungleSettings.put("VNG_MIN_SPACE_INIT",
        mPreferences.getString("pref_key_min_space_for_init", String.valueOf(20 * 1024 * 1024)));
vungleSettings.put("VNG_MIN_SPACE_LOAD_AD",
        mPreferences.getString("pref_key_min_space_for_ad", String.valueOf(20 * 1024 * 1024)));

禁用设备ID

自SDK 6.4.10以后,开发者可以禁止SDK获取Android ID。

Map<String, String> vungleSettings = new HashMap<>();

vungleSettings.put("appId", "YOUR_VUNGLE_APP_ID");

vungleSettings.put("VNG_DEVICE_ID_OPT_OUT",
        String.valueOf(mPreferences.getBoolean("pref_key_key_android_id_opted_out", true)));

插屏式广告

您可以自定义一些设置来定制化您的广告体验。

属性

默认值

说明

withStartMuted

true

静音播放广告。传入true则为静音,false则相反。

withOrdinalViewCount

null

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

withAutoRotate AdConfig.AUTO_ROTATE

Available Orientation:

  • AdConfig.AUTO_ROTATE
  • AdConfig.PORTRAIT
  • AdConfig.LANDSCAPE
  • AdConfig.MATCH_VIDEO

示例

VungleMediationConfiguration vungleMediationConfiguration = new VungleMediationConfiguration.Builder()
    .withAutoRotate(AdConfig.LANDSCAPE) 
    .withStartMuted(true) 
    .withOrdinalViewCount(10)
    .build();
mMoPubInterstitial.setLocalExtras(vungleMediationConfiguration.getExtrasMap());
mMoPubInterstitial.load();

奖励式广告

您可以自定义一些设置来定制化您的广告体验。

属性

默认值

说明

withUserId

null

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

withCancelDialogBody

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

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

withCancelDialogCloseButton

“关闭视频”

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

withCancelDialogKeepWatchingButton

“继续观看”

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

withCancelDialogTitle

“关闭视频?”

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

withStartMuted

false

静音播放广告。传入true则为静音,false则相反。

withOrdinalViewCount

null

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

withAutoRotate

AdConfig.AUTO_ROTATE

Available Orientation:

  • AdConfig.AUTO_ROTATE
  • AdConfig.PORTRAIT
  • AdConfig.LANDSCAPE
  • AdConfig.MATCH_VIDEO

示例

VungleMediationConfiguration vungleMediationConfiguration = new VungleMediationConfiguration.Builder()
        .withUserId("VUNGLE_USER_ID")
        .withCancelDialogBody("CUSTOM_BODY")
        .withCancelDialogCloseButton("CUSTOM_CLOSE")
        .withCancelDialogKeepWatchingButton("CUSTOM_KEEPWATCHING")
        .withCancelDialogTitle("CUSTOM_TITLE")
        .withStartMuted(true)
        .withOrdinalViewCount(10)
        .withAutoRotate(AdConfig.AUTO_ROTATE)
        .build();

MoPubRewardedVideos.loadRewardedVideo(mAdUnitId, vungleMediationConfiguration);
Powered by Creativity Driven by Performance Sign Up Here

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

这篇文章有帮助吗?