ZJSDK

应用内竞价

应用内竞价

说明

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

获取广告实时价格

注意

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

  • 仅将ZJSDK返回的广告对象与外部广告源进行比价时需要调用以下接口回传竞价信息。若仅获取价格，不与外部广告源进行比价，不要调用回传接口回传错误的竞价信息

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


    /**
     * 获取价格，需要开通权限
     *
     * @return 当前广告eCPM，单位为分
     */
    - (NSInteger)eCPM;

竞胜回传接口

ZJSDK返回的广告对象竞胜后展示前，需要调用- (void)setBidEcpm:(NSInteger)ecpm highestLossEcpm:(NSInteger)highestLossEcpm接口，回传竞败方最高出价的相关信息


/**
 * @brief 设置竞价价格，单位（分）
 * @param ecpm              竞胜成功的价格，广告的最高价格
 * @param highestLossEcpm   最大竞价失败方出价，广告的次高价格
 */
- (void)setBidEcpm:(NSInteger)ecpm
   highestLossEcpm:(NSInteger)highestLossEcpm;

竞败回传接口

ZJSDK返回的广告对象竞败时，需要调用- (void)reportAdExposureFailed:(ZJAdExposureFailureCode)failureCode reportParam:(ZJAdExposureReportParam *)reportParam接口，回传竞胜方的相关信息


    /**
    * @brief 广告曝光失败后上报失败原因
    * @param failureCode 曝光失败原因类型
    * @param reportParam 曝光失败原因描述
    *        reportParam.winEcpm 胜出者的ecpm报价（单位：分）
    *        reportParam.adnType 胜出方，见ZJAdExposureReportParam.h 中ZJAdExposureAdnType定义
    *        reportParam.adnName 胜出平台名，见ZJAdExposureReportParam.h 中ZJAdADNType平台定义
    */
    - (void)reportAdExposureFailed:(ZJAdExposureFailureCode)failureCode reportParam:(ZJAdExposureReportParam *)reportParam;

ZJAdExposureReportParam 说明

方法说明
winEcpm胜出者的ecpm报价
adnType竞胜平台类型
adnName竞胜平台名称
adUserName设置竞胜方广告主名称
adTitle设置竞胜方广告标题
adnMaterialType设置竞胜方物料类型
adnMaterialUrl设置竞胜方物料URL
isShow竞胜方dsp本次请求是否展示
isClick竞胜方dsp本次请求是否被点击

参数的注解说明

ZJAdExposureAdnType 说明

值说明
ZJAdExposureAdnTypeKuaishou输给快手联盟其他广告
ZJAdExposureAdnTypeOther输给其他ADN
ZJAdExposureAdnTypeSelfSale输给自售广告主

ZJAdADNName 说明

值说明
BidAdnId.ZJZJSDK
ZJAdADNNameChuanshanjia穿山甲/头条广告
ZJAdADNNameGuangdiantong优量汇/广点通/腾讯广告
ZJAdADNNameBaidu百度联盟/百青藤
ZJAdADNNameKS快手联盟
ZJAdADNNameBeiZi倍孜
ZJAdADNNameQuMeng趣盟/趣头条
ZJAdADNNameSIGMOBSigmob
ZJAdADNNameOther其他

ZJAdExposureFailureCode 说明

值说明
ZJAdExposureFailureMediaBasePriceFilter价格低于媒体侧底价
ZJAdExposureFailureBidFailed竞价失败
ZJAdExposureFailureCacheInvalid缓存失效
ZJAdExposureFailureExposurePriorityReduce曝光优先级降低
ZJAdExposureFailureExposureReturnTimeout请求超时
ZJAdExposureFailureExposureMediaBlocking主动屏蔽（物料原因、竞品、频控）
ZJAdExposureFailureOther其他原因

ZJAdExposureAdnMaterialType 说明

值说明
ZJAdExposureAdnMaterialTypeHorizontalImg横版图片
ZJAdExposureAdnMaterialTypeVerticalImg竖版图片
ZJAdExposureAdnMaterialTypeThreeImg组图
ZJAdExposureAdnMaterialTypeHorizontalVideo横版视频
ZJAdExposureAdnMaterialTypeVerticalVideo竖版视频
ZJAdExposureAdnMaterialTypeStreamer横幅
ZJAdExposureAdnMaterialTypeOther未知

ZJAdBiddingActionType 说明

值说明
ZJAdBiddingActionTypeNone未点击&未曝光
ZJAdBiddingActionTypeSuccess点击&曝光
ZJAdBiddingActionTypeUnkown未知
目录