跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

插屏广告

简介

在应用页面内呈现的弹窗广告。

接口说明

方法

说明

UMUnionSdk.loadInterstitialAd(Activity, UMAdConfig, AdCloseListener)

请求并直接展示

UMUnionSdk.getApi().loadInterstitialAd(Activity, UMAdConfig, AdLoadListener<AdDisplay>)

Load/Show分离模式

AdDisplay(通用显示接口)

方法

说明

show(Activity activity)

显示广告,必须传入Activity

isReady()

素材是否就绪

destroy()

释放资源

setAdCloseListener(AdCloseListener)

设置关闭回调

setAdEventListener(AdEventListener)

设置曝光/点击事件回调

disableShake()

关闭摇一摇

getECPM()

获取出价(单位分),PD模式返回-1

isValid()

广告是否有效

isVideo()

是否为视频广告

getVideoPlayer()

获取视频播放器

setVideoListener(VideoListener)

设置视频播放回调

isDownloadApp()

是否为下载类广告

getAppInfo()

获取下载类广告的应用信息

win(Double highestLossPrice)

竞胜后调用,用于优化广告填充

loss(Double winPrice, LossReason reason)

竞败后调用,用于优化广告填充

AdEventListener

方法

说明

onExposed()

曝光回调

onClicked(View view)

点击回调

onError(int code, String message)

错误回调

AdRenderListener

扩展 AdLoadListener,区分广告填充和素材渲染两个阶段,适用于被聚合场景:

方法

说明

onSuccess(AdType, AdDisplay)

广告请求成功,可用于比价

onFailure(AdType, String)

广告请求失败

onRenderSuccess(AdType, AdDisplay)

素材加载完成,可以展示

onRenderFailure(AdType, String)

素材渲染失败

调用示例

UMAdConfig config = new UMAdConfig.Builder().setSlotId("your_slot_id").build();
UMUnionSdk.getApi().loadInterstitialAd(activity, config,
    new UMUnionApi.AdRenderListener<UMUnionApi.AdDisplay>() {
        @Override
        public void onSuccess(UMUnionApi.AdType type, UMUnionApi.AdDisplay display) {
            // 广告请求成功,可用于比价
        }
        @Override
        public void onFailure(UMUnionApi.AdType type, String message) { }

        @Override
        public void onRenderSuccess(UMUnionApi.AdType type, UMUnionApi.AdDisplay display) {
            // 素材加载完成,可以展示
            display.setAdCloseListener(t -> { });
            display.setAdEventListener(new UMUnionApi.AdEventListener() {
                @Override public void onExposed() { }
                @Override public void onClicked(View v) { }
                @Override public void onError(int code, String msg) { }
            });
            display.show(activity);
        }
        @Override
        public void onRenderFailure(UMUnionApi.AdType type, String message) {
            // 素材渲染失败
        }
    });