开屏广告
简介
在App启动时展示的全屏广告。
接口说明
方法 | 说明 |
UMUnionSdk.loadSplashAd(UMAdConfig cfg, AdLoadListener<UMSplashAD> listener, int timeout) | 请求开屏广告，timeout有效值：1500~5000ms |
UMSplashAD
方法 | 说明 |
show(ViewGroup container) | 显示广告，必须传入ViewGroup容器 |
setAdEventListener(SplashAdListener listener) | 设置事件回调 |
disableCountdown() | 关闭倒计时，需开发者自行实现 |
disableShake() | 关闭摇一摇 |
disableVideoMute() | 关闭视频静音，仅视频广告有效 |
getECPM() | 获取出价（单位分），PD模式返回-1 |
isValid() | 广告是否有效 |
isVideo() | 是否为视频广告 |
getVideoPlayer() | 获取视频播放器 |
win(Double highestLossPrice) | 竞胜后调用，用于优化广告填充 |
loss(Double winPrice, LossReason reason) | 竞败后调用，用于优化广告填充 |
SplashAdListener
方法 | 说明 |
onExposed() | 曝光回调 |
onClicked(View view) | 点击回调 |
onDismissed() | 广告消失回调 |
onError(int code, String message) | 错误回调 |
AdRenderListener
扩展 AdLoadListener，区分广告填充和素材渲染两个阶段，适用于被聚合场景：
方法 | 说明 |
onSuccess(AdType, UMSplashAD) | 广告请求成功，可用于比价 |
onFailure(AdType, String) | 广告请求失败 |
onRenderSuccess(AdType, UMSplashAD) | 素材加载完成，可以展示 |
onRenderFailure(AdType, String) | 素材渲染失败 |
调用示例
UMAdConfig config = new UMAdConfig.Builder().setSlotId("your_slot_id").build();
UMUnionSdk.loadSplashAd(config, new UMUnionApi.AdRenderListener<UMSplashAD>() {
@Override
public void onSuccess(UMUnionApi.AdType type, UMSplashAD display) {
// 广告请求成功，可用于比价
}
@Override
public void onFailure(UMUnionApi.AdType type, String message) {
goHome();
}
@Override
public void onRenderSuccess(UMUnionApi.AdType type, UMSplashAD display) {
// 素材加载完成，可以展示
display.setAdEventListener(new UMUnionApi.SplashAdListener() {
@Override public void onDismissed() { goHome(); }
@Override public void onExposed() { }
@Override public void onClicked(View v) { }
@Override public void onError(int code, String msg) { }
});
display.show(container);
}
@Override
public void onRenderFailure(UMUnionApi.AdType type, String message) {
// 素材渲染失败
goHome();
}
}, 5000);