Deprecate methods and properties for 3.0

PrebidMobile/AdUnits/AdUnit.swift

@@ -385,37 +385,43 @@ public class AdUnit: NSObject, DispatcherDelegate {
     /// Sets the app content object, replacing any existing content.
     ///
     /// - Parameter appContentObject: The `PBMORTBAppContent` object representing the app's content.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func setAppContent(_ appContentObject: PBMORTBAppContent) {
         adUnitConfig.setAppContent(appContentObject)
     }
 
     /// Retrieves the current app content object.
     ///
     /// - Returns: The current `PBMORTBAppContent` object, or `nil` if no content is set.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.getGlobalORTBConfig method instead.")
     public func getAppContent() -> PBMORTBAppContent? {
         return adUnitConfig.getAppContent()
     }
 
     /// Clears the current app content object.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContent() {
         adUnitConfig.clearAppContent()
     }
 
     /// Adds an array of content data objects to the app content.
     ///
     /// - Parameter dataObjects: An array of `PBMORTBContentData` objects to add.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addAppContentData(_ dataObjects: [PBMORTBContentData]) {
         adUnitConfig.addAppContentData(dataObjects)
     }
 
     /// Removes a specific content data object from the app content.
     ///
     /// - Parameter dataObject: The `PBMORTBContentData` object to remove.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeAppContentData(_ dataObject: PBMORTBContentData) {
         adUnitConfig.removeAppContentData(dataObject)
     }
 
     /// Clears all content data objects from the app content.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContentData() {
         adUnitConfig.clearAppContentData()
     }
@@ -425,25 +431,29 @@ public class AdUnit: NSObject, DispatcherDelegate {
     /// Retrieves the current user data.
     ///
     /// - Returns: An array of `PBMORTBContentData` objects representing the user data, or `nil` if no data is available.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.getGlobalORTBConfig method instead.")
     public func getUserData() -> [PBMORTBContentData]? {
         return adUnitConfig.getUserData()
     }
 
     /// Adds an array of user data objects.
     ///
     /// - Parameter userDataObjects: An array of `PBMORTBContentData` objects to add to the user data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addUserData(_ userDataObjects: [PBMORTBContentData]) {
         adUnitConfig.addUserData(userDataObjects)
     }
 
     /// Removes a specific user data object.
     ///
     /// - Parameter userDataObject: The `PBMORTBContentData` object to remove from the user data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeUserData(_ userDataObject: PBMORTBContentData) {
         adUnitConfig.removeUserData(userDataObject)
     }
 
     /// Clears all user data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearUserData() {
         adUnitConfig.clearUserData()
     }

PrebidMobile/ConfigurationAndTargeting/Prebid.swift

@@ -89,6 +89,7 @@ public class Prebid: NSObject {
     // MARK: - Public Properties (Prebid)
 
     /// The host for the Prebid Server.
+    @available(*, deprecated, message: "This property is deprecated. In the upcoming major release, the property will be removed.")
     public var prebidServerHost: PrebidHost = .Custom {
         didSet {
             timeoutMillisDynamic = NSNumber(value: timeoutMillis)

PrebidMobile/ConfigurationAndTargeting/Targeting.swift

@@ -467,6 +467,7 @@ public class Targeting: NSObject {
     /// - Parameters:
     ///   - key: The key for the user data.
     ///   - value: The value to add for the specified key.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed.")
     public func addUserData(key: String, value: String) {
         var values = rawUserDataDictionary[key] ?? Set<String>()
         values.insert(value)
@@ -479,32 +480,37 @@ public class Targeting: NSObject {
     /// - Parameters:
     ///   - key: The key for the user data.
     ///   - value: The set of values to update for the specified key.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed.")
     public func updateUserData(key: String, value: Set<String>) {
         rawUserDataDictionary[key] = value
     }
 
     /// Removes user data for a specified key.
     ///
     /// - Parameter key: The key for the user data to remove.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed.")
     public func removeUserData(for key: String) {
         rawUserDataDictionary.removeValue(forKey: key)
     }
 
     /// Clears all user data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed.")
     public func clearUserData() {
         rawUserDataDictionary.removeAll()
     }
 
     /// Retrieves all user data.
     ///
     /// - Returns: A dictionary mapping keys to arrays of values.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed.")
     public func getUserData() -> [String: [String]] {
         rawUserDataDictionary.mapValues { Array($0) }
     }
 
     /// User data dictionary for external use.
     ///
     /// - Returns: A dictionary mapping keys to arrays of values.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed.")
     public var userDataDictionary: [String : [String]] {
         rawUserDataDictionary.mapValues { Array($0) }
     }

PrebidMobile/Host.swift

@@ -16,6 +16,7 @@
 import UIKit
 
 /// `PrebidHost` represents various Prebid server hosts used for ad bidding.
+@available(*, deprecated, message: "This enum is deprecated. In the upcoming major release, the enum will be removed.")
 @objc public enum PrebidHost: Int {
 
     /// URL [https://ib.adnxs.com/openrtb2/prebid](URL)

PrebidMobile/PrebidMobileRendering/Prebid/Integrations/GAM/BannerView.swift

@@ -391,28 +391,33 @@ public class BannerView:
 
     /// Sets the app content data.
     /// - Parameter appContent: The app content data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func setAppContent(_ appContent: PBMORTBAppContent) {
         adUnitConfig.setAppContent(appContent)
     }
 
     /// Clears the app content data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContent() {
         adUnitConfig.clearAppContent()
     }
 
     /// Adds app content data objects.
     /// - Parameter dataObjects: The data objects to be added.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addAppContentData(_ dataObjects: [PBMORTBContentData]) {
         adUnitConfig.addAppContentData(dataObjects)
     }
 
     /// Removes an app content data object.
     /// - Parameter dataObject: The data object to be removed.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeAppContentDataObject(_ dataObject: PBMORTBContentData) {
         adUnitConfig.removeAppContentData(dataObject)
     }
 
     /// Clears all app content data objects.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContentDataObjects() {
         adUnitConfig.clearAppContentData()
     }
@@ -421,17 +426,20 @@ public class BannerView:
 
     /// Adds user data objects.
     /// - Parameter userDataObjects: The user data objects to be added.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addUserData(_ userDataObjects: [PBMORTBContentData]) {
         adUnitConfig.addUserData(userDataObjects)
     }
 
     /// Removes a user data object.
     /// - Parameter userDataObject: The user data object to be removed.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeUserData(_ userDataObject: PBMORTBContentData) {
         adUnitConfig.removeUserData(userDataObject)
     }
 
     /// Clears all user data objects.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearUserData() {
         adUnitConfig.clearUserData()
     }

