中文
登录
后可查看全部文档
GroMore/开发测试/GroMore Android集成文档/GroMore Android SDK接入文档/插全屏广告接入
插全屏广告接入
最近更新 2026-03-19 17:01:49

一、简介

该广告类型支持插屏广告、全屏广告混出,开发者可以选择广告铺开大小:分为全屏和插屏,全屏和插屏场景下开发者都可以选择投放的广告类型,分别为图片+视频、仅视频、仅图片。

注意事项

  • 多进程设置:如需开启可在初始化时设置.supportMultiProcess(true),默认false;注意:开启多进程开关时需要将ADN的多进程也开启,否则广告展示异常,影响收益。CSJ、gdt无需额外设置,KS、baidu、Sigmob、Mintegral需要在清单文件中配置各ADN激励、全屏xxxActivity属性android:multiprocess="true"。
  • 广告请求
    • 聚合SDK是通过广告位ID发起广告请求的,切记不要使用混淆。
    • 广告请求时机,建议在收到SDK初始化成功回调后发起广告请求,当SDK初始化回调一直失败时,建议首先明确appid及广告位ID是否赋值正确、是否有多余空格、是否是网络不稳定导致的超时等,当排查后无法定位问题时,建议通过抓包将config字段下的加密内容提供过来,我方协助定位问题。
    • 在广告接入前需要明确各ADN对应聚合SDK广告样式情况,以确保正确完成广告接入,避免由于广告类型不匹配导致接入报错等情况的发生。
    • 由于各广告平台对于包名校验规则不同,需确保在穿山甲媒体平台填写的包名符合各ADN平台规范,避免由于包名校验不匹配导致的无广告返回情况的产生。
  • 广告展示
    • 为了保证播放流畅,建议在收到onFullScreenVideoCached(TTFullScreenVideoAd ad)之后进行广告展示,广告展示前可通过isReady来判断当前广告是否可用。
    • 如若针对展示失败有重试机制,建议只重试一次即可,避免无限重试引发死循环场景。

二、构建请求参数

1、使用示例

使用初始化后的TTAdManager对象,创建广告请求对象TTAdNative。

复制

创建广告请求AdSlot,用于请求广告前,传递部分广告配置参数。

复制

2、接口说明

  • AdSlot.Builder说明

方法名

说明

setCodeId(String codeId)

聚合广告位ID

setAdCount(int adCount)

加载广告数,最多不超过3个

setOrientation(@TTAdConstant.ORIENTATION_STATE int orientation)

设置横竖屏

setUserID(String userID)

用户的唯一标识,非必传,主要用来方便后续问题排查

setMediationAdSlot(MediationAdSlot mediationAdSlot)

设置聚合广告请求参数

  • MediationAdSlot.Builder说明

方法名

说明

setMuted(boolean var1)

设置静音

setVolume(float var1)

设置音量范围0~1;静音设置为0

setUseSurfaceView(boolean var1)

是否使用SurfaceView

setExtraObject(String var1, Object var2)

设置额外参数

setBidNotify(boolean var1)

bidding类型广告,竞价成功或者失败后是否通知对应的ADN

setScenarioId(String var1)

广告场景ID

三、请求广告

1、使用示例

复制

2、接口说明

  • TTFullScreenVideoAd说明

方法名

说明

void setFullScreenVideoAdInteractionListener(FullScreenVideoAdInteractionListener listener)

注册插屏广告交互回调

void showFullScreenVideoAd(Activity activity)

展示广告

void showFullScreenVideoAd(Activity activity, TTAdConstant.RitScenes ritScenes, String scenes)

展示广告,ritScenes, scenes参数不生效

Map<String, Object> getMediaExtraInfo()

广告额外信息

MediationFullScreenManager getMediationManager()

获取聚合广告信息

int getFullVideoAdType()

广告类型(聚合场景不支持)

long getExpirationTimestamp()

过期时间戳(聚合场景不支持)

int getInteractionType()

广告的交互类型(聚合场景不支持)

void setDownloadListener(TTAppDownloadListener listener)

注册广告的下载回调(聚合场景不支持)

  • TTAdNative.FullScreenVideoAdListener说明

方法名

说明

void onFullScreenVideoAdLoad(TTFullScreenVideoAd ad)

广告加载成功

void onFullScreenVideoCached()

广告视频本地加载完成的回调,即将废弃

void onFullScreenVideoCached(TTFullScreenVideoAd ad)

广告视频本地加载完成的回调

void onError(int code, String message)

广告加载失败

四、展示广告

1、使用示例

为了确保播放流程建议在onFullScreenVideoCached(TTFullScreenVideoAd ad)回调后调用广告展示并判断isReady状态。

复制

2、接口说明

  • FullScreenVideoAdInteractionListener说明

方法名

说明

onAdShow()

全屏视频广告开始展示时回调,用于曝光统计或埋点

onAdVideoBarClick()

用户点击广告条(视频上方/下方互动区域)时回调,用于点击统计或跳转处理

onAdClose()

用户关闭全屏视频广告时回调,可在此恢复应用界面、释放资源等

onVideoComplete()

视频播放完整结束时回调

onSkippedVideo()

用户跳过视频(未播放完)时回调

五、获取展示后广告信息示例

1、使用示例

复制

2、接口说明

  • MediationNativeManager 说明

方法名

说明

boolean isReady()

当前广告是否可以展示

MediationAdEcpmInfo getShowEcpm()


为了确保数据的准确性,强烈建议在展示后获取展示广告的详细信息,包括广告位类型-getRitType、流量分组ID-getSegmentId、AB实验分组ID-getABTestId、渠道名称-getChannel、子渠道名称-getSubChannel、场景ID-getScenariold、价格-getEcpm、ADN平台-getSdkName

List<MediationAdLoadInfo> getAdLoadInfo()

load回调后获取广告加载信息

boolean hasDislike()

是否需要Dislike弹窗

void setUseCustomVideo(boolean useCustomVideo)

设置是否是开发者自己进行视频播放,仅支持对外提供视频url的adn,要注意有些adn需要申请白名单

void setShakeViewListener(MediationShakeViewListener listener)

摇一摇监听

boolean isExpress()

是否为模板广告

  • MediationAdEcpmInfo说明

方法名

说明

Map<String, String> getCustomData()

自定义参数

String getSdkName()

获取SDK名称

String getCustomSdkName()

获取自定义ADN名称

String getSlotId()

获取代码位ID

String getLevelTag()

获取多阶底价标签

String getEcpm()

获取价格

int getReqBiddingType()

获取bidding类型

String getErrorMsg()

获取错误信息

String getRequestId()

获取请求标识

String getRitType()

获取代码位类型

String getSegmentId()

获取流量分组ID

String getChannel()

获取渠道

String getSubChannel()

获取子渠道

String getAbTestId()

获取AB测试ID

String getScenarioId()

获取场景ID

六、销毁广告

已经展示过且不再使用的广告需要在合适的时机调用destroy方法及时对广告进行销毁,避免内存异常场景。

复制

七、示例代码

详细示例可参照demo:MediationInterstitialFullActivity类。

复制

本篇目录
联系我们