菜单

开屏广告接入及API说明

开屏广告(Splash)

创建开屏广告配置

通过AMPSRequestParameters.Builder构建AMPSRequestParameters实例.

主要方法

方法名称	参数	描述
setTimeOut	long	设置请求超时时间. 毫秒
setSpaceId	String	设置广告位ID
build	-	构建实例

代码示例

复制代码

	AMPSRequestParameters parameters = new AMPSRequestParameters.Builder()
                .setSpaceId("开屏广告位ID") 
                .setTimeOut(5000)
                .build();

创建开屏广告

通过传入AMPSRequestParameters实例, 创建AMPSSplashAd实例, 并通过传入AMPSSplashLoadEventListener实例, 监听广告状态

代码示例

复制代码

    AMPSSplashLoadEventListener eventListener = new AMPSSplashLoadEventListener() {
            @Override
            public void onAmpsAdLoaded() {
                //广告请求成功
            }

            @Override
            public void onAmpsAdFailed(AMPSError ampsError) {
                //广告请求失败
            }

            @Override
            public void onAmpsAdShow() {
                //广告曝光
            }

            @Override
            public void onAmpsAdClicked() {
                //广告被点击
            }

            @Override
            public void onAmpsAdDismiss() {
                //广告关闭
            }
        };
	AMPSSplashAd splashAd = new AMPSSplashAd(context, parameters, eventListener);

广告监听主要方法

方法名称	参数	描述
onAmpsAdLoaded	-	广告加载成功
onAmpsAdShow	-	广告曝光
onAmpsAdClicked	-	广告被点击
onAmpsAdDismiss	-	广告关闭
onAmpsAdFailed	AMPSError	广告加载失败, 通过AMPSError获取错误码及错误信息

加载广告

调用loadAd方法,加载广告.

代码示例

复制代码

    splashAd.loadAd();

展示广告

在接收到广告监听onAmpsAdLoaded后,可以通过showAd()方法, 展示开屏广告. 传入展示开屏的容器ViewGroup

代码示例

复制代码

 	splashAd.showAd(container);

生命周期方法

在开屏广告展示的Activity中, 生命周期方法onResume()和onPause()中, 调用对应的pause()和resume()方法

代码示例

复制代码

	@Override
    protected void onPause() {
        super.onPause();
        if (splashAd != null) {
            splashAd.pause();
        }
    }

    @Override
    protected void onResume() {
        super.onResume();
        if (splashAd != null) {
            splashAd.resume();
        }
    }

销毁广告

在广告关闭onAdClosed()回调, 或Activity的生命周期方法onDestroy()时, 调用广告销毁方法destroy().

在哪里调用可根据应用逻辑调整, 但destroy()方法必须调用.

代码示例

复制代码

	//于关闭回调内调用
    @Override
    public void onAdClosed() {
        if (splashAd != null){ 
            splashAd.destroy();
            splashAd = null;
        }
    }
    

    //于生命周期内调用 


    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (splashAd != null) {
            splashAd.destroyAd();
            splashAd = null;
        }
    }

上一个

SDK初始化及API说明

下一个

插屏广告接入及API说明

最近修改: 2025-06-10

大纲