请使用该文档集成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
- (void)updateCCPAStatus:(VungleCCPAStatus)status;
- (VungleCCPAStatus)getCurrentCCPAStatus;
示例代码
//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无法填写第二个“加载广告”的广告请求;而是将其传递到瀑布中的下一个广告网络。