Skip to main content

开屏广告

开屏广告#

  • 开屏广告是打开app的时候展示一个3-5s的全屏的广告
  • 开屏广告分冷启动和热启动,冷启动时要尽可能提前开始加载广告,这样才能确保在进入app之前加载到并展示广告
  • 热启动是app切换到后台,并没有真正的退出,这种情况下要能检测到并提前加载广告
  • 开屏广告一般要配合app的启动页来使用,在加载的时间先给用户看启动页,等广告加载成功后展示广告,广告结束进入app内部

集成说明#

1. 初始化#

#import <TradPlusAds/TradPlusAdSplash.h>
//初始化广告位
self.splashAd = [[TradPlusAdSplash alloc] init];
//设置回调
self.splashAd.delegate = self;
//设置广告位ID
[self.splashAd setAdUnitID:@"您的广告位ID"];

2. 加载广告#

//设置 window 自定义view
[self.splashAd loadAdWithWindow:window bottomView:view];

注:自定义view大小一般不超过屏幕的25%;支持广告平台为:Mintegral,腾讯广告,穿山甲,Sigmob,百度

3. 显示广告#

//判断是否有可用广告
if (self.splashAd.isAdReady)
{
[self.splashAd show];
}

4. 监听回调#

  • 回调信息说明

  • tpSplashAdLoadFailWithError:返回的是TP封装的错误信息:详见: 错误码说明

  • tpSplashAdOneLayerLoaded:didFailWithError: 返回三方源的错误信息

  • 以下回调接口已废弃v7.6.0+

- (void)tpSplashAdBidEnd:(NSDictionary *)adInfo success:(BOOL)success DEPRECATED_MSG_ATTRIBUTE("Please use tpSplashAdBidEnd:error:");
- (void)tpSplashAdLoadStart:(NSDictionary *)adInfo DEPRECATED_MSG_ATTRIBUTE("Please use tpSplashAdOneLayerStartLoad:");

回调接口及说明

///AD加载完成 首个广告源加载成功时回调 一次加载流程只会回调一次
- (void)tpSplashAdLoaded:(NSDictionary *)adInfo;
///AD加载失败
///tpSplashAdOneLayerLoad:didFailWithError:返回三方源的错误信息
- (void)tpSplashAdLoadFailWithError:(NSError *)error;
///AD展现
- (void)tpSplashAdImpression:(NSDictionary *)adInfo;
///AD展现失败
- (void)tpSplashAdShow:(NSDictionary *)adInfo didFailWithError:(NSError *)error;
///AD被点击
- (void)tpSplashAdClicked:(NSDictionary *)adInfo;
///AD关闭
- (void)tpSplashAdDismissed:(NSDictionary *)adInfo;
@optional
///v7.6.0+新增 开始加载流程
- (void)tpSplashAdStartLoad:(NSDictionary *)adInfo;
///当每个广告源开始加载时会都会回调一次。
///v7.6.0+新增。替代原回调接口:tpSplashAdLoadStart:(NSDictionary *)adInfo;
- (void)tpSplashAdOneLayerStartLoad:(NSDictionary *)adInfo;
///v8.7.0+新增
///调用load之后如果收到此回调,说明广告位仍处于加载状态,无法触发新的一轮广告加载。
- (void)tpSplashAdIsLoading:(NSDictionary *)adInfo;
///bidding开始
- (void)tpSplashAdBidStart:(NSDictionary *)adInfo;
///bidding结束 error = nil 表示成功
- (void)tpSplashAdBidEnd:(NSDictionary *)adInfo error:(NSError *)error;
///当每个广告源加载成功后会都会回调一次。
- (void)tpSplashAdOneLayerLoaded:(NSDictionary *)adInfo;
///当每个广告源加载失败后会都会回调一次,返回三方源的错误信息
- (void)tpSplashAdOneLayerLoad:(NSDictionary *)adInfo didFailWithError:(NSError *)error;
///加载流程全部结束
- (void)tpSplashAdAllLoaded:(BOOL)success;
//v8.1.0+新增 跳过
- (void)tpSplashAdSkip:(NSDictionary *)adInfo;
//v8.1.0+新增 点睛开始
- (void)tpSplashAdZoomOutViewShow:(NSDictionary *)adInfo;
//v8.1.0+新增 点睛关闭
- (void)tpSplashAdZoomOutViewClose:(NSDictionary *)adInfo;

5. 接入参考#

参考:TradPlusAdSplashViewController

6.设置自定义原生模版#

v8.4.0开始 开屏支持混用原生广告。对于需要使用自定义原生布局的开发者可以通过API来设置。

/// 指定原生开屏的渲染模版 展示广告
/// @param renderingViewClass renderingViewClass 仅对Waterfall中的原生广告生效
- (void)showWithRenderingViewClass:(Class)renderingViewClass;
/// 指定原生开屏的renderer 展示广告
/// @param renderer 自定义renderer 仅对Waterfall中的原生广告生效
- (void)showWithRenderer:(TradPlusNativeRenderer *)renderer;

原生广告相关API及说明。

///设置 原生开屏 模版渲染的布局方式 默认 TPTemplateContentModeCenter
@property (nonatomic,assign)TPTemplateContentMode templateContentMode;
/// 设置 原生开屏 模版渲染的尺寸 需要在load之前设置
/// 默认使用 屏幕最短边正方形size进行渲染
/// @param size 尺寸
- (void)setTemplateRenderSize:(CGSize)size;

广告平台特殊配置说明#

Pangle(海外)#

开发者可以通过一下代码设置Pangle(海外)开屏的 自定义icon(正方形)

UIImage *image = [UIImage imageNamed:@"icon"];
self.splashAd.dicCustomValue = @{@"pangleGlobal_appIcon":image};

开屏广告的推荐用法#

应用启动方式#

  • 冷启动:当启动应用时,后台没有该应用的进程,这时系统会重新创建一个新的进程分配给该应用,这种方式叫“冷启动”
  • 热启动:当启动应用时,后台已有该应用的进程,例:按home键推出再回到前台,或切换应用回到前台等,这种方式叫“热启动”

开屏加载策略#

冷启动方式打开应用#

  • 第一时间在后台load广告,同时建议在loading页时最多停留5秒
    • 如果5秒内返回广告,直接显示。显示完后,再调用 load 方法加载一条广告,供下次热启动时使用
    • 如果5秒内未返回广告,则关闭loading页,直接进入应用主界面。如在此之后收到 loaded 回调,不要再调用show方法。本次广告不会丢弃,SDK会缓存下来备用
  • 应用冷启动时,加载广告的过程中尽量不要同时请求其他网络资源,以免影响广告加载速度

热启动方式打开应用#

  • 有广告则直接显示
  • 不管有无广告展示,都需要再加载一条新的广告,作为备用
  • 如果应用能够监听到切换后台事件,可在切换后台时调用 isReady 方法判断广告是否Ready,如果没有Ready,可补充一条广告

开屏出现时机#

推荐示例

在下面的推荐示例中,开屏广告在应用的加载屏幕上显示。

不推荐示例

如果用户已经进入应用Home页,则不要展示开屏广告。否则会突然弹出,容易造成用户误点击。