本文档列出了自定义广告平台所有支持的广告类型的广告回传事件 API,您可以根据不同的广告类型,在对应的Delegate
类中(例如 Demo 中DemoCustomRewardVideoDelegate
)调用它们进行回传。
@class ATCustomNetworkNativeAd;
// MARK: - 基础广告事件协议(所有广告类型通用)
@protocol ATBaseTrackProtocol <NSObject>
/// 广告数据加载完成(广告素材准备就绪,可以展示)
- (void)atOnAdMetaLoadFinish:(NSDictionary * _Nullable)adExtra;
/// 广告加载失败
- (void)atOnAdLoadFailed:(NSError *)error adExtra:(NSDictionary * _Nullable)adExtra;
/// 广告展示成功
- (void)atOnAdShow:(NSDictionary *_Nullable)adExtra;
/// 广告展示失败
- (void)atOnAdShowFailed:(NSError *)error extra:(NSDictionary *_Nullable)extraDic;
/// 广告被用户点击
- (void)atOnAdClick:(NSDictionary *_Nullable)adExtra;
/// 广告即将关闭
- (void)atOnAdWillClosed:(NSDictionary *_Nullable)extra;
/// 广告已关闭
- (void)atOnAdClosed:(NSDictionary *_Nullable)extra;
/// 广告详情页即将展现
- (void)atOnAdDetailWillShow:(NSDictionary *_Nullable)extra;
/// 广告详情页已关闭(
- (void)atOnAdDetailClosed:(NSDictionary *_Nullable)extra;
/// 广告Deeplink跳转结果
- (void)atOnAdDeeplinkOrJumpResult:(BOOL)success;
/// 广告视频开始播放
- (void)atOnAdVideoStart:(NSDictionary *_Nullable)extra;
/// 广告视频播放结束
- (void)atOnAdVideoEnd:(NSDictionary *_Nullable)extra;
/// 广告视频播放失败(
- (void)atOnAdDidFailToPlayVideo:(NSError*)error extra:(NSDictionary *_Nullable)extraDic;
/// 广告收益回调
- (void)atOnAdDidRevenue:(NSDictionary *_Nullable)extraDic;
@end
// MARK: - 开屏广告事件协议
@protocol ATSplashTrackProtocol <ATBaseTrackProtocol>
/// 开屏广告加载成功
- (void)atOnSplashAdLoadedExtra:(NSDictionary * _Nullable)adExtra;
/// 开屏广告倒计时更新
- (void)atOnSplashAdCountdownTime:(NSInteger)countdown;
/// 开屏广告开始倒计时
- (void)atOnSplashAdStartCountdown:(NSDictionary *)localInfo countdownBlock:(void(^)(NSInteger time))block;
/// 开屏广告缩放视图被点击
- (void)atOnSplashAdZoomOutViewClick;
/// 开屏广告缩放视图已关闭
- (void)atOnSplashAdZoomOutViewClosed;
@end
// MARK: - 激励视频广告事件协议
@protocol ATRewardedTrackProtocol <ATBaseTrackProtocol>
/// 激励视频广告加载成功
- (void)atOnRewardedAdLoadedExtra:(NSDictionary * _Nullable)adExtra;
/// 激励视频用户获得奖励
- (void)atOnRewardedVideoAdRewarded;
/// 获取是否已发放奖励的状态
- (BOOL)getRewardGranted;
/// 激励视频奖励发放失败
- (void)atOnRewardedVideoAdRewardedFailWithExtra:(NSDictionary * _Nullable)adExtra;
@end
// MARK: - 原生广告事件协议
@protocol ATNativeTrackProtocol <ATBaseTrackProtocol>
/// 原生广告加载成功
- (void)atOnNativeAdLoadedArray:(NSArray <ATCustomNetworkNativeAd *>*)nativeObjectArray adExtra:(NSDictionary *_Nullable)adExtra;
/// 原生广告进入全屏视频模式
- (void)atOnNativeAdDidEnterFullScreenVideoInAdViewWithAdExtra:(NSDictionary *_Nullable)adExtra;
/// 原生广告退出全屏视频模式
- (void)atOnNativeAdDidExitFullScreenVideoInAdViewWithAdExtra:(NSDictionary *_Nullable)adExtra;
@end
// MARK: - 横幅广告事件协议
@protocol ATBannerTrackProtocol <ATBaseTrackProtocol>
/// 横幅广告加载成功
- (void)atOnBannerAdLoadedWithView:(UIView * _Nullable)bannerView adExtra:(NSDictionary * _Nullable)adExtra;
@end
// MARK: - 插屏广告事件协议
@protocol ATInterstitialTrackProtocol <ATBaseTrackProtocol>
/// 插屏广告加载成功
- (void)atOnInterstitialAdLoadedExtra:(NSDictionary * _Nullable)adExtra;
@end