ZJSDK

开屏广告

开屏广告

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

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

请求开屏广告

调用ZJSdk#loadSplashAd(posId: string, loadListener: ZJLoadListener)方法请求广告

export class ZJSdk {
    /**
     * 加载开屏广告
     * @param posId         广告位ID
     * @param loadListener  加载回调
     */
    static loadSplashAd(posId: string, loadListener: ZJLoadListener)
}

ZJLoadListener 说明

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

检查开屏广告有效性

如果开屏广告为预加载，需要在展示前调用ZJSdk#isSplashAdValid()方法判断当前缓存的广告对象是否有效，无效时需要重新请求广告

export class ZJSdk {
    /**
     * 校验开屏广告是否有效
     * @returns 是否有效，有效时可以调用show方法展示，无效时需要重新加载
     */
    static isSplashAdValid(): boolean 
}

展示开屏广告

调用ZJSDK#showSplashAd(interactionListener: ZJInteractionListener)方法，展示广告

export class ZJSdk {
    /**
     * 展示开屏广告
     * @param interactionListener 交互回调
     */
    static showSplashAd(interactionListener: ZJInteractionListener)
}

ZJInteractionListener 说明

方法说明
onError: (errCode: Number, errMsg: string) => void广告展示失败
code: 错误码
msg: 错误信息
onAdShow: () => void展示成功，只回调一次
onAdClick: () => void广告点击，会多次回调
onAdClose: () => void广告关闭

开屏广告接入示例

scripts/demo/PopPanle.ts
this.CreateTextBtnItem("加载开屏广告", () => {
    ZJSdk.loadSplashAd(this.splashAdPosId, {
        onAdLoaded() {
            log.insert("开屏广告加载成功");
        }, onError(errCode, errMsg) {
            log.insert(`开屏广告加载失败，错误码:${errCode}，错误信息:${errMsg}`);
        }
    })
});
this.CreateTextBtnItem("检查广告是否有效", () => {
    log.insert(`开屏广告状态: ${ZJSdk.isSplashAdValid() ? "有效" : "无效"}`);
});
this.CreateTextBtnItem("显示开屏广告", () => {
    ZJSdk.showSplashAd({
        onError(errCode: Number, errMsg: string) {
            log.insert(`开屏广告展示失败，错误码:${errCode}，错误信息:${errMsg}`);
        },
        onAdShow() {
            log.insert("开屏广告展示");
        },
        onAdClick() {
            log.insert("开屏广告点击");
        },
        onAdClose() {
            log.insert("开屏广告关闭");
        }
    })
});
目录