v2.0.0版本接口升级说明

接口升级

本次版本升级，对于模板广告API以及媒体渲染广告API进行了全面变更, 集成后请按照最新API文档进行接入。

模板广告

1. 初始化接口变更

此处以开屏模板广告为例，本次变更如下：

代码变更示例：

 /// 2.0.0版本前接口
  _splashView = [[JADSplashView alloc] initWithPlacementID:@"YOUR_PLACEMENT_ID" adSize:CGSizeMake(splashWidth, splashHeight)];



 /// 2.0.0及以上新版本接口
  _splashView = [[JADSplashView alloc] initWithSlotID:@"YOUR_SLOT_ID" adSize:CGSizeMake(splashWidth, splashHeight)];

1. 模板广告接口回调变更

此处以开屏模板广告为例，本次变更如下：

代码示例：

/// 2.0.0版本前接口
- (void)jadSplashViewDidLoad:(JADSplashView *)splashView;
- (void)jadSplashView:(JADSplashView *)splashView didFailWithError:(NSError * __nullable)error;
- (void)jadSplashViewRenderSuccess:(JADSplashView *)splashView;
- (void)jadSplashViewRenderFail:(JADSplashView *)splashView error:(NSError * __nullable)error;
- (void)jadSplashViewWillVisible:(JADSplashView *)splashView;
- (void)jadSplashViewDidClick:(JADSplashView *)splashView;
- (void)jadSplashViewDidClose:(JADSplashView *)splashView;
- (void)jadSplashViewDidCloseOtherController:(JADSplashView *)splashView
                             interactionType:(JADInteractionType)interactionType;


/// 2.0.0及以上新版本接口                           
- (void)jadSplashViewDidLoadSuccess:(JADSplashView *)splashView;
- (void)jadSplashViewDidLoadFailure:(JADSplashView *)splashView error:(NSError *__nullable)error;
- (void)jadSplashViewDidRenderSuccess:(JADSplashView *)splashView;
- (void)jadSplashViewDidRenderFailure:(JADSplashView *)splashView error:(NSError *__nullable)error;
- (void)jadSplashViewDidExposure:(JADSplashView *)splashView;
- (void)jadSplashViewDidClick:(JADSplashView *)splashView;
- (void)jadSplashViewDidClose:(JADSplashView *)splashView;
- (void)jadSplashViewDidCloseOtherController:(JADSplashView *)splashView
                             interactionType:(JADInteractionType)interactionType;

媒体渲染广告

1. 初始化方法接口变更 示例代码：

/// 2.0.0版本前接口
// 创建 adSlot 对象
JADNativeAdSlot *slot = [[JADNativeAdSlot alloc] init];
slot.adID = @"YOUR_AD_ID";
slot.adType = JADAdSlotAdTypeSplash;
slot.imgSize = imgSize;
slot.skipTime = 5;
slot.eventInteractionType = JADEventInteractionTypeShake;

// 创建 nativeAd 对象
self.nativeAd = [[JADNativeAd alloc] initWithSlot:slot];
self.nativeAd.rootViewController = self;
self.nativeAd.delegate = self;



 /// 2.0.0及以上新版本接口
 // 创建 adSlot 对象
JADNativeAdSlot *slot = [[JADNativeAdSlot alloc] init];
slot.slotID = @"YOUR_SLOT_ID";
slot.type = JADSlotTypeSplash;
slot.imgSize = imgSize;
slot.skipTime = 5;
slot.eventInteractionType = JADEventInteractionTypeShake;

// 创建 nativeAd 对象
self.nativeAd = [[JADNativeAd alloc] initWithSlot:slot];
self.nativeAd.rootViewController = self;
self.nativeAd.delegate = self;

1. 广告位对象属性废弃

媒体渲染广告JADNativeAdSlot对象原有属性fetchDelay进行废弃，请使用skipTime

1. 回调接口变更

代码示例：

 /// 2.0.0版本前接口
 - (void)jadNativeAdDidLoad:(JADNativeAd *)nativeAd;
 - (void)jadNativeAd:(JADNativeAd *)nativeAd didFailWithError:(NSError *__nullable)error;
 - (void)jadNativeAdDidBecomeVisible:(JADNativeAd *)nativeAd;
 - (void)jadNativeAdDidClick:(JADNativeAd *)nativeAd withView:(UIView *_Nullable)view;
 - (void)jadNativeAdDidClose:(JADNativeAd *)nativeAd withView:(UIView *_Nullable)view;
 - (void)jadNativeAdDidCloseOtherController:(JADNativeAd *)nativeAd
                           interactionType:(JADInteractionType)interactionType;
- (void)jadNativeAdForSplash:(JADNativeAd *)nativeAd countDown:(int)countDown;


 /// 2.0.0及以上新版本接口
- (void)jadNativeAdDidLoadSuccess:(JADNativeAd *)nativeAd;
- (void)jadNativeAdDidLoadFailure:(JADNativeAd *)nativeAd error:(NSError *__nullable)error;
- (void)jadNativeAdDidExposure:(JADNativeAd *)nativeAd;
- (void)jadNativeAdDidClick:(JADNativeAd *)nativeAd withView:(UIView *_Nullable)view;
- (void)jadNativeAdDidClose:(JADNativeAd *)nativeAd withView:(UIView *_Nullable)view;
- (void)jadNativeAdDidCloseOtherController:(JADNativeAd *)nativeAd
                           interactionType:(JADInteractionType)interactionType;
 - (void)jadNativeAdForSplash:(JADNativeAd *)nativeAd countDown:(int)countDown;

枚举定义变更

1. 媒体渲染枚举 广告类型JADAdSlotAdType

/// 2.0.0版本前
typedef NS_ENUM(NSUInteger, JADAdSlotAdType) {
    JADAdSlotAdTypeUnknown       = 0,
    JADAdSlotAdTypeSplash        = 1,    // splash ads
    JADAdSlotAdTypeFeed          = 2,    // feed ads
    JADAdSlotAdTypeFeedVideo     = 3,    // feed video ads
    JADAdSlotAdTypeInterstitial  = 4,    // interstitial ads
    JADAdSlotAdTypeBanner        = 5,    // banner ads
    JADAdSlotAdTypeRewardedVideo = 6,    // rewarded video ads
};

本次进行了变更，如下：

 /// 2.0.0及以上新版本
typedef NS_ENUM(NSUInteger, JADSlotType) {
    JADSlotTypeUnknown = 0,         /// 未知类型 unknown
    JADSlotTypeSplash = 1,          /// 开屏广告 splash ads
    JADSlotTypeFeed = 2,            /// 信息流图文广告 feed ads
    JADSlotTypeFeedVideo = 3,       /// 信息流视频广告 feed video ads
    JADSlotTypeInterstitial = 4,    /// 插屏广告 interstitial ads
    JADSlotTypeBanner = 5,          /// 横幅广告 banner ads
    JADSlotTypeRewardedVideo = 6,   /// 奖励视频广告 rewarded video ads
};