ZJSDK

开屏广告

开屏广告

此章节将演示如何请求在原生环境下请求与展示开屏广告

开屏广告在 App 启动时展现。用户可以点击广告跳转到广告落地页，或者点击右上角的跳过按钮，跳转到 App 内容首页

全屏半屏
开屏广告全屏开屏广告半屏

请求开屏广告

调用ZJSplashAd#loadAd的重载方法请求广告，并在ZJSplashAdLoadListener中获取广告对象与处理错误信息

public class ZJSplashAd {

    public static void loadAd(Activity activity, @NonNull String posId, ZJSplashAdLoadListener loadListener);

    /**
     * 加载广告
     *
     * @param activity     当前Activity
     * @param posId        广告位ID
     * @param widthDP      期望宽，单位DP，部分联盟需要额外配置
     * @param heightDP     期望高，单位DP，部分联盟需要额外配置
     * @param loadListener 加载回调
     */
    public static void loadAd(Activity activity, String posId, int widthDP, int heightDP, ZJSplashAdLoadListener loadListener);

}

加载回调说明

方法说明
onError(int code, String msg)广告加载出错
code: 错误码
msg: 错误信息
onAdLoaded(ZJSplashAd splashAd)广告加载成功
splashAd: 广告对象

提示

开屏报错找不到广告位或SDK初始化失败等问题见常见问题-开屏

展示开屏广告

在加载成功回调中获取到ZJSplashAd对象后，可以配置交互回调，并展示广告

ZJSplashAd 说明

方法说明
setAdInteractionListener(ZJSplashAdInteractionListener interactionListener)配置交互回调
show(ViewGroup container)传入广告容器展示

注意

开屏广告容器需要width == 100% 屏幕宽且height >= 90% 屏幕高，否则会影响计费

交互回调说明

方法说明
onSplashAdShow()广告展示
onSplashAdClick()广告点击
onSplashAdShowError(int code, String msg)广告展示失败
code: 错误码
msg: 错误信息
onSplashAdClose()广告关闭

开屏广告接入示例

注意

为避免广告落地页被应用主页覆盖的情况，需要对开屏 activity 的 onPause()、onResume()、onSplashAdClick()、onSplashAdClose()回调做判断处理。具体参考 Demo 工程的 SplashActivity


    private var isPaused = false       // 广告被点击后，当前activity是否pause
    private var isAdClicked = false    // 广告被点击
    private var isAdClosed = false     // 广告已结束

    private fun loadAd() {
        // 加载广告
        ZJSplashAd.loadAd(this, posId, object : ZJSplashAdLoadListener {
            
            override fun onError(code: Int, msg: String) {
                Log.e("ZJSplashAd", "开屏广告加载出错$code-$msg")
            }

            override fun onAdLoaded(splashAd: ZJSplashAd) {
                // 广告加载成功，配置交互回调
                splashAd.setAdInteractionListener(this@SplashActivity)
                splashAd.show(this@SplashActivity.container)
            }

        })
    }

    override fun onPause() {
        super.onPause()
        if (isAdClicked) {
            isPaused = true
        }
    }

    override fun onResume() {
        super.onResume()
        if (isPaused && isAdClosed) {
            jump()
        } else {
            isPaused = false
        }
    }
    
    //==================================================ZJSplashAdInteractionListener

    /**
     * 开屏点击
     */
    override fun onSplashAdClick() {
        isAdClicked = true
    }

    /**
     * 关闭
     */
    @Override
    override fun onSplashAdClose() {
        isAdClosed = true
        if (!isPaused) {
            jump()
        }
    }



    private boolean isPaused;        // 广告被点击后，当前activity是否pause
    private boolean isAdClicked;    // 广告被点击
    private boolean isAdClosed;     // 广告已结束

    private void loadAD() {
        // 加载广告
        ZJSplashAd.loadAd(this, posId, new ZJSplashAdLoadListener() {

            @Override
            public void onError(int code, @NonNull String msg) {
                Log.e("ZJSplashAd", "开屏广告加载出错" + code + "-" + msg);        
            }

            @Override
            public void onAdLoaded(@NonNull ZJSplashAd splashAd) {
                // 广告加载成功，配置交互回调
                splashAd.setAdInteractionListener(SplashActivity.this);
                splashAd.show(this.container);
            }

        });
    }

    /**
     * 记录应用pause
     */
    @Override
    protected void onPause() {
        super.onPause();
        if (isAdClicked) {
            isPaused = true;
        }
    }

    /**
     * 记录应用resume
     */
    @Override
    protected void onResume() {
        super.onResume();
        if (isPaused && isAdClosed) {
            jump();
        } else {
            isPaused = false;
        }
    }
    
    //==================================================ZJSplashAdInteractionListener

    /**
     * 开屏点击
     */
    @Override
    public void onSplashAdClick() {
        isAdClicked = true;
    }

    /**
     * 关闭
     */
    @Override
    public void onSplashAdClose() {
        isAdClosed = true;
        if (!isPaused) {
            jump();
        }
    }
目录