菜单

广告事件回传接口列表

本文档列出了自定义广告平台所有支持的广告类型的广告回传事件 API,您可以根据不同的广告类型,在对应的Delegate类中(例如 Demo 中DemoCustomRewardVideoDelegate)调用它们进行回传。

objc 复制代码
@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
最近修改: 2025-09-23Powered by