抢先体验-在Android v.6.8.1.0上启用AdMob

AdMob Android适配器6.8.1.0与Vungle Android SDK 6.8.1兼容,并且已经过测试与Google Android SDK 19.4.0的兼容性。将AdMob中介与Vungle SDK集成的文档位于AdMob的“指南”部分的“将Vungle与中介集成”中,因此,可以使用本指南作为官方文档尚未涵盖的有关新功能的信息的补充。

下载AdMob Android适配器v6.8.1.0,并包含Vungle Android SDK 6.8.1 。您可以将它们手动添加到项目中,也可以通过Bintray进行Gradle集成。

implementation 'com.vungle:publisher-sdk-android:6.8.1'

有关Android Studio集成和手动集成的说明,请参见AdMob的集成指南“第3步:导入Vungle SDK和适配器”, https://developers.google.com/admob/android/mediation/vungle#step_3_import_the_vungle_sdk_and_adapter

如果您使用的是谷歌移动广告SDK更新到Vungle的Android SDK中V6发动机,则必须使用谷歌播放服务广告12.0.0或更高,因为我们已经加入了onRewardedVideoCompleted()回调方法RewardedVideoAdListener 。有关更多信息,请参阅Google Mobile Ads SDK发行说明

CCPA

自2020年7月1日起,将执行《加利福尼亚消费者隐私法》(CCPA),发布商必须更新至Android SDK 6.7.0和AdMob适配器6.7.0.0,以符合CCPA。

要传递CCPA值,必须直接调用Vungle SDK API。这是应该通过Vungle SDK API直接访问的唯一功能。其他可选功能(例如Android ID内存设置)应使用VungleNetworkSettings

使用Vungle.updateCCPAStatus设置用户的同意状态,以指定用户已通过传递Vungle.CCPAStatus.OPTED_OUT 。并使用Vungle.getCCPAStatus获取特定用户的当前CCPA状态。

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

横幅广告

从v6.5.1开始,Vungle SDK支持AdMob的横幅广告 要在应用程序中显示横幅广告,请在Vungle仪表板上创建MREC或横幅展示位置,并将其配置为AdMob仪表板上的横幅广告单元。请注意,与其他配置为横幅的横幅尺寸相比,MREC(300dp x 250dp)必须具有从Vungle仪表板配置为MREC的单独的放置参考ID。

Supported banner sizes:

Size in dp (WxH) 说明 AdSize constant
320x50 Banner BANNER
728x90 IAB Leaderboard LEADERBOARD
300x250 IAB Medium Rectangle MEDIUM_RECTANGLE
Provided width x Adaptive height Adaptive banner N/A
Screen width x 32|50|90 Smart banner SMART_BANNER

示例代码:

AdView adView = new AdView(this);
adViews.add(adView);
adView.setAdSize(AdSize.MEDIUM_RECTANGLE);
adView.setAdUnitId(<AdUnit>);

 

Multiple Banner Load

Vungle Android SDK 6.5.x支持在任何给定时间为一个展示位置ID加载一个横幅广告,并且将一个展示位置ID映射到一个AdMob广告单元ID。当Vungle SDK已加载横幅广告时,这限制了成功加载后续loadAd请求的能力。要克服此限制,您必须为每个横幅广告loadAd传递唯一的标识符(可以是生成的随机数或简单的增量数字),以便在Vungle SDK已加载横幅广告时,请求可以回退到瀑布中的下一个广告网络。

示例代码:

Bundle extras = new VungleExtrasBuilder(null).setBannerUniqueRequestID("12345").build();
AdRequest adRequest = new AdRequest.Builder().addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras).build();
adViewBanner.loadAd(adRequest);

Network Specific Parameters

Vungle AdMob适配器继续支持特定网络的参数 ,如AdMob指南中所示。从v6.5.1开始,用于视频播放的音频设置已被setStartMuted取代,后者采用布尔值,并且setSoundEnabled已弃用。适配器还支持附加参数setAdOrientation ,以按设备方向播放广告,该广告采用具有LANDSCAPEPORTRAITAUTO_ROTATEMATCH_VIDEO配置性的AdConfig对象。 (不建议使用setAutoRotate

示例代码:

Bundle localExtras = new VungleExtrasBuilder(null)
        .setAdOrientation(AdConfig.LANDSCAPE)
        .setStartMuted(true)
        .setUserId("vungle-test-user")
        .build();

对于奖励广告,您将在addNetworkExtrasBundle上传递VungleAdapter.class ,而对于插页式广告则传递VungleInterstitial.class

加载奖励广告的示例代码:

mRewardedAd.loadAd(new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, localExtras)
        .build(), adLoadCallback);

加载插屏广告的示例代码:

mInterstitialAd.loadAd(new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, localExtras)
        .build());

内存设定

从v6.4.11开始,如果Android手机的存储空间低于预定义的阈值,则可以阻止SDK请求广告甚至进行初始化。如果发生这种情况,您将收到类似于以下内容的错误:

设备上没有足够的文件系统大小。

样例代码:

import com.vungle.mediation.VungleNetworkSettings;

//Integer value sets the required minimum available free storage space to be able to initialize the SDK
VungleNetworkSettings.setMinSpaceForInit(<INTEGER_VALUE>);

//Integer value sets the required minimum available free storage space to be able to request an ad
VungleNetworkSettings.setMinSpaceForAdLoad(<INTEGER_VALUE>);

Android ID

6.4.11版开始,发布者现在可以限制将Android ID从设备传递到SDK。

样例代码:

VungleNetworkSettings.setAndroidIdOptOut(true);

新的奖励API

如AdMob使用指南中所述 ,v17.2.0及更高版本支持同时缓存多个奖励广告。由于Vungle不支持此功能,因此Vungle不会填充第二次尝试加载的广告请求,而是将其传递到瀑布中的下一个广告网络。

如果您要缓存多个广告,建议您使用缓存优化的展示位置,因为广告请求将在广告播放时自动发出,因此下一个广告很有可能在上一次广告体验之前就可以播放结束。

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!

这篇文章有帮助吗?