使用AdMob聚合Vungle iOS SDK

请使用该文档集成Vungle iOS SDK到以AdMob为mediation的应用中。AdMob iOS adapter v6.9.1.0兼容Vungle iOS SDK v6.9.1并在 Google SDK v7.69.0上用Xcode 12测试通过。

下载 AdMob iOS Adapter v6.9.1.0 和 Vungle iOS SDK 6.9.1并手动集成到您的应用中。 

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

pod "VungleSDK-iOS", "6.9.1"

目录:

在你开始之前

  • 在AdMob信息中心中设置广告单元。
  • 确保在Vungle后台中创建了Vungle应用ID和展示位置ID,并确保将Vungle展示位置ID链接到AdMob后台中的广告单元。请参阅AdMob的集成文档 有关设置广告单元并将Vungle的展示位置ID链接到AdMob信息中心中的AdMob广告单元的详细步骤。
  • 使用正确的Xcode和iOS SDK版本设置应用程序,如 Vungle iOS集成说明

支持仅iOS 14+ 支持SKAdNetwork

IOS Vungle SDK 6.8.0+ 在Xcode 12 上支持 iOS 14 和 SKAdNetwork 2.0 。 更多信息,请查看文档our iOS integration instructions

CCPA

自2020年7月1日起,《加利福尼亚消费者隐私法案》(CCPA)生效,发布者必须更新到Vungle iOS SDK v6.7.0和MoPub适配器6.7.0.0,以符合CCPA。

要传递CCPA值,请直接调用Vungle SDK API。这是应该通过Vungle SDK API直接访问的唯一功能。其他 可选功能 应该使用 VungleRouterConfiguration 适配器中提供的类。

  updateCCPAStatus  设置用户的同意状态,以指定用户已通过退出选择退出  updateCCPAStatus:VungleCCPADenied 。并使用  getCurrentCCPAStatus  获取特定用户的当前CCPA状态。

CCPA API

Update CCPAgetCurrentCCPAStatus
- (void)updateCCPAStatus:(VungleCCPAStatus)status;

示例代码

//To set the user's CCPA status to opt_out:
[[VungleSDK sharedSDK] updateCCPAStatus:VungleCCPADenied];
//To find out what the user's current consent status is:
[[VungleSDK sharedSDK] getCurrentCCPAStatus];

设置

在开始测试新适配器之前:

  • 将应用程序与最新的适配器文件和Vungle SDK集成在一起。
  • 将Google Mobile Ads SDK更新到项目中的最新版本。

横幅广告

从Vungle SDK v6.5.1开始,我们扩展了对AdMob横幅广告的支持,并支持以下尺寸:

Size in points (WxH) 说明 AdSize constant
320 x 50 Banner

kGADAdSizeBanner

728x90 IAB leaderboard kGADAdSizeLeaderboard
SCREEN_WIDTH x 32 | 50 | 90 Smart Banner

kGADAdSizeSmartBannerPortrait

300 x 250 Medium Rectangle (MREC)

kGADAdSizeMediumRectangle

Mobile: 320 x 50

Tablet: 728 x 90

Adaptive Banner

GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth

请注意,MREC(300dp x 250dp)格式必须具有其自己的单独的放置参考ID。必须在Vungle后台中将MREC格式配置为“ MREC”,这与可以在与“横幅”相同的展示位置ID下配置多个横幅尺寸的方式相反。

要在您的应用程序中显示横幅广告,请在Vungle后台创建MREC展示位置,然后将该展示位置链接到AdMob后台中的横幅广告单元。

目前,Vungle支持横幅尺寸300 x 250,在您的实现中必须将其指定为恒定的广告尺寸kGADAdSizeMediumRectangle

Sample Code:

GADBannerView *bannerView = [[GADBannerView alloc] initWithAdSize:kGADAdSizeMediumRectangle];
[self addBannerViewToView:self.bannerView];

有关加载,播放和关闭横幅广告的详细信息,请参阅AdMob集成指南

 

Multiple Banner Load

Vungle iOS SDK 6.5.x支持在任何给定时间为一个展示位置ID加载一个横幅广告,并且一个展示位置ID映射到一个AdMob广告单元ID。当Vungle SDK已加载横幅广告时,这限制了成功加载后续loadAd请求的能力。为克服此限制,请为每个横幅广告的横幅广告位置传递相同的AdMob广告单元ID loadAd 以便当Vungle SDK已加载横幅广告时,请求可以回落到瀑布中的下一个广告网络。

示例代码:

VungleAdNetworkExtras *extras1 = [[VungleAdNetworkExtras alloc] init];
GADBannerView *bannerView1 = [[GADBannerView alloc] initWithAdSize:bannerSize];
bannerView1.adUnitID = @"AD_UNIT_ID"

GADRequest *request1 = [GADRequest request];
[request1 registerAdNetworkExtras:extras1];
[bannerView1 loadRequest:request1];

VungleAdNetworkExtras *extras2 = [[VungleAdNetworkExtras alloc] init];
GADBannerView *bannerView2 = [[GADBannerView alloc] initWithAdSize:bannerSize];
bannerView2.adUnitID = @"AD_UNIT_ID_FOR_BANNER"

GADRequest *request2 = [GADRequest request];
[request2 registerAdNetworkExtras:extras2];
[bannerView2 loadRequest:request2];

可选的高级设置

IDFV

对于Vungle SDK 6.4或更高版本,您现在可以限制SDK将IDFV从设备传递到SDK。

Sample Code:

//Set the bool value YES to pass the IDFV from device to SDK
[VungleRouterConfiguration setPublishIDFV:YES];
//Set the bool value NO to disable the IDFV collection from device to SDK
[VungleRouterConfiguration setPublishIDFV:NO];

内存设定

从Vungle SDK v6.4.x开始,如果iPhone的存储空间低于预定义的阈值,则可以阻止SDK请求广告甚至进行初始化。

Sample Code:


//Integer value sets the required minimum available free storage space to be able to initialize the SDK
 [VungleRouterConfiguration setMinSpaceForInit:];
//Integer value sets the required minimum available free storage space to be able to request an Ad
[VungleRouterConfiguration setMinSpaceForAdLoad:];

 

New Rewarded API

如AdMob所述,从7.42.2及更高版本开始,AdMob的奖励广告可让您同时为一个广告单元缓存多个广告。

由于Vungle不支持此功能,因此Vungle无法填写第二个“加载广告”的广告请求;而是将其传递到瀑布中的下一个广告网络。

 

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

这篇文章有帮助吗?