激励视频

1. 主要开发工作说明

1. 创建一个自定义RewardedVideo Adapter类，可继承NSObject，并遵循ATAdAdapter协议，建议以RewardedVideoAdapter结尾，类名需要配置到Taku后台的自定义广告平台；

2. 自定义adapter类必须实现方法说明如下：

• 当SDK需要请求到配置自定义广告源时，会调用方法initWithNetworkCustomInfo:实例化adapter对象；
• 请求自定义广告源广告会触发adapter的loadADWithInfo:方法调用；
• 当需要判断自定义广告源广告是否已经填充，会触发adReadyWithCustomObject:方法调用；
• 当需要展示自定义广告源广告的时候，会触发showRewardedVideo:方法调用。

具体方法说明如下：

3. 回调方法说明如下： 需要自定义实现一个xxxCustomEvent类，继承ATRewardedVideoCustomEvent类，并通过这个类添加自定义广告平台对应的回调代理，当广告平台有回调时，将对应事件调用ATRewardedVideoCustomEvent的方法回传给Taku SDK。

具体回调方法说明如下：

2. 具体集成说明及示例

2.1 实现广告加载的Adapter类

1. 创建一个自定义RewardedVideo Adapter类，可继承NSObject，建议以RewardedVideoAdapter结尾，类名需要配置到Taku后台的自定义广告平台；

2.自定义adapter类必须实现方法如下：

•实现initWithNetworkCustomInfo:实例化adapter对象，可以在这里进行广告SDK的相关初始化；

•实现广告加载时调用的loadADWithInfo:方法，触发广告SDK的广告请求；

•实现adReadyWithCustomObject:方法，用于告知Taku SDK当前是否有广告填充；

•实现showRewardedVideo:方法，当Taku SDK触发广告展示时，会调用此方法触发广告SDK的广告展示逻辑。

以下是集成示例，具体项目可参考 Demo 中 CustomAdapter中 的示例代码：

创建并实现TTRewardedVideoCustomAdapter类：

//TouTiaoRewardedVideoAdapter.h

#import <AnyThinkRewardedVideo/AnyThinkRewardedVideo.h>
@interface TTRewardedVideoCustomAdapter : NSObject 
@property (nonatomic,copy) void (^metaDataDidLoadedBlock)(void); 
@end

//TouTiaoRewardedVideoAdapter.m
#import <AnyThinkRewardedVideo/AnyThinkRewardedVideo.h>

@interface TTRewardedVideoCustomAdapter()
@property(nonatomic, readonly) TouTiaoRewardedVideoCustomEvent *customEvent;
@end

@implementation TTRewardedVideoCustomAdapter

/// Adapter initialization method
/// - Parameters:
///   - serverInfo: Data from the server
///   - localInfo: Data from the local
-(instancetype) initWithNetworkCustomInfo:(NSDictionary*)serverInfo localInfo:(NSDictionary*)localInfo {
    self = [super init];
    if (self != nil) {
    //TODO: add some code for initialize Network SDK
    }
    return self;
}

/// Adapter sends a load request, means the ad source sends an ad load request
/// - Parameters:
///   - serverInfo: Data from the server
///   - localInfo: Data from the local
///   - completion: completion
-(void) loadADWithInfo:(NSDictionary*)serverInfo localInfo:(NSDictionary*)localInfo completion:(void (^)(NSArray *, NSError *))completion {
    _customEvent = [[TouTiaoRewardedVideoCustomEvent alloc] initWithInfo:serverInfo localInfo:localInfo];
     //必须赋值
    _customEvent.requestCompletionBlock = completion;

    BURewardedVideoModel *model = [[BURewardedVideoModel alloc] init];
    NSDictionary *extra = localInfo;
    if (extra[kATAdLoadingExtraUserIDKey] != nil) {
        model.userId = extra[kATAdLoadingExtraUserIDKey];
    }
    if (extra[kATAdLoadingExtraMediaExtraKey] != nil) {
        model.extra = extra[kATAdLoadingExtraMediaExtraKey];
    }

    _expressRvAd = [[BUNativeExpressRewardedVideoAd alloc] initWithSlotID:serverInfo[@"slot_id"] rewardedVideoModel:model];
    _expressRvAd.rewardedVideoModel = model;
    _expressRvAd.delegate = _customEvent;
    [_expressRvAd loadAdData];
}

