集成检查清单

本清单旨在帮助您系统性地核查应用集成流程，确保广告SDK的无缝对接与高效运行。

---

一、API 使用检查

• 应用初始化时，务必使用正确的 App Key 和 App ID，并确保各广告格式的广告位ID与TopOn后台配置一致；同时请检查应用Bundle ID与配置匹配
• 检查Info.plist中例如ATT、HTTP的权限配置
• SDK 初始化后，所有广告位应能正常加载并展示广告

---

二、广告样式检查

激励视频广告

• 正确设置 广告位ID
• 实现广告事件Delegate（ATRewardedVideoDelegate）
• 正确调用广告加载方法（loadADWithPlacementID）
• 展示广告前检查广告是否准备就绪（rewardedVideoReadyForPlacementID）
• 正确调用广告展示方法,并设置代理（showRewardedVideoWithPlacementID:config:inViewController:delegate:），避免在- (void)viewWillAppear:(BOOL)animated和- (void)viewWillDisappear:(BOOL)animated中调用展示API
• 正确进行预加载（didFailToLoadADWithPlacementID中必须延迟后发起预加载,详情请见示例 Code ;rewardedVideoDidFailToPlayForPlacementID中不需要延迟; rewardedVideoDidCloseForPlacementID中不需要延迟）
• [可选] 设置广告收益监听（didRevenueForPlacementID）

插屏广告

• 正确设置 广告位ID
• 实现广告事件Delegate（ATInterstitialDelegate）
• 正确调用广告加载方法（loadADWithPlacementID）
• 展示广告前检查广告是否准备就绪（interstitialReadyForPlacementID）
• 正确调用广告展示方法,并设置代理,确保输入参数控制器在广告场景中可以正常 present 出广告（showInterstitialWithPlacementID:showConfig:inViewController:delegate:nativeMixViewBlock:），避免在- (void)viewWillAppear:(BOOL)animated和- (void)viewWillDisappear:(BOOL)animated中调用展示API
• 正确进行预加载（didFailToLoadADWithPlacementID中必须延迟后发起预加载,详情请见示例 Code ;interstitialDidFailToPlayVideoForPlacementID中不需要延迟; interstitialDidCloseForPlacementID中不需要延迟）
• [可选] 设置广告收益监听（didRevenueForPlacementID）

开屏广告

• 正确设置 广告位ID
• 设置广告事件Delegate（ATSplashDelegate）
• 正确调用广告加载方法（loadADWithPlacementID）
• 展示广告前检查广告是否准备就绪（showSplashWithPlacementID:config:window:inViewController:extra:delegate:）
• 正确调用广告展示方法,并设置代理,确保输入参数Window和控制器在广告场景中可以正常 present 出广告（showAdWithWindow:viewController:withExtra:），避免在- (void)viewWillAppear:(BOOL)animated和- (void)viewWillDisappear:(BOOL)animated中调用展示API
• 保证开屏广告展示方法在应用位于前台且活跃状态时才调用(didBecomeActive)
• 正确设置超时时间（kATSplashExtraTolerateTimeoutKey）
• 若有热启动开屏场景，正确进行预加载（splashDidCloseForPlacementID中进行预加载）
• [可选] 设置广告收益监听（didRevenueForPlacementID）

横幅广告

• 正确设置 广告位ID
• 设置广告事件Delegate（ATBannerDelegate）
• 正确设置Banner Size（kATAdLoadingExtraBannerAdSizeKey）
• 正确调用广告加载方法（loadADWithPlacementID）
• 展示广告前检查广告是否准备就绪（bannerAdReadyForPlacementID）
• 正确调用广告展示方法（retrieveBannerViewForPlacementID）
• 正确设置ATBannerView及其容器的可见性，以正确呈现广告
• 正确设置ATBannerView的代理delegate，及其presentingViewController
• [可选] 设置广告收益监听（revenueDelegate）
• 自动刷新功能配置：[Taku 后台 > 应用管理 > 选择目标应用 > 进入目标横幅广告位 > 高级设置]
• 临时不展示时可以设置横幅对象的isHidden，永久不展示时需要销毁destroyBanner

原生自渲染广告

• 正确设置 广告位ID
• 设置广告事件Delegate（ATNativeADDelegate）
• 正确调用广告加载方法（loadADWithPlacementID）
• 通过ATNativeADConfiguration来进行展示前的配置
• 通过getNativeAdOfferWithPlacementID正确创建ATNativeAdOffer，并且判空后使用
• 自渲染广告：创建自渲染视图view，同时根据ATNativeAdOffer中的信息内容去给组件正确赋值与布局
• 通过[[ATNativeADView alloc] initWithConfiguration:config currentOffer:placementID:]正确创建原生广告视图
• 自渲染广告：正确调用[nativeADView getMediaView]获取mediaView对象，并判空，如不为空需要正确添加布局
• 自渲染广告：调用registerClickableViewArray正确传入注册点击事件的UI控件
• 自渲染广告：调用ATNativePrepareInfo loadPrepareInfo:正确传入绑定待渲染的UI控件
• 正确调用rendererWithNativeAdView:selfRenderView:adInfo:进行渲染，之后设置nativeADView为可见
• 正确进行预加载（didFailToLoadADWithPlacementID中必须延迟后发起预加载,详情请见示例 Code ;didTapCloseButtonInAdView中不需要延迟）
• [可选] 设置广告收益监听（didRevenueForPlacementID）
• 正确释放广告资源（destroyNative,ATNativeAdOffer=nil）

原生模板广告

• 正确设置 广告位ID
• 设置广告事件Delegate（ATNativeADDelegate）
• 正确调用广告加载方法（loadADWithPlacementID）
• 通过ATNativeADConfiguration来进行展示前的配置
• 通过getNativeAdOfferWithPlacementID正确创建ATNativeAdOffer，并且判空后使用
• 通过[[ATNativeADView alloc] initWithConfiguration:config currentOffer:placementID:]正确创建原生广告视图
• 正确调用rendererWithNativeAdView:selfRenderView:adInfo:进行渲染，之后设置nativeADView为可见
• 正确进行预加载（didFailToLoadADWithPlacementID中必须延迟后发起预加载,详情请见示例 Code ; didTapCloseButtonInAdView中不需要延迟）
• [可选] 设置广告收益监听（didRevenueForPlacementID）
• 正确释放广告资源（destroyNative）

---

三、通用检查项

• 使用调试工具验证广告集成状况（[[ATDebuggerAPI sharedInstance] showDebuggerInViewController:vc showType:ATShowDebugUIPresent debugkey:@"填入您的DebugKey，DebugKey在后台->账号管理->Key中获取，DebugKey需要与AppID，AppKey对应"];）
• 调试阶段开启debug日志开关（[ATAPI setLogEnabled:YES];）

---

四、三方收益回传

• 取值上报请参考示例Code