集成 AdMob + Vungle SDK (iOS)

概要

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

集成前准备

入门指南

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

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

导入文件

  • 手动添加

下载 AdMob iOS Adapter v6.5.3 和Vungle SDK6.5.3, 然后添加到您的Xcode项目工程里.

  • cocoapods 

Vungle iOS SDK也可以通过CocoaPods获得。 在项目的Pod文件中添加以下行,然后进行快速Pod安装运行以使用Vungle iOS SDK版本更新项目.

pod "VungleSDK-iOS", "6.5.3"

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. 确保 VungleSDK.frameworklibVungleAdapter.a 包含在项目的“构建阶段→ 链接二进制与库部分中。
  2. 请遵循“Vungle - iOS SDK 入门指南”的“添加其他必要框架”部分中的说明来添加必要的框架。
  3. 请遵循“Vungle - iOS SDK 入门指南”的“添加“-ObjC”链接器标记”部分中的说明来添加链接器标记。
  4. 请遵循“Vungle - iOS SDK 入门指南”的“删除 iOS 状态栏”部分中的说明来删除状态栏。

代码部分

如果是 Vungle SDK 版本 5,必须导入VungleAdNetworkExtras.h,并创建 VungleAdNetworkExtras 对象以向 Vungle 适配器提供广告位置参考 ID 和所有广告位置参考 ID。如果已在 AdMob 管理面板中添加了广告位置参考 ID,则无需在VungleAdNetworkExtras 类中指定广告位置参考 ID。

注意:系统会自动为每个应用程序创建一个默认广告位置。无论是否打算利用该广告位置功能,您都必须在此初始化步骤中提供其广告位置参考 ID。如果创建了多个广告位置,请提供所有参考 ID。

对于插屏式:

 self.interstitial = [[GADInterstitial alloc] initWithAdUnitID:@"AD_UNIT_ID"];
self.interstitial.delegate = self;
GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.allPlacements = @[@"PLACEMENT_ID_1", @"PLACEMENT_ID_2", @"PLACEMENT_ID_3"];
extras.playingPlacement = @"PLACEMENT_ID_1"; // Optional if you provide through AdMob dashboard
[request registerAdNetworkExtras:extras];
[self.interstitial loadRequest:request];

对于奖励式视频:

 GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.allPlacements = @[@"PLACEMENT_ID_1", @"PLACEMENT_ID_2", @"PLACEMENT_ID_3"];
extras.playingPlacement = @"PLACEMENT_ID_1"; // Optional if you provide through AdMob dashboard
[request registerAdNetworkExtras:extras];
[[GADRewardBasedVideoAd sharedInstance] loadRequest:request
withAdUnitID:@"AD_UNIT_ID"];

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

有关无法播放多条奖励式广告的注意事项:Google-Mobile-Ads-SDK 7.24.0 起,AdMob 仅支持每次预缓存一个奖励式视频广告位置。

传递其他参数(可选)

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

属性

说明

userId

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

muted

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

ordinal

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

flexViewAutoDismissSeconds

设置 Flex View 广告在播放指定秒数后自动关闭。

GADRequest *request = [GADRequest request]; VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init]; extras.allPlacements = @[PLACEMENT_ID1, REWARDED_ID2, PLACEMENT_ID3]; extras.playingPlacement = REWARDED_ID2; extras.userId = @"vungle_test_david"; extras.ordinal = 7; extras.flexViewAutoDismissSeconds = 30; [request registerAdNetworkExtras:extras]; [[GADRewardBasedVideoAd sharedInstance] loadRequest:request withAdUnitID:REWARDED2_AD_UNIT];
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!

这篇文章有帮助吗?