文档

Unity Ads 变现

iOS API 参考 - Swift

iOS API 参考 - Objective-C

Unity Ads 变现

iOS 已弃用的 API

标识 iOS 已弃用的 Unity Ads SDK 类以及替换和删除版本。
阅读时间17 分钟最后更新于 1 个月前

iOS 已弃用类

对于 Unity Ads SDK 4.19.0 版本的 iOS SDK，以下 API 类已弃用或弃用。

初始化

要移除的 API

弃用版本

改用

移除版本

弃用原因

UADSMediationMetaData
4.19.0
UADSMediationInfo
— 使用 
initWithName:version:adapterVersion:
初始化		5.0.0替换为基于构建器的初始化 API 中使用的类型
UADSMediationInfo
值对象。
[UnityAds setDebugMode:]
4.19.0通过 
[UADSInitializationConfigurationBuilder withLogLevel:]
设置
UADSLogLevel
（例如 
UADSLogLevelDebug
）		5.0.0布尔调试模式开关被初始化配置构建器上设置的 4 级
UADSLogLevel
所取代，从而更好地控制日志详细程度。
[UnityAds initialize:]
和所有重载（
initializationDelegate:
、
testMode:
、
testMode:initializationDelegate:
）		4.19.0
[UnityAds initialize:[builder build] completion:^(id<UnityAdsError> error){…}]
使用 
UADSInitializationConfigurationBuilder
5.0.0由构建器模式初始化 API 替换为完成代码块而不是委托。
UnityAdsInitializationDelegate
协议		4.19.0将完成代码块
^(id<UnityAdsError> error)
通道给新的
[UnityAds initialize:completion:]
方法		5.0.0基于委托的初始化回调被完成代码块取代，用于更简单的内联报错处理。

插页式广告服务

要移除的 API

弃用版本

改用

移除版本

弃用原因

[UnityAds load:options:loadDelegate:]
（插屏）		4.19.0
[UADSInterstitialAd 加载：[构建器构建]完成：^(UADSInterstitialAd *ad, id<UnityAdsError> 报错){…}]
5.0.0UnityAds 上的类方法替换为加载的广告对象上的实例方法，结果通过完成代码块提供。
UnityAdsLoadDelegate
协议（插页式）		4.19.0将完成代码块通道给 
[UADSInterstitialAd load:completion:]
5.0.0在基于实例的广告加载 API 中委托由完成代码块替换的回调。
UADSLoadOptions.adMarkup
（插屏）		4.19.0
[UADSLoadConfigurationBuilder withAdMarkup:]
5.0.0Mutable 属性替换为不可变的构建器模式配置。
UADSLoadOptions.objectId
（插屏）		4.19.0无需替换 — 对象 ID 现在由 SDK 在内部进行管理5.0.0不再需要手动关联 ID；SDK 在内部处理广告实例跟踪。
[UnityAds show:placementId:options:showDelegate:]
（插屏）		4.19.0
[self.interstitialAd show:[builder build] delegate:delegate]
实例上的 
UADSInterstitialAd
5.0.0UnityAds 上的类方法被加载的广告对象上的实例方法替换。
UnityAdsShowDelegate
协议（插页式）		4.19.0与 
showDidStart:
、
showDidClick:
、
showDidComplete:with:
、
showDidFail:error:
UADSInterstitialShowDelegate
5.0.0通用展示委托由特定于广告类型的委托取代，该委托传递广告实例而不是放置/位置 ID 字符串。
UADSShowOptions.objectId
（插屏）		4.19.0无需替换 — 对象 ID 现在由 SDK 在内部进行管理5.0.0不再需要手动关联 ID；SDK 在内部处理广告实例跟踪。
UADSShowOptions
（插屏）		4.19.0
UADSShowConfigurationBuilder
— 使用 
withViewController:
5.0.0Mutable options 对象替换为不可变的构建器模式显示配置。

奖励广告

