App Open 广告
在 iOS 应用中集成 CloudX App Open 广告
App Open 广告是全屏广告位,适用于应用回到前台等场景,例如用户将应用切到后台后再次返回。
支持的网络
App Open 需求由以下竞价网络提供:
Google Mobile Ads 瀑布流适配器 同样支持 App Open 广告位,用于 AdMob 瀑布流需求。
@interface YourViewController () <CLXAppOpenDelegate, CLXAdRevenueDelegate>
@property (nonatomic, strong) CLXAppOpen *appOpenAd;
@end
@implementation YourViewController
- (void)createAppOpenAd {
self.appOpenAd = [[CloudXCore shared] createAppOpenWithAdUnitId:@"your-app-open-ad-unit-id"];
self.appOpenAd.delegate = self;
self.appOpenAd.revenueDelegate = self;
[self.appOpenAd load];
}
- (void)showAppOpenAd {
if (self.appOpenAd.isReady) {
[self.appOpenAd showFromViewController:self];
} else {
NSLog(@"App Open ad not ready");
}
}
- (void)dealloc {
[self.appOpenAd destroy];
}
#pragma mark - CLXAppOpenDelegate
- (void)didLoadAd:(CLXAd *)ad {
NSLog(@"App Open ad loaded from %@", ad.networkName);
}
- (void)didFailToLoadAd:(NSString *)adUnitId error:(CLXError *)error {
NSLog(@"App Open ad failed to load: %@", error.localizedDescription);
}
- (void)didDisplayAd:(CLXAd *)ad {
NSLog(@"App Open ad displayed");
}
- (void)didFailToDisplayAd:(CLXAd *)ad error:(CLXError *)error {
NSLog(@"App Open ad failed to display: %@", error.localizedDescription);
[self.appOpenAd load];
}
- (void)didHideAd:(CLXAd *)ad {
NSLog(@"App Open ad hidden");
[self.appOpenAd load]; // Reload for next use
}
- (void)didClickAd:(CLXAd *)ad {
NSLog(@"App Open ad clicked");
}
#pragma mark - CLXAdRevenueDelegate
- (void)didPayRevenueForAd:(CLXAd *)ad {
NSLog(@"App Open revenue: %@ from %@", ad.revenue, ad.networkName);
}
@endclass YourViewController: UIViewController, CLXAppOpenDelegate, CLXAdRevenueDelegate {
private var appOpenAd: CLXAppOpen?
func createAppOpenAd() {
appOpenAd = CloudXCore.shared.createAppOpen(adUnitId: "your-app-open-ad-unit-id")
appOpenAd?.delegate = self
appOpenAd?.revenueDelegate = self
appOpenAd?.load()
}
func showAppOpenAd() {
if appOpenAd?.isReady == true {
appOpenAd?.show(from: self)
} else {
print("App Open ad not ready")
}
}
deinit {
appOpenAd?.destroy()
}
// MARK: - CLXAppOpenDelegate
func didLoad(_ ad: CLXAd) {
print("App Open ad loaded from \(ad.networkName ?? "unknown")")
}
func didFailToLoadAd(_ adUnitId: String, error: CLXError) {
print("App Open ad failed to load: \(error.localizedDescription)")
}
func didDisplay(_ ad: CLXAd) {
print("App Open ad displayed")
}
func didFailToDisplay(_ ad: CLXAd, error: CLXError) {
print("App Open ad failed to display: \(error.localizedDescription)")
appOpenAd?.load()
}
func didHide(_ ad: CLXAd) {
print("App Open ad hidden")
appOpenAd?.load() // Reload for next use
}
func didClick(_ ad: CLXAd) {
print("App Open ad clicked")
}
// MARK: - CLXAdRevenueDelegate
func didPayRevenue(for ad: CLXAd) {
print("App Open revenue: \(ad.revenue ?? 0) from \(ad.networkName ?? "unknown")")
}
}请谨慎使用 App Open 广告,仅在自然的应用打开或恢复前台的时机展示。当用户正在与应用内容交互时,请避免展示。
广告就绪状态
isReady 从广告加载完成起保持为 true,直到您展示该广告或销毁广告对象。广告网络可能在未通知 SDK 的情况下无法再展示某个广告。此时 isReady 仍为 true,该问题会在您调用 showFromViewController:(Swift 为 show(from:))时被发现。如果广告网络确实报告其广告已过期,广告将不再就绪。
- 如果展示广告网络已无法展示的广告,会触发
didFailToDisplayAd:error:(Swift 为didFailToDisplay(_:error:)),广告不再就绪。请调用load获取新广告。 - 在这种情况下,如果 CloudX 已为您的应用和广告单元启用展示恢复,SDK 会加载并展示一个替换广告。您会收到替换广告的展示和收益回调,不会收到
didFailToDisplayAd:error:。如果过期广告的替换广告已在加载中,SDK 会使用它,并在展示前触发didReloadExpiredAd:withNewAd:(Swift 为didReloadExpiredAd(_:with:))。如果替换广告加载失败,或未能在 CloudX 设定的时限内就绪,会触发didFailToDisplayAd:error:。 - 如果在广告已就绪时调用
load,不会发起新请求,并会立即以该广告触发didLoadAd:(Swift 为didLoad(_:))。 - 在广告展示期间调用
load,会在广告关闭后执行。在展示等待恢复替换广告期间调用load,同样会在展示结束后执行,并且只会收到一次didLoadAd:或didFailToLoadAd:error:。
过期广告
已加载但在过期前未展示的广告,会在同一广告对象上自动重新加载。在替换广告就绪之前,当前广告保持就绪状态,仍可展示。
- 如需在替换广告就绪时收到通知,请设置
expirationDelegate。自动加载完成的替换广告不会再次触发didLoadAd:(Swift 为didLoad(_:))。 - 如果在替换广告加载期间展示广告,替换广告会被保留。如果广告关闭时替换广告已就绪,或在其就绪前没有调用
load,替换广告会在广告对象上变为就绪,届时会调用expirationDelegate。如果在广告关闭后、替换广告仍在加载时调用load,该load会发起自己的请求并收到didLoadAd:,之后不会再针对该替换广告调用expirationDelegate。 - 如果在过期广告仍处于已加载状态时调用
load,不会发起新请求,并会立即以该过期广告触发didLoadAd:。替换广告会继续加载,就绪时会调用didReloadExpiredAd:withNewAd:(Swift 为didReloadExpiredAd(_:with:))。 - 如果在过期广告仍处于已加载状态时替换广告加载失败,会触发
didFailToLoadAd:error:(Swift 为didFailToLoadAd(_:error:)),广告不再就绪。重新加载及其重试由 CloudX 按广告单元配置,且默认不重试,因此一次无填充就会在此结束。这是正常结果,并非集成错误:请在延迟一段时间后再次调用load,避免立即循环重试。
// Add CLXAdExpirationDelegate to the protocols YourViewController adopts
self.appOpenAd.expirationDelegate = self;
- (void)didReloadExpiredAd:(CLXAd *)expiredAd withNewAd:(CLXAd *)newAd {
NSLog(@"Expired App Open ad replaced by an ad from %@", newAd.networkName);
}// Add CLXAdExpirationDelegate to the protocols YourViewController adopts
appOpenAd?.expirationDelegate = self
func didReloadExpiredAd(_ expiredAd: CLXAd, with newAd: CLXAd) {
print("Expired App Open ad replaced by an ad from \(newAd.networkName ?? "unknown")")
}