开屏广告: 开屏广告为用户在进入App时展示的全屏广告。开屏广告为一个View,宽高默认为match_parent。注意: 开屏广告view:width =屏幕宽;height需要>=75%屏幕高 ,否则会影响计费。
支持的广告尺寸:开屏广告的尺寸为开发者请求广告时设置的尺寸,建议设置的请求尺寸传入与展示区域大小保持一致,避免素材变形。
SDK渲染开屏广告: 默认提供模板渲染开屏广告: 白名单,需要申请开通
参数 | 含义 |
setCodeId() | 平台创建的代码位ID 以8开头9位数字 |
setImageAcceptedSize() | 单位:px |
setExpressViewAcceptedSize() | 单位:dp |
setAdLoadType() | 用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值:UNKNOWN//未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用PRELOAD//预加载,当此次加载的广告用途为预加载(当作缓存)时使用LOAD//实时加载,当此次加载的广告用途为实时播放时使用 |
调用TTAdNative.loadSplashAd(AdSlot adSlot, SplashAdListener listener, int timeOut)异步加载开屏广告。adslot为请求广告的信息,SplashAdListener为广告加载成功或失败的回调,timeOut为加载开屏广告允许的最长时间(注:建议timeOut > 3500ms)。调用示例如下:
注意: 调用ad.getSplashView()获取到SplashView
回调 | 说明 |
onError() | 广告请求失败回调 返回的错误码(code)表示广告请求失败的原因,详情请见链接 |
onTimeout() | 开屏广告加载超时回调 |
onSplashAdLoad() | 广告加载完成的回调,接入方可以在这个回调中进行展示 |
回调 | 说明 |
onSplashLoadSuccess() | 广告物料、素材加载成功回调 |
onSplashLoadFail(CSJAdError csjAdError) | 广告物料或素材加载失败或超时回调 |
onSplashRenderSuccess(CSJSplashAd ad) | 广告渲染回调,接入方可以在这个回调中,调用ad.showSplashView(splashContainerView)进行渲染 |
onSplashRenderFail(CSJSplashAd ad, CSJAdError csjAdError) | 广告渲染失败或超时回调 返回的错误码(csjAdError)表示广告请求失败的原因,详情请见链接 |
回调 | 说明 |
onAdClicked() | 广告点击回调 |
onAdShow() | 广告展示回调 |
onAdSkip() | 广告跳过回调 |
onAdTimeOver() | 广告倒计时结束回调 |
回调 | 说明 |
onSplashAdClick(CSJSplashAd ad); | 广告点击回调 |
onSplashAdShow(CSJSplashAd ad) | 广告展示回调 |
onSplashAdClose(CSJSplashAd ad, int closeType) | 开屏跳过以及倒计时结束统一收敛到该接口 |
穿山甲3600及以上版本的Demo中提供了两种类型的点睛示例:
具体示例代码请查看SplashActivity,SplashClickEyeManager(主要用于实现开屏点睛动画管理类)
方法名 | 方法介绍 |
splashClickEyeAnimationFinish() | 该方法需要开发者在点睛动画结束时,主动调用通知穿山甲去做点睛view的改变逻辑。 |
setSplashClickEyeListener(ISplashClickEyeListener listener) | 通过将监听传递给穿山甲,穿山甲在合适的时机触发ISplashClickEyeListener的各个接口方法,通知给开发者做不同操作。 |
int[] getSplashClickEyeSizeToDp() | 穿山甲传递给开发者的点睛View的推荐尺寸,建议开发者先使用该值去确定最终点睛View的大小。 |
方法名 | 方法介绍 |
onSplashClickEyeAnimationStart() | 3600版本以及之后版本,当穿山甲满足开屏点睛条件时触发,开发者可以在该回调中开始展示点睛动画。 |
onSplashClickEyeAnimationFinish() | 3600版本以及之后版本,当穿山甲关闭点睛view时触发,开发者可以在该方法中做些资源回收,关闭开屏的操作。 |
isSupportSplashClickEye(boolean isSupport) | 3600版本以及之后版本,当穿山甲满足开屏点睛条件时触发,开发者可以在该方法中保持该boolean值,用于开屏两个activity判断是否需要展示开屏点睛时使用。 |
方法名 | 方法介绍 |
animationStart(int animationTime) | 开始执行开屏点睛动画时调用,animationTime为点睛动画的执行时间,开发者可以自己定义。 |
animationEnd() | 点睛动画执行完成后调用 |
方法名 | 方法介绍 |
onSplashClickEyeReadyToShow(CSJSplashAd bean) | 通知媒体可以展示点睛 |
onSplashClickEyeClick() | 媒体点睛点击回调 |
onSplashClickEyeClose() | 点睛关闭回调 |
方法介绍在开屏的onSplashAdLoad广告拉取成功的回调中,进行初始化开屏相关的方法为:initSplashClickEyeData,该方法主要做两件事:
- 第一件事为实例化ISplashClickEyeListener接口,将ISplashClickEyeListener实例对象设置给穿山甲。
- 第二件事是将当前的TTSplashAd和开屏view保持到SplashClickEyeManager单例中方法为setSplashInfo。
该方法用于两个Activity之间的开屏动画数据传递。
穿山甲ISplashCardListener接口:(4700之前版本)
穿山甲SplashCardListener接口:(4700及以上版本)
可在Activity跳转到其他Activity时把广告控件上的广告视图remove掉mSplashContainer.removeAllViews();
加载开屏广告具体示例详见Demo中的SplashActivity
1、模板渲染的开屏请求方法需设置setExpressViewAcceptedSize参数 单位dp。非模板渲染开屏请求方法需设置setImageAcceptedSize参数 单位px 。切记不可使用错误
2、开屏广告加载超时时间建议大于3500ms,最大程度的保证广告的展示率可开屏体验,示例设置了3500ms
3、为了收益最大化所有开屏广告均要实时请求,不可缓存。
4、开发者要在onError()、onTimeout()、onAdSkip()、onAdTimeOver()回调及TTSplashAd广告为null时开发者做跳转主页面的处理,跳转之后开屏控件上的view移除。
5、需要开发者在开屏Activity中onStop()中做一个标记 在onResume()中做跳转主页面的逻辑处理,跳转之后开屏控件上的view移除。
6、如果要在底部添加自身logo,需要缩小的开屏广告的展示区域,此时请求的时候宽和高填写裁剪后宽和高即可,即请求尺寸为屏幕宽*(屏幕高-logo高)
7、自定义跳过按钮,使用点睛功能说明见https://www.csjplatform.com/support/doc/6109033c7d600700463e0b26
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点