帮助中心

中文

后可查看全部文档

帮助文档

新手引导

合作注册

流量管理

业务规范

开发测试

GroMore

电商联盟

内容输出

闭环电商

财务结算

开发测试/Android集成文档/开屏广告

开屏广告

最近更新 2026-03-17 16:34:49

一、简介

开屏广告场景在应用启动时进行展示，展示完毕后自动关闭并进入应用的主界面。开屏代码位只能用于应用开屏的位置。开屏广告返回为一个视图View，宽高默认为match_parent。注意： 开屏广告 width =屏幕宽；height需要>=75%屏幕高，否则会影响计费。

建议请求时传入尺寸与展示区域大小保持一致，避免素材变形。

接入须知：

广告尺寸：低于75xx版本要求开发者同时设置setImageAcceptedSize（单位：px）和setExpressViewAcceptedSize（单位：dp ）接口，不同时设置可能会导致展示异常。75xx及以上只需调用setExpressViewAcceptedSize（单位：dp ）即可；如果要在底部添加自身logo，则请求的时宽和高填写裁剪后的宽和高即可，即请求尺寸为屏幕宽*（屏幕高-logo高）
超时时间：开屏广告加载超时时间建议大于3500ms，最大程度的保证广告的展示率可开屏体验；
兼容逻辑：为了收益最大化所有开屏广告均要实时请求，不建议缓存。开发者要在onSplashLoadFail()、onSplashRenderFail()、onSplashAdClose()回调及CSJSplashAd广告为null时开发者做跳转主页面的处理，跳转之后开屏控件上的view移除。需要开发者在开屏Activity的onStop()中做一个标记，在onResume()中做跳转主页面的逻辑处理，跳转之后开屏控件上的view移除。触发onSplashLoadSuccess回调时，建议开发者不要使用getSplashView添加视图，因为此时还暂未渲染成功，建议只参与竞价，统一在接收到渲染成功onSplashRenderSuccess回调后使用showSplashView(Container) 添加视图。

二、构建请求参数

1. 使用示例

创建TTAdNative对象

复制

创建广告请求AdSlot

复制

2. 接口说明

方法	含义
setCodeId()	平台创建的代码位ID ，以8开头9位数字
setImageAcceptedSize()	单位：px，75xx及以后版本不需要设置
setExpressViewAcceptedSize()	单位：dp
setAdLoadType()	用于标注此次的广告请求用途为预加载（当做缓存）还是实时加载，方便后续为开发者优化相关策略，传入参数值： 1. UNKNOWN：未知，默认值，开发者未传入或当此次加载的广告用途未知时使用 2. PRELOAD：预加载，当此次加载的广告用途为预加载（当作缓存）时使用； 3. LOAD：实时加载，当此次加载的广告用途为实时播放时使用

三、请求及展示广告

开发者调用mTTAdNative.loadSplashAd(AdSlot adSlot, CSJSplashAdListener listener, int timeOut)异步加载开屏广告，并在onSplashRenderSuccess回调中回调获取开屏广告视图并展示。

广告请求：

AdSlot ：广告请求参数，传入代码位、广告尺寸

CSJSplashAdListener ：广告请求回调

timeOut：超时时间，建议>3500ms

广告展示：

方式一：调用ad.getSplashView()获取到SplashView，将SplashView添加到开屏容器中

方式二：调用ad.showSplashView(mSplashContainer) 传入开屏容器进行展示

1. 使用示例

复制

2. 接口说明

CSJSplashAdListener

方法	说明
onSplashLoadSuccess(CSJSplashAd ad)	开屏素材加载成功回调
onSplashLoadFail(CSJAdError csjAdError)	广告物料或素材加载失败或超时回，返回的错误码(csjAdError)说明详情请见链接
onSplashRenderSuccess(CSJSplashAd ad)	广告渲染成功回调，接入方可以在这该回调中，调用ad.showSplashView(splashContainerView)进行渲染
onSplashRenderFail(CSJSplashAd ad, CSJAdError csjAdError)	广告渲染失败或超时回调

CSJSplashAd

方法	说明
getSplashView( )	调用ad.getSplashView()获取到SplashView，并添加容器进行展示
showSplashView(ViewGroup viewGroup)	调用ad.showSplashView(mSplashContainer) 传入开屏容器进行展示，和getSplashView使用其中一种方式展示即可
getInteractionType( )	获取Splash广告的交互类型 2：在浏览器内打开（普通类型） 3：落地页（普通类型） 5：拨打电话 -1 未知类型
getMediaExtraInfo( )	返回广告额外信息
setSplashAdListener(SplashAdListener splashAdListener);	注册开屏广告状态回调，如监听广告展示，点击，关闭等行为详见【监听广告行为】说明
setDownloadListener(TTAppDownloadListener downloadListener);	广告下载监听回调

四、监听广告行为

在获取到CSJSplashAd对象之后，调用展示广告之前，调用ad.setSplashAdListener设置交互监听器。可监听广告的展示，跳过，奖励发放，退出等行为，开发者可进行相应逻辑处理。

1. 使用示例

复制

2. 接口说明

方法	说明
onSplashAdClick	广告点击回调
onSplashAdShow	广告展示回调
onSplashAdClose	广告关闭回调，倒计时结束和点击跳过回调

五、监听下载状态

在获取到CSJSplashAd对象之后，调用展示广告之前，调用setDownloadListener设置下载状态监听下载进度和状态；

复制

六、移除广告view

可在开屏Activity跳转到其他Activity时把广告控件上的广告视图remove掉mSplashContainer.removeAllViews();

七、接入示例

加载开屏广告具体示例详见Demo中的CSJSplashActivity

本篇目录