ZJSDK

激励广告

激励广告

激励广告是用户通过观看短视频，获取应用内奖励（游戏的复活，任务奖励，游戏金币）等，具体场景由开发者定义。

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

注意

激励广告需要传入正确的用户ID，错误或空的用户ID会影响收益

请求激励广告

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

export class ZJSdk {
    /**
     * 加载激励广告
     * @param posId         广告位ID
     * @param userId        用户ID
     * @param loadListener  加载回调
     * @param extra         透传信息
     * @param isVolumeOn    是否开启声音
     */
    static loadRewardedAd(posId: string, userId: string, loadListener: ZJLoadListener, isVolumeOn: boolean = true)
}

ZJLoadListener 说明

方法说明
onAdLoaded()广告加载成功
onError(int code, string msg)广告加载出错
code: 错误码
msg: 错误信息，媒体需要转成json，获取详细错误信息

展示激励广告

调用ZJSDK#showRewardedAd(interactionListener: ZJInteractionListener, rewardListener: ZJRewardListener)方法，展示广告

export class ZJSdk {
    /**
     * 展示激励广告
     * @param interactionListener 交互回调
     * @param rewardListener 奖励回调
     */
    static showRewardedAd(interactionListener: ZJInteractionListener, rewardListener: ZJRewardListener)
}

ZJInteractionListener 说明

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

ZJRewardListener 说明

方法说明
onAdReward: (extra:any) => void广告发奖，extra 内容请忽略

激励广告接入示例

scripts/demo/PopPanle.ts
this.CreateTextBtnItem("加载激励广告", () => {
    ZJSdk.loadRewardedAd(this.rewardAdPosId, this.userId, {
        onAdLoaded() {
            log.insert("激励广告加载成功");
        }, onError(errCode, errMsg) {
            log.insert(`激励广告加载失败，错误码:${errCode}，错误信息:${errMsg}`);
        }
    })
});

this.CreateTextBtnItem("显示激励广告", () => {
    ZJSdk.showRewardedAd({
        onError(errCode: Number, errMsg: string) {
            log.insert(`激励广告展示失败，错误码:${errCode}，错误信息:${errMsg}`);
        },
        onAdShow() {
            log.insert("激励广告展示");
        },
        onAdClick() {
            log.insert("激励广告点击");
        },
        onAdClose() {
            log.insert("激励广告关闭");
        }
    }, {
        onAdReward(extra) {
            log.insert(`激励广告发奖`);
        },
    })
});
目录