
开屏广告场景在应用启动时进行展示,展示完毕后自动关闭并进入应用的主界面。开屏代码位只能用于应用开屏的位置。开屏广告返回为一个视图View,宽高默认为屏幕宽高。注意: 开屏广告 width =屏幕宽;height需要>=75%屏幕高 ,否则会影响计费。
初始化广告创建器
构建广告请求参数AdSlot
接口 | 是否必填 | 类型 | 含义 |
setCodeId(codeId:string) | 是 | string | 您在平台上申请的代码位Id,8开头9位数字 |
setAcceptSize(width: number, height: number) | 是 | number | 广告UI size,默认单位vp |
广告加载成功后即可展示开屏广告,在接收到onAdLoaded回调中展示广告:
方式一:获取CSJSplashAd对象调用showSplashAd展示广告
方式二:使用View展示开屏广告:可以通过splashAd对象的getAdComponent方法获取开屏广告NodeController,用于展示
注意:如果使用window承载广告,必须将window对象传入,否则会影响摇一摇广告跳转。
方法 | 参数 | 含义 |
CSJSplashAdLoadParam(adSlot, loadListener, timeout) | adSlot | 广告基础信息与素材加载完成,在此方法回调后可以展示广告 |
loadListener | 若加载中出错,会回调此方法 | |
timeout | // 创建广告请求参数时传入加载超时时间,单位毫秒 |
接口 | 参数 | 含义 |
onAdLoaded(splashAd: CSJSplashAd) | splashAd:用于展示开屏广告 | 广告基础信息与素材加载完成,在此方法回调后可以展示广告 |
onError(code: number, message: string) | code:错误码 message:错误信息 | 若加载中出错,会回调此方法 |
onRenderSuccess: (splashAd: CSJSplashAd) | splashAd:开屏广告对象 | 开屏渲染成功 |
onRenderFail:(code: number, message: string) | code:错误码 message:错误信息 | 开屏渲染失败 |
在调用展示广告前,创建广告交互监听器,用于实时获取广告曝光,点击,关闭等行为。
接口 | 参数 | 含义 |
onRenderSuccess() | / | 广告渲染成功 |
onRenderFail(code: number, message: string) | code:错误码message:错误信息 | 广告渲染失败 |
onDidShow() | / | 广告展示 |
onDidClick() | / | 广告被用户点击了 |
onDidClose(closeType: CSJSplashAdCloseType)// SplashAdCloseType更名为CSJSplashAdCloseType | closeType: 广告关闭类型,closeType.value对应以下关闭原因1: 点击跳过 | 广告关闭 |
onVideoDidPlayFinish() | / | 视频广告播放完成 |
onVideoDidPlayFail(code: number, message: string) | code:错误码message:错误信息 | 视频广告播放错误 |
开发者可自定义开屏底部View,用于logo展示等个性化设置。
加载广告时,需要设置正确的广告高度,通常为屏幕高度减底部自定义View高度(自定义View高度不得超过屏幕高度一半,否则影响广告曝光)。
注意:需确保调用在广告展示onDidShow回调后获取
接口 | 返回值 | 含义 |
getMediationAdInfo() | object | undefined | 返回聚合相关信息 |
接口 | 返回值 | 含义 |
getAdnName() | string | 返回展示广告的adn名称 |
getAdnRitId() | string | 返回展示广告的adn代码位 |
getEcpm() | number | 返回展示广告的价格 |
getBiddingType() | number | 返回展示广告的竞价类型0为普通广告位,1 client竞价广告 2 server竞价广告 100 P层数据 |
getRitType() | string | 返回展示广告的广告类型"Banner" "Splash" "RewardVideo" "FullVideo" "Native" "Draw" "Interstitial" "InterstitialFull" |
穿山甲开屏广告请参考demo中的adtype/splash/SplashAdShowPage.ets接入示例
聚合维度开屏广告请参考demo中mediation_adtype/splash/SplashAdShowPage.ets接入示例。
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock