中文
登录
后可查看全部文档
GroMore/开发测试/GroMore Harmony集成文档/新插屏广告
新插屏广告
最近更新 2026-11-02 16:32:15

一、简介

场景一般为应用功能自然体验中断时,例如,暂停视频播放,游戏关卡之间。插屏广告不应突然出现,不应干扰用户使用应用的正常流程,例如应用加载,退出应用或者游戏过程中。

  • 广告目前的渲染方式为模板渲染,线上会自动选出收益最佳的样式进行广告展示.
  • 新插屏广告展示的横竖屏由平台创建代码位时确定,不支持自适应屏幕方向。
  • 新插屏展示的尺寸为半屏、全屏、混出,由平台创建代码位时确定。

二、构建请求参数

1. 使用示例

初始化广告创建器

复制

构建广告请求参数AdSlot

复制

2. 接口说明

接口

是否必填

类型

含义

setCodeId()

是

String

聚合场景:传入以1开头的广告位ID,SDK内部会自行请求开发者在瀑布流下配置的代码位ID;

非聚合场景:传入8或9开头的代码位ID

setAdLoadType()

否

AdLoadTypeAdLoadType.UNKNOWN:未知

AdLoadType.PRELOAD:预加载

AdLoadType.LOAD:正常加载

用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略

三、请求及展示广告

1. 使用示例

在调用loadFullAd加载广告后,建议在收到onAdCached回调后通过广告对象调用showFullAd展示广告

复制

展示广告时需要传入windowStage对象,在需要展示广告的UIAbility的onWindowStageCreate方法中获取

复制

2. 接口说明

  • FullAdLoadListener

接口

参数

含义

onAdLoaded(ad: CSJFullAd)

ad:广告对象

广告基础信息加载完成,此方法是回调后是广告可调用展示的最早时机

onAdCached(ad: CSJFullAd)

ad:广告对象

广告基础信息与素材缓存完成,此时调用广告展示流畅,是展示广告的最理想时机

onError(code: number, message: string)

code:错误码message:错误信息

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

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

1. 使用示例

在调用展示广告前,创建广告交互监听器setInteractionListener,用于实时获取广告展示状态

复制

2. 接口说明

  • FullAdInteractionListener

接口

参数

含义

onShow()

/

广告展示

onSkip()

/

广告播放中用户点击了跳过

onClick()

/

广告被用户点击了

onClose()

/

广告关闭

五、聚合功能说明

1. 使用示例

需确保调用广告展示onShow回调后获取

聚合维度复用CSJFullAd对象,支持插屏+全屏广告混用,插屏+全屏广告样式均通过loadFullAd方法加载广告。

复制

2. 接口说明

  • CSJFullAd说明

接口

返回值

含义

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"

六、资源

CSJ新插屏广告请参考demo中的adtype/full/FullAdPage.ets接入示例

聚合维度新插屏广告请参考demo中mediation_adtype/full/FullAdPage.ets接入示例。


本篇目录
联系我们