属性

说明

@property (nonatomic, weak, nullable) id<BUSplashAdDelegate> delegate;

开屏相关代理

@property (nonatomic, weak, nullable) id<BUSplashZoomOutDelegate> zoomOutDelegate;

开屏点睛相关代理

@property (nonatomic, assign) BOOL supportZoomOutView;

是否支持点睛

@property (nonatomic, assign) BOOL supportCardView;

是否支持卡片

@property (nonatomic, assign) BOOL hideSkipButton;

是否隐藏跳过按钮

@property (nonatomic, assign) NSTimeInterval tolerateTimeout;

广告加载超时时间

@property (nonatomic, copy, readonly, nonnull) NSString *slotID;

slotID

mediaExt@property (nonatomic, copy, readonly) NSDictionary *mediaExt;

mediaExt

@property (nonatomic, weak, readonly, nullable) UIViewController *splashRootViewController;

开屏视图控制器

@property (nonatomic, strong, readonly, nullable) BUSplashView *splashView;

开屏视图

@property (nonatomic, strong, readonly, nullable) BUSplashCardView *cardView;

卡片视图

@property (nonatomic, strong, readonly, nullable) BUSplashZoomOutView *zoomOutView;

点睛视图

@property (nonatomic, strong, readonly, nullable) UIView *splashViewSnapshot;

开屏最后一帧

方法

说明

- (instancetype)initWithSlotID:(NSString *)slotID adSize:(CGSize)adSize;

初始化方法

- (instancetype)initWithSlot:(BUAdSlot *)slot adSize:(CGSize)adSize;

初始化方法

- (void)loadAdData;

加载广告

- (void)showSplashViewInRootViewController:(UIViewController *)viewController;

展示开屏视图

- (void)showCardViewInRootViewController:(UIViewController *)viewController;

展示开屏联动卡片视图

- (void)showZoomOutViewInRootViewController:(UIViewController *)viewController;

展示开屏点睛视图

- (void)removeSplashView;

自定义跳过按钮场景，移除开屏视图

- (NSString *)getAdCreativeToken;

属性

说明

@property (nonatomic, weak, nullable) id<BUSplashAdDelegate> delegate;

开屏相关代理

@property (nonatomic, getter=isAdValid, readonly) BOOL adValid;

是否展示

@property (nonatomic, assign) BOOL needSplashZoomOutAd;

是否支持点睛；3600版本开始，开发者不需要设置此方法，是否展示点睛样式通过穿山甲平台进行设置。

@property (nonatomic, assign) BOOL hideSkipButton;

是否隐藏跳过按钮

@property (nonatomic, assign) NSTimeInterval tolerateTimeout;

广告加载超时时间

@property (nonatomic, copy, readonly, nonnull) NSString *slotID;

slotID

mediaExt@property (nonatomic, copy, readonly) NSDictionary *mediaExt;

mediaExt

@property (nonatomic, strong, readonly, nullable) BUSplashZoomOutView *zoomOutView;

点睛视图

方法

说明

- (instancetype)initWithSlotID:(NSString *)slotID frame:(CGRect)frame;

初始化方法

- (instancetype)initWithSlot:(BUAdSlot *)slot adSize:(CGSize)adSize;

初始化方法

- (void)loadAdData;

加载广告

- (void)removeSplashView;

自定义跳过按钮场景，移除开屏视图

- (NSString *)getAdCreativeToken;

时机

方法

说明

广告物料、素材加载成功

- (void)splashAdLoadSuccess:(BUSplashAd *)splashAd;

物料加载成功，可以在这个回调中调用show方法展示开屏

广告物料、素材加载失败

- (void)splashAdLoadFail:(BUSplashAd *)splashAd error:(BUAdError *)error;

物料加载失败，不会展示开屏，提供如下错误码：

typedef NS_ENUM(NSInteger, BUSplashAdLoadError) {

BUSplashAdLoadError_UnKnow= 0, //未知错误

BUSplashAdLoadError_DataError = 1, // 数据加载失败

BUSplashAdLoadError_TimeOut = 2, // 超时

};

广告渲染成功

- (void)splashAdRenderSuccess:(BUSplashAd *)splashAd;

