ZJSDK

插全屏广告

插全屏广告

插屏广告是移动广告的一种常见形式，在应用开流程中弹出，当应用展示插页式广告时，用户可以选择点按广告，访问其目标网址，也可以将其关闭，返回应用。

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

提示

插屏半屏和插屏全屏通过广告位来区分样式

请求插全屏广告

调用ZJSdk#loadInterstitialAd(posId: string, loadListener: ZJLoadListener, isVolumeOn: boolean = true)方法请求广告

export class ZJSdk {
    /**
     * 加载插屏广告
     * @param posId         广告位ID
     * @param loadListener  加载回调
     * @param isVolumeOn    是否开启声音
     */
    static loadInterstitialAd(posId: string, loadListener: ZJLoadListener, isVolumeOn: boolean = true)
}

ZJLoadListener 说明

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

检查插全屏广告有效性

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

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

展示插全屏广告

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

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

ZJInteractionListener 说明

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

插全屏广告接入示例

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