跳转到主要内容
PRODUCT DOCUMENTS

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

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

悬浮球广告

简介

在应用页面内悬浮呈现的广告(如右下角红包)。

接口说明

方法

说明

UMUnionSdk.getApi().loadFloatingIconAd(Activity, UMAdConfig, AdLoadListener<UMFloatingIconAD>)

请求悬浮球广告

UMFloatingIconAD 特有接口

方法

说明

initPosition(int x, int y)

设置初始位置,屏幕左上角为原点,单位px

setAllowedActivities(List<Class<? extends Activity>>)

设置允许显示的Activity列表

setAutoDismissOnTap(boolean)

设置点击时是否自动关闭

通用接口(继承自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, UMFloatingIconAD)

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

onFailure(AdType, String)

广告请求失败

onRenderSuccess(AdType, UMFloatingIconAD)

素材加载完成,可以展示

onRenderFailure(AdType, String)

素材渲染失败

调用示例

ArrayList<Class<? extends Activity>> blacklist = new ArrayList<>();
blacklist.add(SplashActivity.class);
UMUnionSdk.setAdBlacklist(blacklist);

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

        @Override
        public void onRenderSuccess(UMUnionApi.AdType type, UMFloatingIconAD display) {
            // 素材加载完成,可以展示
            display.setAdCloseListener(t -> { });
            display.show(activity);
        }
        @Override
        public void onRenderFailure(UMUnionApi.AdType type, String message) {
            // 素材渲染失败
        }
    });