SDK Privacy for iOS

/**
 * Set the DSA information requirement.
 * 0 = Not required
 * 1 = Supported, bid responses with or without DSA object will be accepted
 * 2 = Required, bid responses without DSA object will not be accepted
 * 3 = Required, bid responses without DSA object will not be accepted, Publisher is an Online Platform
 */
[ANDSASettings.sharedInstance setDsaRequired:1];
 
/**
 * Set if the publisher renders the DSA transparency info.
 * 0 = Publisher can't render
 * 1 = Publisher could render depending on adrender
 * 2 = Publisher will render
 */
[ANDSASettings.sharedInstance setPubRender:0];
 
/**
Set the transparency list using the provided list of ANDSATransparencyInfo.
Initializes an ANDSATransparencyInfo instance with the specified domain and params.
*/
NSMutableArray<ANDSATransparencyInfo *> *transparencyList = [NSMutableArray array];
[transparencyList addObject:[[ANDSATransparencyInfo alloc] initWithDomain:@"example.com" andDSAParams:@[@1, @2, @3]]];
[transparencyList addObject:[[ANDSATransparencyInfo alloc] initWithDomain:@"example.net" andDSAParams:@[@4, @5, @6]]];
 
[ANDSASettings.sharedInstance setTransparencyList:transparencyList];

/**
 * Set the DSA information requirement.
 * 0 = Not required
 * 1 = Supported, bid responses with or without DSA object will be accepted
 * 2 = Required, bid responses without DSA object will not be accepted
 * 3 = Required, bid responses without DSA object will not be accepted, Publisher is an Online Platform
 */
ANDSASettings.sharedInstance().dsaRequired = 1
  
/**
 * Set if the publisher renders the DSA transparency info.
 * 0 = Publisher can't render
 * 1 = Publisher could render depending on adrender
 * 2 = Publisher will render
 */
ANDSASettings.sharedInstance().pubRender = 0
  
/**
Set the transparency list using the provided list of ANDSATransparencyInfo.
Initializes an ANDSATransparencyInfo instance with the specified domain and params.
*/
var transparencyList : [ANDSATransparencyInfo] = []
  
let info1 = ANDSATransparencyInfo(domain: "example.com", andDSAParams: [1, 2, 3])
transparencyList.append(info1)
  
let info2 = ANDSATransparencyInfo(domain: "example.net", andDSAParams: [4, 5, 6])
transparencyList.append(info2)
  
ANDSASettings.sharedInstance().transparencyList = transparencyList

Retrieve DSA values set in SDK

// Objective C
NSInteger dsaRequired = ANDSASettings.sharedInstance.dsaRequired;
NSInteger pubRender = ANDSASettings.sharedInstance.pubRender;
NSMutableArray<ANDSATransparencyInfo *> *transparencyList = [ANDSASettings.sharedInstance.transparencyList mutableCopy];
for (ANDSATransparencyInfo *transparencyInfo in transparencyList) {
NSString *domain = transparencyInfo.domain ?: @"";
NSArray<NSNumber *> *params = transparencyInfo.dsaparams ?: @[];
}

// Swift
let dsaRequired = ANDSASettings.sharedInstance().dsaRequired
let pubRender = ANDSASettings.sharedInstance().pubRender

if let transparencyList = ANDSASettings.sharedInstance().transparencyList {
for transparencyInfo in transparencyList {
let domain = transparencyInfo.domain ?? ""
let params = transparencyInfo.dsaparams ?? []
}
}

Retrieve DSA Response values:

