集成 MoPub + Vungle SDK iOS

请使用本指南将 Vungle iOS SDK 添加到您的应用程序中，并使用 MoPub 作为您的主要广告中介层。

目录：

• 开始之前
• 高级设置

开始之前

要求

• MoPub iOS adapter 6.8.0.0兼容SDK 6.8.0并在MoPub iOS SDK 5.13.1和Xcode 12测试过。
• MoPub Dashboard不包含各个placement层级的数据。如有需要，请使用 Reporting API for Publishers，来查看placement层级数据。
• 请根据MoPub’s Getting Started Guide for iOS文档先进行集成配置。
• 请参阅我们有关 MoPub 与您的应用程序进行集成的说明文档。
  • 插屏式广告：https://developers.mopub.com/docs/ios/interstitial/
  • 奖励式视频：https://developers.mopub.com/docs/ios/rewarded-video/
  • Banner (320 x 50), Leaderboard (728 x 90), MREC (300 x 250): https://developers.mopub.com/publishers/ios/banner/
• 请使用正确的Xcode和iOS SDK版本，详情请查看我们的集成文档。
• Vungle iOS SDK v.6.8.0 和 MoPub iOS adapter 6.8.0.0 支持 SKAdetwork， AppTrackingTransparency和Xcode12。

集成Vungle iOS SDK和MoPub Adapter

1. 下载SDK：Vungle iOS SDK v6.8.0。
2. 请查看文档integration instructions。
3. 请查看MoPub's instructions来集成Vungle MoPub iOS Adapter Framework 6.8.0.0。

Vungle SDK v6.7.0+兼容MoPub SDK v.5.13+，但不兼容MoPub SDK v.5.12和以下版本

IOS14: SKAdNetwork Support

Vungle SDK v6.8.0支持iOS 14 和 SKAdNetwork 2.0。IOS14相关信息，请查看 此处。

请根据以下步骤，添加 SKAdNetworkID：

1. 在Xcode中Project，打开Info.plist 文件。
2. 在Info.plist文件中，点击加号(+)来创建一个新的property。
3. 添加 SKAdNetworkItems 并选择 Array 类型。
4. 添加dictionary item，并添加一个字符串值。
5. 字符串值中添加 SKAdNetworkIdentifier 的值为 ad network identifier。

CCPA

自2020年7月1日起，California Consumer Privacy Act (CCPA)开始实行。开发者需要更新SDK 6.7.0和MoPub adapter 6.7.0.0来符合CCPA。

为了传递CCPA值，您必须要直接调用Vungle SDK API。这也是唯一的一个功能，您需要直接调用Vungle SDK的API。 其他 optional features，其他optional features请使用 VungleAdapterConfiguration。

请使用 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 CCPA status is:
[[VungleSDK sharedSDK] getCCPAStatus];

Banner Ad Size

Vungle支持3种banner尺寸：Banner, Medium rectangle, Leaderboard。请使用不小于这些广告尺寸大小的容器来展示这些广告。请使用size高度来加载特定Banner广告。请注意，与其他配置为横幅的横幅尺寸相比，MREC（300dp x 250dp）必须具有从VungleDashboard上配置为MREC的单独的放置参考 reference ID。

示例代码：

self.adView = [[MPSampleAppInstanceProvider sharedProvider] buildMPAdViewWithAdUnitID:self.info.ID size:MOPUB_MEDIUM_RECT_SIZE];

高级设置

SDK提前初始化（强烈建议）

自MoPub5.5.0及以后版本，允许您可以在初始化MoPub后即刻初始化Ad Network SDK。我们强烈建议您使用该功能，这能让Vungle SDK有更多的时间来预缓存广告以增加展示的机会。

示例代码：

MPMoPubConfiguration * sdkConfig = [[MPMoPubConfiguration alloc]
initWithAdUnitIdForAppInitialization:@"MOPUB_AD_UNIT_WITH_VUNGLE_PLACEMENT"];

NSMutableDictionary *configDictionary = [NSMutableDictionary dictionaryWithDictionary:@{ @"appId" : @"YOUR_VUNGLE_APP_ID" }];
 
[sdkConfig setNetworkConfiguration:configDictionary forMediationAdapter:@"VungleAdapterConfiguration"];

[[MoPub sharedInstance] initializeSdkWithConfiguration:sdkConfig
   completion:^{
  NSLog(@"SDK initialization complete");
}];

Memory Settings

自SDK 6.4.0以后，您可以通过设置最小初始化和请求广告的存储空间来阻止SDK初始化和请求广告。

具体设置

示例代码

NSMutableDictionary *configDictionary = [NSMutableDictionary dictionaryWithDictionary:@{ @"appId" : @"YOUR_VUNGLE_APP_ID" }];

[[NSUserDefaults standardUserDefaults] setValue:@(50) forKey:@"vngMinSpaceForInit"];
[[NSUserDefaults standardUserDefaults] setValue:@(50) forKey:@"vngMinSpaceForAdLoad"];
 
[sdkConfig setNetworkConfiguration:configDictionary forMediationAdapter:@"VungleAdapterConfiguration"];

禁用IDFV

自从iOS SDK 6.4.3以后，当用户开启 Limit Ad Tracking时开发者可以禁止SDK获取IDFV 。请 import VungleRouter.h 在初始化之前调用该API。

示例代码

#import "VungleRouter.h"

// Invoke setShouldCollectDeviceId before initialization of Vungle SDK
[VungleRouter.sharedRouter setShouldCollectDeviceId:NO];

自定义Rewarded Ads

请使用 VungleInstanceMediationSettings 来自定义广告体验。

具体设置

自定义插屏广告

自MoPub adapter 6.4.5.1，您可以使用localExtras 来设置自定义选项给插屏广告

具体设置

示例代码

NSNumber *orientations = [NSNumber numberWithInt:1];
NSString *ordinal = @"10";
NSNumber *muted = [NSNumber numberWithBool:YES];

NSDictionary *localExtras = @{@"ordinal" : ordinal ?: @"",
                              @"muted" : muted ?: @"",
                              @"orientations" : orientations ?: @""};
    
self.interstitial.localExtras = localExtras;