ZJSDK

应用内竞价

应用内竞价

说明

ZJSDK提供应用内竞价功能，当您使用ZJSDK进行实时竞价时，需要将竞价的结果调用相应接口回传。

当前版本仅支持激励广告。

获取价格

在预加载方法调用后 event 为ZJEvent.LOAD的回调时，可以通过errCode参数获取当前预加载广告的实时价格并进行比价。

注意

  • 获取价格需要联系商务开通权限，默认返回价格为0

  • 仅预加载广告且需要进行比价时，才需要调用以下借口回传竞价信息。若仅为预加载，并不与外部其他广告源进行比价，不要调用回传接口回传错误的竞价信息

  • 错误的竞价信息会影响广告收益，请如实填写尽可能多的内容

回传竞胜

ZJSDK返回的广告对象竞胜后展示前，需要调用onRewardedAdBidSuccess方法，回传竞败方最高出价的相关信息

class ZJAndroid {
    /**
     * 通知SDK激励广告竞胜
     * 非二次竞价不需要调用
     * 调用时需要按照注释传入对应的真实价格、类型、adnId，错误的数据会影响收益
     * @param secondECPM  竞败方最高价
     * @param secondType  竞败方出价类型
     * @param secondAdnId 竞败方最高价的AdnID
     */
    static onRewardedAdBidSuccess(secondECPM: number, secondType: number = 3, secondAdnId: number = 10)
}

回传竞败

ZJSDK返回的广告对象竞败后，需要调用onRewardedAdBidFailed方法，回传竞胜方的相关信息

class ZJAndroid {
    /**
     * 激励广告竞败后，上报失败原因
     * 非二次竞价不需要调用
     * 调用时需要按照注释传入对应的真实价格、类型、adnId，错误的数据会影响收益
     * @param reasonCode            竞价失败原因码
     * @param firstECPM             竞胜方出价
     * @param [firstType=3]         竞胜方出价类型
     * @param [firstAdnId=10]       竞胜方的AdnID
     * @param [ts=0]                竞价发生的时间戳，单位毫秒
     * @param [adUserName='']       竞胜方广告主名称
     * @param [adTitle='']          竞胜方广告标题
     * @param [adnMaterialType=9]   竞胜方物料类型
     * @param [adnMaterialUrl='']   竞胜方物料URL
     * @param [isShow=false]        是否已展示
     * @param [isClick=false]       是否已点击
     */
    static onRewardedAdBidFailed(reasonCode: number, firstECPM: number, firstType: number = 3, firstAdnId: number = 10, ts: number = 0, adUserName: string = '', adTitle: string = '', adnMaterialType: number = 9, adnMaterialUrl: string = '', isShow: boolean = false, isClick: boolean = false) 
}

参数说明

出价类型

值说明
1分层保价
2固定价格
3实时竞价
4其他

AdnId

值说明
1ZJSDK
2穿山甲/头条广告
3优量汇/广点通/腾讯广告
4百度联盟/百青藤
5Mintegral
6快手广告
7阿里TANX
8趣盟/趣头条
9Sigmob
10其他

竞价失败原因

值说明
101价格低于媒体侧底价
102竞价失败
103请求超时
104主动屏蔽（物料原因、竞品、频控）
201其他原因

物料类型

值说明
1横版图片
2竖版图片
3组图
4横版视频
5竖版视频
6直播
7横幅
9未知
目录