开屏广告： 开屏广告为用户在进入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点
