开屏广告

开屏广告

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

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

注意

cocos的iOS桥接接入,没有检查广告有效性的方法,所以媒体在对接时,不需要去验证广告的有效性,直接去加载广告和展示广告即可

请求开屏广告

调用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: 错误信息,媒体需要转成json,获取详细错误信息

展示开屏广告

调用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("显示开屏广告", () => {
    ZJSdk.showSplashAd({
        onError(errCode: Number, errMsg: string) {
            log.insert(`开屏广告展示失败,错误码:${errCode},错误信息:${errMsg}`);
        },
        onAdShow() {
            log.insert("开屏广告展示");
        },
        onAdClick() {
            log.insert("开屏广告点击");
        },
        onAdClose() {
            log.insert("开屏广告关闭");
        }
    })
});