激励视频广告
在 iOS 应用中集成 CloudX 激励视频广告
@interface YourViewController () <CLXRewardedDelegate, CLXAdRevenueDelegate>
@property (nonatomic, strong) CLXRewarded *rewardedAd;
@property (nonatomic, assign) NSInteger retryAttempt;
@end
@implementation YourViewController
- (void)createRewardedAd {
self.rewardedAd = [[CloudXCore shared] createRewardedWithAdUnitId:@"your-rewarded-ad-unit-id"];
self.rewardedAd.delegate = self;
self.rewardedAd.revenueDelegate = self;
[self.rewardedAd load];
}
- (void)showRewardedAd {
if (self.rewardedAd.isReady) {
// 基本展示
[self.rewardedAd showFromViewController:self];
// 或使用可选的展示位置和自定义数据进行追踪
// [self.rewardedAd showFromViewController:self placement:@"bonus_coins" customData:@"level:5,coins:100"];
} else {
NSLog(@"激励视频广告尚未准备好");
}
}
- (void)dealloc {
[self.rewardedAd destroy];
}
#pragma mark - CLXRewardedDelegate
- (void)didLoadAd:(CLXAd *)ad {
NSLog(@"激励视频广告从 %@ 加载成功", ad.networkName);
self.retryAttempt = 0;
}
- (void)didFailToLoadAd:(NSString *)adUnitId error:(CLXError *)error {
NSLog(@"激励视频广告加载失败: %@", error.localizedDescription);
self.retryAttempt++;
NSTimeInterval delay = pow(2.0, MIN(5, self.retryAttempt));
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(delay * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
[self.rewardedAd load];
});
}
- (void)didDisplayAd:(CLXAd *)ad {
NSLog(@"激励视频广告已展示");
}
- (void)didFailToDisplayAd:(CLXAd *)ad error:(CLXError *)error {
NSLog(@"激励视频广告展示失败: %@", error.localizedDescription);
[self.rewardedAd load];
}
- (void)didHideAd:(CLXAd *)ad {
NSLog(@"激励广告已隐藏");
[self.rewardedAd load]; // 为下次使用重新加载
}
- (void)didClickAd:(CLXAd *)ad {
NSLog(@"激励视频广告被点击");
}
- (void)didRewardUserForAd:(CLXAd *)ad withReward:(CLXReward *)reward {
NSLog(@"用户获得奖励: %ld %@", (long)reward.amount, reward.label);
// 向用户发放奖励
}
#pragma mark - CLXAdRevenueDelegate
- (void)didPayRevenueForAd:(CLXAd *)ad {
NSLog(@"激励视频广告收入: %@ 来自 %@", ad.revenue, ad.networkName);
}
@endclass YourViewController: UIViewController, CLXRewardedDelegate, CLXAdRevenueDelegate {
private var rewardedAd: CLXRewarded?
private var retryAttempt = 0
func createRewardedAd() {
rewardedAd = CloudXCore.shared.createRewarded(adUnitId: "your-rewarded-ad-unit-id")
rewardedAd?.delegate = self
rewardedAd?.revenueDelegate = self
rewardedAd?.load()
}
func showRewardedAd() {
if rewardedAd?.isReady == true {
// 基本展示
rewardedAd?.show(from: self)
// 或使用可选的展示位置和自定义数据进行追踪
// rewardedAd?.show(from: self, placement: "bonus_coins", customData: "level:5,coins:100")
} else {
print("激励视频广告尚未准备好")
}
}
deinit {
rewardedAd?.destroy()
}
// MARK: - CLXRewardedDelegate
func didLoad(_ ad: CLXAd) {
print("激励视频广告从 \(ad.networkName ?? "unknown") 加载成功")
retryAttempt = 0
}
func didFailToLoadAd(_ adUnitId: String, error: CLXError) {
print("激励视频广告加载失败: \(error.localizedDescription)")
retryAttempt += 1
let delay = pow(2.0, Double(min(5, retryAttempt)))
DispatchQueue.main.asyncAfter(deadline: .now() + delay) { [weak self] in
self?.rewardedAd?.load()
}
}
func didDisplay(_ ad: CLXAd) {
print("激励视频广告已展示")
}
func didFailToDisplay(_ ad: CLXAd, error: CLXError) {
print("激励视频广告展示失败: \(error.localizedDescription)")
rewardedAd?.load()
}
func didHide(_ ad: CLXAd) {
print("激励广告已隐藏")
rewardedAd?.load() // 为下次使用重新加载
}
func didClick(_ ad: CLXAd) {
print("激励视频广告被点击")
}
func didRewardUser(for ad: CLXAd, with reward: CLXReward) {
print("用户获得奖励: \(reward.amount) \(reward.label)")
// 为用户发放奖励
}
// MARK: - CLXAdRevenueDelegate
func didPayRevenue(for ad: CLXAd) {
print("激励视频广告收入: \(ad.revenue ?? 0) 来自 \(ad.networkName ?? "unknown")")
}
}广告就绪状态
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.rewardedAd.expirationDelegate = self;
- (void)didReloadExpiredAd:(CLXAd *)expiredAd withNewAd:(CLXAd *)newAd {
NSLog(@"Expired rewarded ad replaced by an ad from %@", newAd.networkName);
}// Add CLXAdExpirationDelegate to the protocols YourViewController adopts
rewardedAd?.expirationDelegate = self
func didReloadExpiredAd(_ expiredAd: CLXAd, with newAd: CLXAd) {
print("Expired rewarded ad replaced by an ad from \(newAd.networkName ?? "unknown")")
}