PrebidMobile/PrebidMobileRendering/Prebid/Integrations/GAM/InterstitialRenderingAdUnit.swift

@@ -325,28 +325,33 @@ public class InterstitialRenderingAdUnit: NSObject, BaseInterstitialAdUnitProtoc
 
     /// Sets the app content data.
     /// - Parameter appContent: The app content data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func setAppContent(_ appContent: PBMORTBAppContent) {
         adUnitConfig.setAppContent(appContent)
     }
 
     /// Clears the app content data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContent() {
         adUnitConfig.clearAppContent()
     }
 
     /// Adds app content data objects.
     /// - Parameter dataObjects: The data objects to be added.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addAppContentData(_ dataObjects: [PBMORTBContentData]) {
         adUnitConfig.addAppContentData(dataObjects)
     }
 
     /// Removes an app content data object.
     /// - Parameter dataObject: The data object to be removed.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeAppContentDataObject(_ dataObject: PBMORTBContentData) {
         adUnitConfig.removeAppContentData(dataObject)
     }
 
     /// Clears all app content data objects.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContentDataObjects() {
         adUnitConfig.clearAppContentData()
     }
@@ -355,17 +360,20 @@ public class InterstitialRenderingAdUnit: NSObject, BaseInterstitialAdUnitProtoc
 
     /// Adds user data objects.
     /// - Parameter userDataObjects: The user data objects to be added.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addUserData(_ userDataObjects: [PBMORTBContentData]) {
         adUnitConfig.addUserData(userDataObjects)
     }
 
     /// Removes a user data object.
         /// - Parameter userDataObject: The user data object to be removed.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeUserData(_ userDataObject: PBMORTBContentData) {
         adUnitConfig.removeUserData(userDataObject)
     }
 
     /// Clears all user data objects.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearUserData() {
         adUnitConfig.clearUserData()
     }

PrebidMobile/PrebidMobileRendering/Prebid/Integrations/GAM/RewardedAdUnit.swift

@@ -309,28 +309,33 @@ public class RewardedAdUnit: NSObject, BaseInterstitialAdUnitProtocol {
 
     /// Sets the app content data.
     /// - Parameter appContent: The app content data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func setAppContent(_ appContent: PBMORTBAppContent) {
         adUnitConfig.setAppContent(appContent)
     }
 
     /// Clears the app content data.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContent() {
         adUnitConfig.clearAppContent()
     }
 
     /// Adds app content data objects.
     /// - Parameter dataObjects: The data objects to be added.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addAppContentData(_ dataObjects: [PBMORTBContentData]) {
         adUnitConfig.addAppContentData(dataObjects)
     }
 
     /// Removes an app content data object.
     /// - Parameter dataObject: The data object to be removed.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeAppContentDataObject(_ dataObject: PBMORTBContentData) {
         adUnitConfig.removeAppContentData(dataObject)
     }
 
     /// Clears all app content data objects.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearAppContentDataObjects() {
         adUnitConfig.clearAppContentData()
     }
@@ -339,17 +344,20 @@ public class RewardedAdUnit: NSObject, BaseInterstitialAdUnitProtocol {
 
     /// Adds user data objects.
     /// - Parameter userDataObjects: The user data objects to be added.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func addUserData(_ userDataObjects: [PBMORTBContentData]) {
         adUnitConfig.addUserData(userDataObjects)
     }
 
     /// Removes a user data object.
         /// - Parameter userDataObject: The user data object to be removed.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func removeUserData(_ userDataObject: PBMORTBContentData) {
         adUnitConfig.removeUserData(userDataObject)
     }
 
     /// Clears all user data objects.
+    @available(*, deprecated, message: "This method is deprecated. In the upcoming major release, the method will be removed. Please, use Targeting.setGlobalORTBConfig method instead.")
     public func clearUserData() {
         adUnitConfig.clearUserData()
     }