ATAdLoadingDelegate

广告的基础代理回调声明，包括广告位与广告源级别的加载成功或失败回调，以及竞价广告源的竞价结束与竞价失败回调。其中@optional下方的方法为可选项。

 

关于部分代理方法中的extra参数，您可以点击这里查看详情。

关于广告源和广告位的解释：

一个广告位可以配置多个广告源，因此单次加载操作（load）时，可能会收到多次广告源（ADSource）回调。所有广告源加载结束事件通过广告位回调didFinishLoadingADWithPlacementID:或didFailToLoadADWithPlacementID:error:来接收。

@protocol ATAdLoadingDelegate<NSObject>

 
/// 成功加载广告时的回调
/// - Parameter placementID: 广告位ID
- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID;

/// 加载广告失败时的回调
/// - Parameter placementID: 广告位ID
/// - Parameter error: 含错误信息的对象
- (void)didFailToLoadADWithPlacementID:(NSString*)placementID
                                 error:(NSError*)error;

@optional

/// 获取展示收益
/// - Parameters:
///   - placementID: 广告位ID
///   - extra: 额外参数，用于开发者接收获取信息
- (void)didRevenueForPlacementID:(NSString *)placementID
                              extra:(NSDictionary *)extra;

/// 对应广告位中某一个广告源开始加载广告的回调
/// - Parameter placementID: 广告位ID
/// - Parameter extra: 广告源的具体信息
- (void)didStartLoadingADSourceWithPlacementID:(NSString *)placementID
                                         extra:(NSDictionary*)extra;
/// 对应广告位中某一个广告源加载广告成功的回调
/// - Parameter placementID: 广告位ID
/// - Parameter extra: 广告源的具体信息
- (void)didFinishLoadingADSourceWithPlacementID:(NSString *)placementID
                                          extra:(NSDictionary*)extra;

/// 对应广告位中某一个广告源加载广告失败的回调
/// - Parameter placementID: 广告位ID
/// - Parameter extra: 广告源的具体信息
/// - Parameter error: 含错误信息的对象
- (void)didFailToLoadADSourceWithPlacementID:(NSString*)placementID
                                       extra:(NSDictionary*)extra
                                       error:(NSError*)error;

/// 对应广告位中某一个广告源竞价广告开始竞价的回调
/// - Parameter placementID: 广告位ID
/// - Parameter extra: 广告源的具体信息
- (void)didStartBiddingADSourceWithPlacementID:(NSString *)placementID
                                         extra:(NSDictionary*)extra;

/// 对应广告位中某一个广告源竞价广告竞价成功的回调
/// - Parameter placementID: 广告位ID
/// - Parameter extra: 广告源的具体信息
- (void)didFinishBiddingADSourceWithPlacementID:(NSString *)placementID
                                          extra:(NSDictionary*)extra;

/// 对应广告位中某一个广告源竞价广告竞价失败的回调
/// - Parameter placementID: 广告位ID
/// - Parameter extra: 广告源的具体信息
/// - Parameter error: 含错误信息的对象
- (void)didFailBiddingADSourceWithPlacementID:(NSString*)placementID
                                        extra:(NSDictionary*)extra
                                        error:(NSError*)error;

@end