集成 MoPub + Vungle SDK iOS

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

目录:

开始之前

要求

集成Vungle iOS SDK和MoPub Adapter

  1. 请在此处下载Vungle SDK for iOS:Vungle iOS SDK v6.7.0
  2. 请查看文档integration instructions
  3. 请查看 MoPub's instructions来集成Vungle MoPub iOS Adapter Framework 6.7.0.0.

Vungle SDK v6.7.0与MoPub SDK v.5.13一起测试过了。该版本与MoPub SDK v.5.12及以下版本不兼容。

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

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 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。

Banner Formats Size MoPub Ad Size Configuration
Banner 320dp x 50dp size:MOPUB_BANNER_SIZE
Leaderboard 728dp x 90dp size:MOPUB_LEADERBOARD_SIZE
Medium rectangle 300dp x 250dp size:MOPUB_MEDIUM_RECT_SIZE
     
Flexible Banner 
(more details here)
SCREEN_WIDTH x 50 | 90 | 250 kMPPresetMaxAdSize50Height
kMPPresetMaxAdSize90Height
kMPPresetMaxAdSize250Height

示例代码:

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初始化和请求广告。

具体设置

Keys

Type/Value

说明

vngMinSpaceForInit

Integer, value in MB, default value is 50

设置最小初始化的存储空间

vngMinSpaceForAdLoad

Integer, value in MB, default value is 50

Sets the required minimum available free storage space to be able to request an ad

 

示例代码

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 来自定义广告体验。

具体设置

Keys

Type/Value

说明

orientations

0 Auto-rotate
1 Landscape
2 Portrait

设置广告展示方向。即使您的应用为横屏或竖屏应用,仍建议允许广告设置为auto-rotate以便广告自动旋转。因为这种模式,能够使全屏广告给更好的用户体验。

ordinal

Integer

该值为整数,代表观看广告的次数。欲了解更多,请查看 此处

startMuted YES or NO Vungle SDK 提供静音播放功能。该功能也可以在Vungle Dashboard上控制,如有需要请联系您的客户经理。
userIdentifier String 设置user ID。在观看完奖励广告后,该值会传递给Vungle服务器,并通过S2S callback来传递给开发者。

 

自定义插屏广告

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

具体设置

Keys

Type/Value

说明

orientations

NSNumber

0 Auto-rotate
1 Landscape
2 Portrait

设置广告展示方向。即使您的应用为横屏或竖屏应用,仍建议允许广告设置为auto-rotate以便广告自动旋转。因为这种模式,能够使全屏广告给更好的用户体验。

ordinal

NSString

该值为整数,代表观看广告的次数。欲了解更多,请查看 此处

静音

NSNumber

YES or NO

Vungle SDK 提供静音播放功能。该功能也可以在Vungle Dashboard上控制,如有需要请联系您的客户经理。

示例代码

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;
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!

这篇文章有帮助吗?