基于元数据的服务器端奖励验证 ID 替换为展示配置上键入的 ID，与基于构建器的广告对象 API 一致。

要移除的 API

弃用版本

改用

移除版本

弃用原因

[UnityAds load:options:loadDelegate:]
（奖励广告）：		4.19.0
[UADSRewardedAd 加载：[构建器构建]完成：^(UADSRewardedAd *ad, id<UnityAdsError> 报错){…}]
5.0.0UnityAds 上的类方法替换为加载的广告对象上的实例方法，结果通过完成代码块提供。
UnityAdsLoadDelegate
协议（奖励）		4.19.0将完成代码块通道给 
[UADSRewardedAd load:completion:]
5.0.0在基于实例的广告加载 API 中委托由完成代码块替换的回调。
UADSLoadOptions.adMarkup
（奖励广告）		4.19.0
[UADSLoadConfigurationBuilder withAdMarkup:]
5.0.0Mutable 属性替换为不可变的构建器模式配置。
UADSLoadOptions.objectId
（奖励广告）		4.19.0无需替换 — 对象 ID 现在由 SDK 在内部进行管理5.0.0不再需要手动关联 ID；SDK 在内部处理广告实例跟踪。
[UnityAds show:placementId:options:showDelegate:]
（奖励广告）		4.19.0
[self.rewardedAd show:[builder build] delegate:delegate]
实例上的 
UADSRewardedAd
5.0.0UnityAds 上的类方法被加载的广告对象上的实例方法替换。
UnityAdsShowDelegate
协议（奖励）		4.19.0具有专用 
showDidReceiveReward:
回调的
UADSRewardedShowDelegate
5.0.0通用展示委托由具有专用奖励回调的指定奖励委托取代。
UADSShowOptions.objectId
（奖励广告）		4.19.0无需替换 — 对象 ID 现在由 SDK 在内部进行管理5.0.0不再需要手动关联 ID；SDK 在内部处理广告实例跟踪。
UADSPlayerMetaData
(
-setServerId:
)		 4.19.0 
[UADSShowConfigurationBuilder withCustomRewardString:]
UADSShowConfiguration
传递给 
-[UADSRewardedAd show:delegate:]
 5.0.0
kUnityShowCompletionStateCompleted
, 
kUnityShowCompletionStateSkipped
4.19.0
UADSShowFinishStateCompleted
, 
UADSShowFinishStateSkipped
5.0.0重命名为统一
UADSShowFinishState
类型一部分的常量。
UnityAdsShowCompletionState
4.19.0
UADSShowFinishState
5.0.0枚举类型已重命名，以便与新的基于实例的广告 API 保持一致。
构造函数 + 单独加载方法由具有构建器配置和完成代码块的统一静态加载取代，与新的间歇加载和奖励加载模式相匹配。

要移除的 API

弃用版本

改用

移除版本

弃用原因

UADSBannerView
4.19.0
UADSBannerAd
— 通过 
.view
属性访问视图并将其添加到层级视图		5.0.0Direct view 类替换为广告实例对象，其视图通过属性访问，与新的广告对象模型一致。
UADSBannerViewDelegate
协议		4.19.0与 
bannerImpression:
、
bannerDidClick:
、
bannerDidFailShow:error:
UADSBannerAdDelegate
5.0.0视图级别委托由广告对象委托取代。加载结果将移动到
load(_:completion:)
完成处理程序中；
bannerViewDidLeaveApplication:
将被删除，无需替换。
bannerViewDidLoad:
上 
UADSBannerViewDelegate
4.19.0加载结果现在通过
UADSBannerAd.load(_:completion:)
完成代码块提供，没有委托回调		5.0.0加载通知从委托移出并进入加载完成代码块，与新的插页式和奖励加载模式相匹配。
bannerViewDidLeaveApplication:
上 
UADSBannerViewDelegate
4.19.0无替换5.0.0删除了回调，但新
UADSBannerAdDelegate
中没有相应的回调。
[[UADSBannerView alloc] initWithPlacementId:size:]
+ 
[banner loadWithOptions:]
 4.19.0 
