Skip to content

开屏广告

WARNING

请在广告初始化成功后调用, 另外所有API请在UI线程中调用。

自动开屏广告

因为开屏广告一般是作为启动屏展示, 结合U8聚合SDK提供的分包工具, 我们支持自动将开屏广告作为启动屏(启动Activity),无需游戏开发者接入, 只需要在后台广告参数中打开开关,配置好广告位ID即可:

U8聚合广告-自动开屏

按上图配置后,通过U8聚合SDK打包工具分包后, 就可以测试开屏广告效果了。

但是,请注意, 自动开屏广告也有一定的局限性:

创建广告

使用插屏广告时,先创建插屏广告对象:VXSplashAd

java
VXSplashAd splashAd = new VXSplashAd(activity, adId);

参数说明:

参数名称参数类型参数说明
activityActivity当前游戏调用广告的宿主Activity
adIdString聚合SDK后台创建的聚合广告位ID,如果还没创建,可以参考文档:获取广告参数

设置广告回调

开屏广告在加载、播放、 关闭、点击等时机,都会通过监听回调接口,通知给游戏层:

java

ISplashAdListener splashAdListener = new ISplashAdListener() {
    @Override
    public void onFailed(int code, String msg) {
        // 广告播放失败
    }

    @Override
    public void onLoadFailed(int code, String msg) {
        // 广告加载失败
    }

    @Override
    public void onLoaded() {
        // 广告加载成功, 可以展示
        if (splashAd.isReady()) {
            splashAd.show(AdDemoActivity.this);
        }
    }

    @Override
    public void onShow() {
        // 广告曝光成功
    }

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

    @Override
    public void onClosed() {
        // 广告被关闭
    }

    @Override
    public void onSkip() {
        // 广告被跳过
    }
};

splashAdListener.setAdListener(splashAdListener);

加载广告

设置好监听器类后, 在需要的时机可以加载开屏广告:

java
splashAd.load(activity);

广告加载成功, 会触发上面监听器中的onLoaded事件; 加载失败, 会触发上面监听器中的onLoadFailed事件。

播放广告

广告加载成功后, 就可以在玩家点击广告播放按钮时,进行播放了:

java
if (splashAd.isReady()) {
    splashAd.show(activity);
}

建议调用播放之前, 先通过isReady函数判断当前广告是否就绪, 如果就绪再播放。

版权所有© 2021-2030 上海丞诺网络科技有限公司