集成 AdMob + Vungle SDK (Android)

概要

本文档向您介绍如何使用Admob来聚合Vungle SDK(Android) ,本文会使用到Android adapter v6.4.11 和 Vungle Android SDK v6.4.11。

集成前准备

入门指南

在将Vungle SDK聚合到Admob之前,请按照以下说明操作:

1.关于Admob SDK 集成说明,请参考Admob SDK集成文档
2.请仔细阅读如何在Vungle Dashboard创建您的应用,其中介绍了如何创建App、AppId、PlacementID。

导入文件

有关Android Studio集成和手动集成的说明,请参见AdMob的集成指南, “第3步:导入Vungle SDK和适配器”。.

Admob后台配置指南

在Admob用户界面,完成如下操作即可添加Vungle network,生效时间大概60分钟左右。

创建Mediation

选择Mediation,然后点击Create Mediation Group.

WX20200224-141710_2x.png

添加Vungle Adsource

1、进入创建好的Mediation Group,找到最下方Ad sources模块,点击Add Ad Source,找到Vungle.
2、测试时,需要将默认的AdMob Network 和Vungle广告源的优化关闭,并将Vungle的eCPM设置为最高,以保证能正常出优先级高的Vungle广告。

2020224143629dama.png

 

开始集成

集成前项目配置

  1. 请遵循“Vungle - Android SDK 入门指南”的“步骤 1:将 VungleSDK 添加到您的项目中”部分中的说明来添加必要的框架。
  2. 如果需要设置 Multidex、Proguard 和 Google Play Services,请遵循“Vungle - Android SDK 入门指南”的“高级设置”部分中的说明。

代码部分

如果是 Vungle SDK 5.1+ 版本,必须导入VungleExtrasBuilder,并创建捆绑对象以向 Vungle 适配器提供广告位置参考 ID 和所有广告位置参考 ID。

注意:系统会自动为每个应用程序创建一个默认广告位置。如果创建了多个广告位置,请提供所有参考 ID。如果未在 AdMob 管理面板中设置 Vungle 广告位置参考 ID,则必须将其广告位置参考 ID 作为 playPlacement

对于插屏式:

import com.vungle.mediation.VungleInterstitialAdapter; 
import com.vungle.mediation.VungleExtrasBuilder;

String[] placements = new String[] { “PLACEMENT_ID_1”, “PLACEMENT_ID_2”, “PLACEMENT_ID_3” };

Bundle extras = new VungleExtrasBuilder(placements).build();
// Required if there is no placement reference ID set up in AdMob dashboard
// Bundle extras = new VungleExtrasBuilder(allPlacements).setPlayingPlacement(“PLACEMENT_ID_FOR_THE_AD_UNIT”).build();

AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras)
.build();

mInterstitialAd01.loadAd(adRequest);

对于奖励式视频:

import com.vungle.mediation.VungleAdapter; 
import com.vungle.mediation.VungleExtrasBuilder;

String[] placements = new String[] { “PLACEMENT_ID_1”, “PLACEMENT_ID_2”, “PLACEMENT_ID_3” };

Bundle extras = new VungleExtrasBuilder(placements).build();
// Required if there is no placement reference ID set up in AdMob dashboard
// Bundle extras = new VungleExtrasBuilder(allPlacements).setPlayingPlacement(“PLACEMENT_ID_FOR_THE_AD_UNIT”).build();

AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras)
.build();

mRewardedAd01.loadAd(RewardedAdUnitID01, adRequest);

注意:对于自动缓存广告,Vungle SDK 会为您在 Vungle 管理面板中选定为“自动缓存”的广告位置自动缓存广告。我们建议将最先显示的 AdMob 广告单元或显示频率最高的广告单元选定为“自动缓存”的广告位置。

有关播放多条奖励式广告的注意事项:调用 RewardedVideoAd.showAd() 会播放 RewardedVideoAd.loadAd(admob_ad_unit, adRequest) 上次调用的 AdMob 广告单元。如果要预缓存多条广告并指定要播放的预缓存广告,则您仍可通过以下操作来实现:对不同的广告单元调用 RewardedVideoAd.loadAd(admob_ad_unit, adRequest),然后对已预缓存的广告再次调用 RewardedVideoAd.loadAd(admob_ad_unit, adRequest),最后调用 RewardedVideoAd.showAd()。自 "com.google.android.gms:play-services-ads:11.4.0" 起,AdMob 不允许您直接通过 RewardedVideoAd.showAd() 参数指定要播放的预缓存奖励式广告。

传递其他参数(可选)

插屏式广告

您可以使用额外的属性来自定义广告。

属性

说明

userId

设置向 Vungle SDK 传递的唯一用户 ID,用于奖励式广告的服务器到服务器回调。

setSoundEnabled

设置广告的开始声音状态。如果设为 false,视频为静音播放,但用户可自行修改。

setOrdinalViewCount

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

setFlexViewCloseTimeInSec

使用此选项可让 Flex View 广告在指定秒数后自动消失。
此功能仅适用于 Flex View 广告,多数情况下不推荐使用。

// sending user id ("USER_ID") and setting ad playback muted String[] placements = {"PLACEMENT_ID_1", "PLACEMENT_ID_", "PLACEMENT_ID_3"}; 
Bundle extras = new VungleExtrasBuilder(placements).setUserId("USER_ID").setSoundEnabled(false) .setOrdinalViewCount(3).setPlayingPlacement("PLACEMENT_ID_1").build(); 
AdRequest adRequest = new AdRequest.Builder() .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) .build(); 
mInterstitialAd01.loadAd(adRequest);

奖励式广告

您可以使用额外的参数来自定义奖励式广告。

属性

说明

setUserId

设置向 Vungle SDK 传递的唯一用户 ID,用于奖励式广告的服务器到服务器回调。

withSoundEnabled

设置广告的开始声音状态。如果设为 false,视频为静音播放,但用户可自行修改。

setOrdinalViewCount

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

setViewCloseTimeInSec

设置 Flex View 视频在自动关闭之前播放的秒数。

 

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!

这篇文章有帮助吗?