Documentation Index
Fetch the complete documentation index at: https://guide.daro.so/llms.txt
Use this file to discover all available pages before exploring further.
Banner Ads
Rectangular ad format (320x50) that occupies part of your app layout. Supported by most ad demand sources.
MREC Ads
Medium Rectangle format (300x250) with similar characteristics to banner ads.
Ad Unit Setup
Configure your ad unit using the ad unit ID issued from the dashboard.
let bannerUnit = DaroAdUnit(unitId: "your_banner_unit_id")
let mrecUnit = DaroAdUnit(unitId: "your_mrec_unit_id")
// In Objective-C, unitId is passed directly during initialization
// instead of creating a separate DaroAdUnit
NSString *bannerUnitId = @"your_banner_unit_id";
NSString *mrecUnitId = @"your_mrec_unit_id";
Ad Implementation
Basic Usage
// Banner ad
let bannerView = DaroAdBannerView(
unit: bannerUnit,
bannerSize: .banner
)
// MREC ad
let bannerView = DaroAdBannerView(
unit: mrecUnit,
bannerSize: .MREC
)
// Banner ad
DaroObjCBannerView *bannerView = [[DaroObjCBannerView alloc]
initWithUnitId:bannerUnitId
bannerSize:DaroObjCBannerSizeBanner];
// MREC ad
DaroObjCBannerView *mrecView = [[DaroObjCBannerView alloc]
initWithUnitId:mrecUnitId
bannerSize:DaroObjCBannerSizeMrec];
Note: Banner ads automatically load the initial ad upon creation.
Manual Initial Load Setup
You can use the autoLoad parameter to directly control the initial load timing of the ad.
// Banner ad - manual initial load mode
let bannerView = DaroAdBannerView(
unit: bannerUnit,
bannerSize: .banner,
autoLoad: false // Disable automatic initial load
)
// Load initial ad at desired time
bannerView.loadAd()
// Banner ad - manual initial load mode
DaroObjCBannerView *bannerView = [[DaroObjCBannerView alloc]
initWithUnitId:bannerUnitId
bannerSize:DaroObjCBannerSizeBanner
autoLoad:NO]; // Disable automatic initial load
// Load initial ad at desired time
[bannerView loadAd];
autoLoad Parameter
true (default): Automatically loads initial ad when view is createdfalse: Initial ad loads when loadAd() is manually called
Manual initial load is useful in the following cases:
- When you want to display the ad after a specific user action
- When you want to control ad load timing during screen transitions
- When you want to load the ad after checking network status
Note: Ad refresh after loading is automatically managed by the SDK.
Setting Listeners/Delegates
Swift (Listener)
Objective-C (Delegate)
You can set listeners to monitor ad status changes.bannerView.listener.onAdLoadSuccess = { ad, adInfo in
print("[DARO] Listener Banner Ad loaded: \(ad) \(adInfo)")
}
bannerView.listener.onAdLoadFail = { error in
print("[DARO] Listener Banner Ad failed: \(error)")
}
bannerView.listener.onAdClicked = { adInfo in
print("[DARO] Listener Banner Ad clicked: \(adInfo)")
}
bannerView.listener.onAdImpression = { adInfo in
print("[DARO] Listener Banner Ad impression: \(adInfo)")
}
You can set a delegate to monitor ad status changes.1. Adopt the delegate protocol in your header file:@interface YourViewController () <DaroObjCBannerViewDelegate>
@property (nonatomic, strong) DaroObjCBannerView *bannerView;
@end
// Set delegate
self.bannerView.delegate = self;
// Add to view hierarchy
[self.view addSubview:self.bannerView];
#pragma mark - DaroObjCBannerViewDelegate
- (void)bannerViewDidLoad:(DaroObjCBannerView *)bannerView
adInfo:(DaroObjCAdInfo *)adInfo {
NSLog(@"[DARO] Banner loaded - Unit: %@", adInfo.adUnitId);
}
- (void)bannerView:(DaroObjCBannerView *)bannerView
didFailWithError:(NSError *)error {
NSLog(@"[DARO] Failed to load: %@", error.localizedDescription);
}
- (void)bannerViewDidClick:(DaroObjCBannerView *)bannerView
adInfo:(DaroObjCAdInfo *)adInfo {
NSLog(@"[DARO] Banner clicked");
}
- (void)bannerViewDidRecordImpression:(DaroObjCBannerView *)bannerView
adInfo:(DaroObjCAdInfo *)adInfo {
NSLog(@"[DARO] Banner impression recorded");
}
