CSJ: A global platform dedicated to developer growth.

Support Center

English

You can then view all documents

Details

Introduction

Registration

Configurement

Compliance

Installation

GroMore

电商联盟

内容输出

闭环电商

Payment

GroMore/开发测试/GroMore Harmony集成文档/新插屏广告

新插屏广告

Last updated 2026-03-19 17:03:14

一、简介

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

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

二、构建请求参数

1. 使用示例

初始化广告创建器

复制

构建广告请求参数AdSlot

复制

2. 接口说明

接口

是否必填

类型

含义

setCodeId()

是

String

您在平台上申请的代码位ID，以9开头9位数字

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

Contents