- (void)requestBannerAd
{
// Make a banner ad view.
self.banner = [ANBannerAdView adViewWithFrame:CGRectMake(0, 0, 300, 250) placementId:@“1” adSize:CGSizeMake(300,250)];
self.banner.delegate = self;
//... Add required configurations
[self.banner loadAd];
}
// On Ad Loaded
- (void)adDidReceiveAd:(id)ad {
NSLog(@“Ad did receive ad”);

/**
* Retrieve on whose behalf the ad is displayed.
*/
NSString *behalf = self.banner.adResponseInfo.dsaResponseInfo.behalf;

/**
* Retrieve who paid for the ad.
*/
NSString *paid = self.banner.adResponseInfo.dsaResponseInfo.paid;

/**
* Retrieve the transparency user parameters info
*/
for (ANDSATransparencyInfo *transparencyInfo in self.banner.adResponseInfo.dsaResponseInfo.transparencyList) {
NSString *domain = transparencyInfo.domain;
NSArray<NSNumber *> *params = transparencyInfo.dsaparams;
}

/**
* Retrieve indicating if the buyer/advertiser will render DSA transparency info.
* 0 = buyer/advertiser will not render
* 1 = buyer/advertiser will render
*/
NSInteger adRender = self.banner.adResponseInfo.dsaResponseInfo.adRender;
}

func requestBannerAd() {
// Make a banner ad view.
self.banner = ANBannerAdView(frame: CGRect(origin: CGPoint(x: 0,y :0), size: CGSize(width: 300, height: 250)), placementId: “1”, adSize: CGSize(width: 300, height: 250))
self.banner!.rootViewController = self
self.banner!.delegate = self
//... Add required configurations
self.banner!.loadAd()
}
// On Ad Loaded
func adDidReceiveAd(_ ad: Any) {
print(“Ad did receive ad”)
 
/**
 * Retrieve on whose behalf the ad is displayed.
 */
let behalf : String = (self.banner?.adResponseInfo?.dsaResponseInfo?.behalf)!
 
/**
 * Retrieve who paid for the ad.
 */
let paid : String = (self.banner?.adResponseInfo?.dsaResponseInfo?.paid)!
 
/**
 * Retrieve the transparency user parameters info
 */
if let transparencyList = self.banner?.adResponseInfo?.dsaResponseInfo?.transparencyList as? [ANDSATransparencyInfo] {
 for transparencyInfo in transparencyList {
 let domain = transparencyInfo.domain
 let params = transparencyInfo.dsaparams as? [Int]
 }
}
 
/**
 * Retrieve indicating if the buyer/advertiser will render DSA transparency info.
 * 0 = buyer/advertiser will not render
 * 1 = buyer/advertiser will render
 */
let adRender : NSInteger = (self.banner?.adResponseInfo?.dsaResponseInfo?.adRender)!
}

Code sample

// For interstitialAd once adDidReceiveAd is callback
NSString* interstitialAdDSAResponseInfo = self.interstitialAd.adResponseInfo.dsaResponseInfo; // same will be followed to get other dsaResponseInfo from interstitialAd
// For videoAd once adDidReceiveAd is callback
NSString* videoAdDSAResponseInfo = self.videoAd.adResponseInfo.dsaResponseInfo; // same will be followed to get other dsaResponseInfo from videoAd
// For nativeAd once didReceiveResponse is callback
ANAdResponseInfo nativeAdResponseInfo = nativeAdResponse;
NSString* nativeAdDSAResponseInfo = nativeAdResponseInfo.dsaResponseInfo; // same will be followed to get other dsaResponseInfo from videoAd

// For interstitialAd once adDidReceiveAd is callback
let interstitialAdDSAResponseInfo? : String = (self.interstitialAd.?.adResponseInfo?.dsaResponseInfo?)! // same will be followed to get other dsaResponseInfo from interstitialAd
// For videoAd once adDidReceiveAd is callback
let videoAdDSAResponseInfo? : String = (self.videoAd.?.adResponseInfo?.dsaResponseInfo?)! // same will be followed to get other dsaResponseInfo from videoAd
// For nativeAd once didReceiveResponse is callback
let nativeAdDSAResponseInfo : String = (self.nativeAdResponse.?.adResponseInfo?.dsaResponseInfo?)! // same will be followed to get other dsaResponseInfo from nativeAd

Apple privacy manifest

Apple privacy manifest describe the data your app or third-party SDK collects. Starting with SDK version 8.11.4, we have added support for the Apple Privacy Manifest file requirement for third-party SDKs. To automatically receive the Privacy Manifest file, publishers' apps must use SDK version 8.11.4 or higher. For more information, see Apple privacy manifest