/// Check whether the ad source is ready
/// - Parameters:
///   - customObject: ad source object
///   - info: info
+(BOOL) adReadyWithCustomObject:(id)customObject info:(NSDictionary*)info {
    return ((BUNativeExpressRewardedVideoAd *)customObject).adValid;
}


+(void) showRewardedVideo:(ATRewardedVideo*)rewardedVideo inViewController:(UIViewController*)viewController delegate:(id)delegate {
    TouTiaoRewardedVideoCustomEvent *customEvent = (TouTiaoRewardedVideoCustomEvent*)rewardedVideo.customEvent;
    customEvent.delegate = delegate;
    [((BUNativeExpressRewardedVideoAd *)rewardedVideo.customObject) showAdFromRootViewController:viewController];
}

2.2 实现广告回调的CustomEvent类

   需要自定义实现一个xxxCustomEvent类，继承ATRewardedVideoCustomEvent类，并通过这个类添加自定义广告平台对应的回调代理，当广告平台有回调时，将对应事件调用ATRewardedVideoCustomEvent的方法回传给Taku SDK。

以下是集成示例，具体项目可参考 Demo 中 CustomAdapter中 的示例代码：

创建并实现TouTiaoRewardedVideoCustomEvent类：

@interface TouTiaoRewardedVideoCustomEvent : ATRewardedVideoCustomEvent

@end

- (void)nativeExpressRewardedVideoAdDidLoad:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidLoad:");
    [self trackRewardedVideoAdLoaded:rewardedVideoAd adExtra:nil];
}

- (void)nativeExpressRewardedVideoAd:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd didFailWithError:(NSError *_Nullable)error {
    NSLog(@"%@",[NSString stringWithFormat:@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidLoad:didFailWithError:%@",error]);
    if (!_isFailed) {
        [self trackRewardedVideoAdLoadFailed:error];
        _isFailed = true;
    }
}

- (void)nativeExpressRewardedVideoAdDidDownLoadVideo:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidDownLoadVideo:");
}

- (void)nativeExpressRewardedVideoAdViewRenderSuccess:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdViewRenderSuccess:");
}

- (void)nativeExpressRewardedVideoAdViewRenderFail:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd error:(NSError *_Nullable)error {
    NSLog(@"%@",[NSString stringWithFormat:@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdViewRenderFail:error:%@",error]);
    if (!_isFailed) {
        [self trackRewardedVideoAdLoadFailed:error];
        _isFailed = true;
    }
}

- (void)nativeExpressRewardedVideoAdWillVisible:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdWillVisible:");
}

- (void)nativeExpressRewardedVideoAdDidVisible:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidVisible:");
    [self trackRewardedVideoAdShow];
    [self trackRewardedVideoAdVideoStart];
}

- (void)nativeExpressRewardedVideoAdWillClose:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdWillClose:");
}

- (void)nativeExpressRewardedVideoAdDidClose:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidClose:");
    [self trackRewardedVideoAdCloseRewarded:self.rewardGranted];
}

- (void)nativeExpressRewardedVideoAdDidClick:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidClick:");
    [self trackRewardedVideoAdClick];
}

- (void)nativeExpressRewardedVideoAdDidClickSkip:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidClickSkip:");
}

- (void)nativeExpressRewardedVideoAdDidPlayFinish:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd didFailWithError:(NSError *_Nullable)error {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdDidPlayFinish:didFailWithError:");
    if (error == nil) {
        [self trackRewardedVideoAdVideoEnd];
    } else {
        [self trackRewardedVideoAdPlayEventWithError:error];
    }
}

- (void)nativeExpressRewardedVideoAdServerRewardDidSucceed:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd verify:(BOOL)verify {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdServerRewardDidSucceed:verify:");
    [self trackRewardedVideoAdRewarded];
}

- (void)nativeExpressRewardedVideoAdServerRewardDidFail:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"TouTiaoRewardedVideoCustomEvent::nativeExpressRewardedVideoAdServerRewardDidFail:");
    self.rewardGranted = NO;
}

- (NSString *)networkUnitId {
    return self.serverInfo[@"slot_id"];
}

注意：在给用户下发激励回调前需要设置rewardGranted为YES，用于标识是否已经下发奖励