集成 AdMob 中介 + Vungle SDK (Android)

目录

开始之前

步骤 1:将 Vungle 设置为广告网络

  1. 登录 AdMob 仪表板,并导航到“盈利”选项卡。

  2. 选择要对其添加 Vungle(作为广告网络)的应用程序。

  3. 选择广告格式并将广告单元添加到应用程序中。

    • 对于“插屏式”广告格式,选择“视频”选项,因为所有 Vungle 广告都是视频广告。

      image2.png

    • 对于“奖励式视频”广告格式,请选择“设置奖励”选项,并在“奖励金额”“奖励项”字段中输入相应值。Vungle 不支持“使用第三方广告网络设置”功能。

      image6.png

  4. 选择广告单元,然后点击“中介”列中的“广告来源”

    image1.png

  5. 单击“+ 新建广告网络”

    image5.png

  6. 从左侧面板中选择 Vungle,然后输入您的 Vungle 应用程序 ID 和 Vungle 管理面板中与之匹配的广告位置 ID

    image1.png

步骤 2:集成 Vungle 适配器和 SDK

  1. 下载 Vungle AdMob 适配器,并将其添加到项目库中。

    image3.png

  2. 更新应用程序级别的 build.gradle 文件。
    dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) // Vungle SDK compile(name:'VungleAdapter', 'ext':'aar') // Vungle 适配器 - 适用于AdMob } repositories { jcenter() flatDir { dirs 'libs' } } 


  3. 请遵循“Vungle - Android SDK 入门指南”的“步骤 1:将 VungleSDK 添加到您的项目中”部分中的说明来添加必要的框架。

  4. 如果需要设置 Multidex、Proguard 和 Google Play Services,请遵循“Vungle - Android SDK 入门指南”的“高级设置”部分中的说明。

步骤 3:向适配器传递广告位置参考 ID

如果是 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 视频在自动关闭之前播放的秒数。

 

还有其它问题?提交请求

评论