跳转到主要内容
PRODUCT DOCUMENTS

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

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

浮窗广告

简介

在应用内窗口顶部悬浮展示的广告,一段时间后自动消失。

接口说明

方法

说明

UMUnionSdk.loadFloatingBannerAd(Activity, UMAdConfig)

请求并直接展示(简单模式)

UMUnionSdk.loadFloatingBannerAd(Activity, UMAdConfig, AdCloseListener)

请求并直接展示(带关闭回调)

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

Load/Show分离模式

AdDisplay(通用显示接口)

方法

说明

show(Activity activity)

显示广告,必须传入Activity

isReady()

素材是否就绪

destroy()

释放资源

setAdCloseListener(AdCloseListener)

设置关闭回调

setAdEventListener(AdEventListener)

设置曝光/点击事件回调

disableShake()

关闭摇一摇

getECPM()

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

isValid()

广告是否有效

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().loadFloatingBannerAd(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.show(activity);
        }
        @Override
        public void onRenderFailure(UMUnionApi.AdType type, String message) {
            // 素材渲染失败
        }
    });