[UADSBannerAd load:[builder build] completion:^(UADSBannerAd *ad, id<UnityAdsError> error){…}]
via 
UADSBannerLoadConfigurationBuilder
 5.0.0
UADSBannerLoadOptions
4.19.0
UADSBannerLoadConfiguration
通过 
UADSBannerLoadConfigurationBuilder
5.0.0横幅指定的可变加载选项对象替换为不可变构建器图案配置。
UADSLoadOptions.adMarkup
(banner)		4.19.0
[UADSBannerLoadConfigurationBuilder withAdMarkup:]
5.0.0Mutable 属性替换为不可变的构建器模式配置。
UADSLoadOptions.objectId
(banner)		4.19.0无需替换 — 对象 ID 现在由 SDK 在内部进行管理5.0.0不再需要手动相关性 ID；SDK 在内部处理广告实例跟踪。

令牌收集（出价）

要移除的 API

弃用版本

改用

移除版本

弃用原因

+[UnityAds getToken]
, 
+[UnityAds getToken:]
, 
+[UnityAds getTokenWith:completion:]
4.19.0具有
UADSTokenConfigurationBuilder
构建配置的
+[UnityAds getToken:completion:]
5.0.0无参数 getter、仅完成 getter 和旧版 
UnityAdsTokenConfiguration
重载都替换为单个入口点，该入口点接受通过 
UADSTokenConfigurationBuilder
构建的键入
UADSTokenConfiguration
。
UnityAdsTokenConfiguration
+ 
[UnityAdsTokenConfiguration newWithAdFormat:]
4.19.0
UADSTokenConfigurationBuilder
— 使用 
initWithAdFormat:
、
withMediationInfo:
或可选 
withBannerSize:
5.0.0配置对象替换为构建器，使聚合信息和横幅大小能够包含在一致的模式中。
UnityAdsAdFormat
枚举		4.19.0具有值 
UADSAdFormatBanner
、
UADSAdFormatInterstitial
、
UADSAdFormatRewarded
的
UADSAdFormat
枚举		5.0.0重命名枚举是为了与新的以 
UADS
为前缀的 API 表面保持一致。

隐私

要移除的 API

弃用版本

改用

移除版本

弃用原因

UADSMetaData
带键 
gdpr.consent
4.19.0
[UnityAds setUserConsent:]
5.0.0字符串键值隐私元数据，由键入的静态方法替换。
具有关键
privacy.consent
的
UADSMetaData
(CCPA)		4.19.0
[UnityAds setUserOptOut:]
— 用户选择退出时通道
YES
（不出售）		5.0.0字符串键值隐私元数据被具有显式选择退出语义的键入静态方法取代。
具有关键
user.nonBehavioral
的
UADSMetaData
（COPPA、面向儿童的法律）		4.19.0
[UnityAds setNonBehavioral:]
5.0.0隐私模式字符串替换为用于非行为/上下文广告控制的显式布尔 API。

错误处理

要移除的 API

弃用版本

改用

移除版本

弃用原因

UnityAdsInitializationError
枚举		4.19.0统一的 
id<UnityAdsError>
protocol with 
.code
(NSInteger) and 
.message
(NSString)		5.0.0单独的每次操作报错枚举由具有标准化数字代码的统一报错协议取代。
UnityAdsLoadError
枚举		4.19.0统一
id<UnityAdsError>
协议		5.0.0单独的每次操作报错枚举由具有标准化数字代码的统一报错协议取代。
UnityAdsShowError
枚举		4.19.0统一
id<UnityAdsError>
协议		5.0.0单独的每次操作报错枚举由具有标准化数字代码的统一报错协议取代。
UADSBannerErrorCode
枚举		4.19.0统一
id<UnityAdsError>
协议		5.0.0横幅指定的报错枚举被所有广告类型中使用的相同统一报错协议所取代。