请使用该文档来集成Vungle SDK MoPub Adapter 6.9.1.0适配Vungle Android SDK 6.9.1。

• Vungle Android SDK 6.9.1
• Integrate MoPub Android Adapter 6.9.1.0
• 请查看Vungle Android SDK 集成文档来满足集成的要求。

开始之前

• Vungle Android SDK 6.9.1 已经使用 MoPub Android SDK 5.15.0 进行了测试且该版本与5.12.0及以下不兼容。
• 请根据 Integrate the MoPub SDK for Android 文档来集成各种广告格式。
• Vungle 支持以下广告格式。
  • 插屏: https://developers.mopub.com/publishers/android/interstitial/
  • 奖励视频: https://developers.mopub.com/publishers/android/rewarded-video/
  • Banner: https://developers.mopub.com/publishers/android/banner/
• 请根据该文档，将Vungle在Mopub平台上设置https://developers.mopub.com/publishers/mediation/networks/vungle/
• 您需要使用Vungle’s App ID 和placement reference IDs。您可以在Vungle Dashboard上找到这些IDs (详情请查看 Setting Up and Reporting on Placements)。

CCPA

自2020年7月1日起，California Consumer Privacy Act (CCPA)开始实行。开发者需要更新SDK 6.7.0和MoPub adapter 6.7.0.0来符合CCPA。

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

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

根据 CCPA， consent 默认状态为opted in 。 Vungle.updateCCPAStatus 可设置为opted out。Vungle.getCCPAStatus 返回为null时，Vungle默认为 opted-in。

CCPA API

public static void updateCCPAStatus(@NonNull final Vungle.Consent status)

public static Vungle.Consent getCCPAStatus()

示例代码

// 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。

示例代码

@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初始化和请求广告。

具体设置

示例代码

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)));

插屏式广告

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

示例代码

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

奖励式广告

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

示例代码

VungleMediationConfiguration vungleMediationConfiguration = new VungleMediationConfiguration.Builder()
        .withUserId("VUNGLE_USER_ID")
        .withStartMuted(true)
        .withAutoRotate(AdConfig.LANDSCAPE)
        .build();

MoPubRewardedVideos.loadRewardedVideo(mAdUnitId, vungleMediationConfiguration);