激励视频广告

在 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);
}

@end

广告就绪状态

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);
}