The offers the app full control over the lifecycle of individual banner ad impressions. It allows the app to load a banner ad independently, with the option to render it at a later time. By loading an ad with a specific configuration, the app receives notifications about the result of that load request through the . As a result, the RTBBannerAdProvider is used differently from the RTBBannerView.
Request Ad
To load a banner ad, you will need to pass an instance of with placementID and the bundleId. Please contact our to get the needed IDs.
You will be notified about the loading success or failure through the instance passed as loadDelegate. If the ad loads successfully, you will obtain RTBBannerBid instance that can later be used to obtain the banner view.
Optional - set user targeting
You can pass user targeting data to each request, allowing ads to be more relevant to your audience. Each field in is optional.
let configuration = RTBBannerRequestConfiguration(placementId: <PLACEMENT_ID>, iTunesAppId: <ITUNES_APP_ID>)
configuration.userTargeting = .init(userId: "<USER_ID>", gender: .male, yearOfBirth: 1999, keywords: ["keyword1", "keyword2"])
// yearOfBirth must be a 4-digit number, otherwise, it will be ignored
Get Loaded Banner View
Once the banner is loaded and the method bannerAdDidReceiveAd(bannerBid: RTBBannerBid) is called, you can get the loaded banner view by calling the RTBBannerAdProvider.getBannerView(bannerBid: bannerBid, delegate: self) method passing the received instance. You can also pass optional that will be notified about banner events like clicks.
func bannerAdDidReceiveAd(bannerBid: RTBSDK.RTBBannerBid) {
DispatchQueue.main.async {
guard let bannerView = RTBBannerAdProvider.getBannerView(bannerBid: bannerBid, delegate: self) else {
return
}
let price = bannerBid.priceCPM // in USD
let bidder = bannerBid.bidder
// Adjust and display the banner view
}
}
The currency of bidFloor and priceCPM parameters is USD.
Complete Code Example
import RTBSDK
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
// Do any additional setup after loading the view.
}
override func viewDidAppear(_ animated: Bool) {
super.viewDidAppear(animated)
// Prepare request configurations
let configuration = RTBBannerRequestConfiguration(placementId: <PLACEMENT_ID>, iTunesAppId: <ITUNES_APP_ID>)
configuration.sellerId = "<SELLERID>" // Optional
configuration.bidFloor = <BID_FLOOR> // Optional
// Request a banner ad
RTBBannerAdProvider.load(configuration: configuration, size: .banner320x50, userAgent: "<USER_AGENT>", loadDelegate: self)
}
}
extension ViewController: RTBBannerAdLoadDelegate {
func bannerAdDidReceiveAd(bidInfo: RTBBidInfo, networkName: String) {
// A banner ad has been loaded
guard let bannerView = RTBBannerAdProvider.getBannerView(bannerBid: bannerBid, delegate: self) else {
return
}
// Display the banner view
}
}
extension ViewController: RTBBannerAdInteractionDelegate {
func bannerAdDidRecordClick() {
// The banner received a click
}
func bannerAdDidPauseForAd() {
// The app paused after the user clicked on the ad and opened Safari app
}
func bannerAdDidResumeAfterAd() {
// The app resumed after returning from Safari as a result of user click
}
func bannerAdDidFailToRender(error: String) {
// Failed to render e banner ad
}
}