load方法调用后，若渲染成功则返回该回调；show方法调用后开屏视图会被添加到ViewController上。

广告渲染失败

- (void)splashAdRenderFail:(BUSplashAd *)splashAd error:(BUAdError *)error;

load方法调用后，若渲染失败则返回该回调；即使调用show方法开屏视图也不会被添加到ViewController上，提供如下错误码：

typedef NS_ENUM(NSInteger, BUSplashAdErrorCode) { CSJSplashAdError_Unknow = 0, CSJSplashAdError_LoadFailed = 1, // 物料加载失败 CSJSplashAdError_ResourceFailed = 2, // 素材加载失败 CSJSplashAdError_RenderFailed = 3, // 渲染失败 CSJSplashAdError_TimeOut = 23 // 超时

};

广告即将展示

- (void)splashAdWillShow:(BUSplashAd * )splashAd;

广告展示

- (void)splashAdDidShow:(BUSplashAd * )splashAd;

注意：该回调时机和show埋点上报时机一致

广告视图关闭

- (void)splashAdDidClose:(BUSplashAd * )splashAd closeType:(BUSplashAdCloseType)closeType；

广告视图会在以下场景关闭：

1、开屏未转化关闭（点击跳过、倒计时结束），通知开发者开屏视图已经关闭

2、 开屏转化后内开调起市场页，市场页关闭时通知开发者开屏视图已经关闭

3、开屏转化其他场景，点击广告后通知开发者开屏视图已经关闭

其他说明：

1、广告视图关闭后由SDK移除开屏视图

2、closeType标记从哪种场景关闭

广告视图控制器关闭

- (void)splashAdViewControllerDidClose:(BUSplashAd *)splashAd;

如果采用自定义视图控制器展示广告，广告视图控制器会在以下场景关闭：

1、开屏未转化关闭（点击跳过、倒计时结束），通知开发者关闭视图控制器

2、开屏转化后内跳，中间页、市场页关闭时，通知开发者关闭视图控制器

3、开屏转化外跳，即将跳转时，通知开发者关闭视图控制器

广告点击

- (void)splashAdDidClick:(BUSplashAd * )splashAd;

广告中间页、市场页面关闭

- (void)splashDidCloseOtherController:(BUSplashAd *)splashAd interactionType:(BUInteractionType)interactionType;

此回调在广告跳转到其他控制器时，该控制器被关闭时调用。

interactionType：此参数可区分是打开的appstore/网页/视频广告详情页面

视频广告播放完毕

- (void)splashVideoAdDidPlayFinish:(BUSplashAd *)splashAd didFailWithError:(NSError *)error;

时机

方法

说明

点睛即将展示

- (void)splashZoomOutReadyToShow:(BUSplashAd *)splashAd;

点睛此时可以展示

点睛点击

- (void)splashZoomOutViewDidClick:(BUSplashAd *)splashAd;

点睛广告被点击

点睛关闭

- (void)splashZoomOutViewDidClose:(BUSplashAd *)splashAd;

点睛被关闭

时机

方法

说明

广告物料、素材加载成功

- (void)splashAdDidLoad:(BUSplashAdView *)splashAd;

物料加载成功，可以在这个回调中展示开屏

广告物料、素材加载失败

- (void)splashAd:(BUSplashAdView *)splashAd didFailWithError:(NSError * _Nullable)error;

返回的错误码(error)表示广告加载失败的原因，所有错误码详情请见链接Link

广告即将展示

- (void)splashAdWillVisible:(BUSplashAdView *)splashAd;

广告关闭

- (void)splashAdDidClose:(BUSplashAdView *)splashAd;

当用户点击广告时会直接触发此回调，建议在此回调方法中直接进行广告对象的移除操作

广告j即将关闭

- (void)splashAdWillClose:(BUSplashAdView *)splashAd;

广告点击

- (void)splashAdDidClick:(BUSplashAdView *)splashAd;

广告中间页、市场页面关闭

- (void)splashAdDidCloseOtherController:(BUSplashAdView *)splashAd interactionType:(BUInteractionType)interactionType;

此回调在广告跳转到其他控制器时，该控制器被关闭时调用。

interactionType：此参数可区分是打开的appstore/网页/视频广告详情页面