English
Log In
You can then view all documents
GroMore/开发测试/GroMore Harmony集成文档/开屏广告
开屏广告
Last updated 2026-03-19 17:03:02

一、简介

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

二、构建请求参数

1. 使用示例

初始化广告创建器

复制

构建广告请求参数AdSlot

复制

2. 接口说明

  • AdSlotBuilder

接口

是否必填

类型

含义

setCodeId(codeId:string)

string

您在平台上申请的代码位Id,8开头9位数字

setAcceptSize(width: number, height: number)

number

广告UI size,默认单位vp

三. 请求广告

1. 使用示例

广告加载成功后即可展示开屏广告,在接收到onAdLoaded回调中展示广告:

方式一:获取CSJSplashAd对象调用showSplashAd展示广告

复制

方式二:使用View展示开屏广告:可以通过splashAd对象的getAdComponent方法获取开屏广告NodeController,用于展示

注意:如果使用window承载广告,必须将window对象传入,否则会影响摇一摇广告跳转。

复制

2. 接口说明

  • CSJSplashAdLoadParam

方法

参数

含义

CSJSplashAdLoadParam(adSlot, loadListener, timeout)

adSlot

广告基础信息与素材加载完成,在此方法回调后可以展示广告

loadListener

若加载中出错,会回调此方法

timeout

// 创建广告请求参数时传入加载超时时间,单位毫秒
let loadParam = new CSJSplashAdLoadParam(adSlot, loadListener, 3500)

超时的计算逻辑:穿山甲从开发者加载广告开始倒计时(注意并非从SDK初始化开始计时),若广告在倒计时结束之前完成广告加载,则会为开发者响应广告。若倒计时结束前未完成广告加载,则将响应超时。建议开发者:

  • CSJSplashAdLoadListener

接口

参数

含义

onAdLoaded(splashAd: CSJSplashAd)

splashAd:用于展示开屏广告

广告基础信息与素材加载完成,在此方法回调后可以展示广告

onError(code: number, message: string)

code:错误码

message:错误信息

若加载中出错,会回调此方法

onRenderSuccess: (splashAd: CSJSplashAd)

splashAd:开屏广告对象

开屏渲染成功

onRenderFail:(code: number, message: string)

code:错误码

message:错误信息

开屏渲染失败

四、监听广告行为(可选)

1. 使用示例

在调用展示广告前,创建广告交互监听器,用于实时获取广告曝光,点击,关闭等行为。

复制

2. 接口说明

接口

参数

含义

onRenderSuccess()

/

广告渲染成功

onRenderFail(code: number, message: string)

code:错误码message:错误信息

广告渲染失败

onDidShow()

/

广告展示

onDidClick()

/

广告被用户点击了

onDidClose(closeType: CSJSplashAdCloseType)// SplashAdCloseType更名为CSJSplashAdCloseType

closeType: 广告关闭类型,closeType.value对应以下关闭原因1: 点击跳过
2: 展示倒计时时间到达
3: 点击广告
0: 其他

广告关闭

onVideoDidPlayFinish()

/

视频广告播放完成

onVideoDidPlayFail(code: number, message: string)

code:错误码message:错误信息

视频广告播放错误

五、自定义底部logo

开发者可自定义开屏底部View,用于logo展示等个性化设置。

1. 加载半屏广告

加载广告时,需要设置正确的广告高度,通常为屏幕高度减底部自定义View高度(自定义View高度不得超过屏幕高度一半,否则影响广告曝光)。

复制

2. 设置自定义底部View

复制

六、自定义关闭按钮(仅CSJ生效)

复制

七、聚合功能说明

1. 使用示例

注意:需确保调用在广告展示onDidShow回调后获取

复制

2. 接口说明

  • CSJSplashAd说明

接口

返回值

含义

getMediationAdInfo()

object | undefined

返回聚合相关信息

  • MediationAdEcpmInfo说明

接口

返回值

含义

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接入示例。


Contents
Contact us