应用内竞价
应用内竞价
说明
ZJSDK提供应用内竞价功能，当您使用ZJSDK进行实时竞价时，需要将竞价的结果调用相应接口回传。
获取广告实时价格
注意
获取价格需要联系商务开通权限，默认返回价格为0
仅将ZJSDK返回的广告对象与外部广告源进行比价时需要调用以下借口回传竞价信息。若仅获取价格，不与外部广告源进行比价，不要调用回传接口回传错误的竞价信息
错误的竞价信息会影响广告收益，请如实填写尽可能多的内容
/**
* 获取价格，需要开通权限
*
* @return 当前广告ECPM，单位为分
*/
int getECPM();
竞胜回传接口
ZJSDK返回的广告对象竞胜后展示前，需要调用onBidSuccess接口，回传竞败方最高出价的相关信息
/**
* 竞胜后回传竞败方最高出价相关信息
*
* @param successInfo 竞败方信息
*/
void onBidSuccess(@NonNull BidSuccessInfo successInfo);
BidSuccessInfo 说明
| 构造方法 | 参数 | 说明 |
|---|---|---|
| public BidSuccessInfo(int secondECPM) | secondECPM - 竞败方最高价 | 必传 |
| public BidSuccessInfo(int secondECPM, int secondType, @BidAdnId int secondAdnId) | secondECPM - 竞败方最高价 secondType - 竞败方出价类型 secondAdnId - 竞败方最高价的AdnID | 竞败方最高价必传 竞败方出价类型 1-分层保价 2-固定价格 3-实时竞价 4-其他 AdnID见【BidAdnId 说明】 |
竞败回传接口
ZJSDK返回的广告对象竞败时，需要调用onBidFailed接口，回传竞胜方的相关信息
/**
* 广告竞败后，上报失败原因
*
* @param failedReason 竞败原因
*/
void onBidFailed(@NonNull BidFailedReason failedReason);
BidFailedReason 说明
| 方法 | 说明 | 默认值 |
|---|---|---|
| BidFailedReason(@BidFailedReasonCode int reasonCode, int firstECPM) | reasonCode - 竞败原因，见【BidFailedReasonCode 说明】 firstECPM - 竞胜方出价 | 必传 |
| void setBidType(int bidType) | 设置竞胜方出价类型 | 1-分层保价 2-固定价格 3-实时竞价 4-其他 |
| void setAdnId(@BidAdnId int adnId) | 设置竞胜方的AdnID，见【BidAdnId 说明】 | BidAdnId.OTHER |
| void setTS(long ts) | 设置竞价发起的时间戳，单位毫秒。如无特殊需要请勿配置 | 0L |
| void setAdUserName(String adUserName) | 设置竞胜方广告主名称 | "" |
| void setAdTitle(String adTitle) | 设置竞胜方广告标题 | "" |
| void setAdnMaterialType(@BidMaterialType int adnMaterialType) | 设置竞胜方物料类型，见【BidMaterialType 说明】 | BidMaterialType.REPORT_MATERIAL_TYPE_OTHER |
| void setAdnMaterialUrl(String adnMaterialUrl) | 设置竞胜方物料URL | "" |
| void setIsShow(@BidEventStatus int isShow) | 设置是否已展示，见【BidEventStatus 说明】 | BidEventStatus.UNKNOWN |
| void setIsClick(@BidEventStatus int isClick) | 是否已点击，见【BidEventStatus 说明 】 | BidEventStatus.UNKNOWN |
参数的注解说明
BidAdnId 说明
| 值 | 说明 |
|---|---|
| BidAdnId.ZJ | ZJSDK |
| BidAdnId.PANGLE | 穿山甲/头条广告 |
| BidAdnId.GDT | 优量汇/广点通/腾讯广告 |
| BidAdnId.BD | 百度联盟/百青藤 |
| BidAdnId.MINTEGRAL | Mintegral |
| BidAdnId.KS | 快手联盟 |
| BidAdnId.TANX | 阿里TANX |
| BidAdnId.QM | 趣盟/趣头条 |
| BidAdnId.SIGMOB | Sigmob |
| BidAdnId.OTHER | 其他 |
BidFailedReasonCode 说明
| 值 | 说明 |
|---|---|
| BidFailedReasonCode.BID_FLOOR | 价格低于媒体侧底价 |
| BidFailedReasonCode.LOW_PRICE | 竞价失败 |
| BidFailedReasonCode.TIMEOUT | 请求超时 |
| BidFailedReasonCode.BLOCK | 主动屏蔽（物料原因、竞品、频控） |
| BidFailedReasonCode.OTHER | 其他原因 |
BidMaterialType 说明
| 值 | 说明 |
|---|---|
| BidMaterialType.REPORT_MATERIAL_TYPE_IMG_HORIZONTAL | 横版图片 |
| BidMaterialType.REPORT_MATERIAL_TYPE_IMG_VERTICAL | 竖版图片 |
| BidMaterialType.REPORT_MATERIAL_TYPE_IMG_GROUP | 组图 |
| BidMaterialType.REPORT_MATERIAL_TYPE_VIDEO_HORIZONTAL | 横版视频 |
| BidMaterialType.REPORT_MATERIAL_TYPE_VIDEO_VERTICAL | 竖版视频 |
| BidMaterialType.REPORT_MATERIAL_TYPE_STREAMING | 直播 |
| BidMaterialType.REPORT_MATERIAL_TYPE_BANNER | 横幅 |
| BidMaterialType.REPORT_MATERIAL_TYPE_OTHER | 未知 |
BidEventStatus 说明
| 值 | 说明 |
|---|---|
| BidEventStatus.UNKNOWN | 未知 |
| BidEventStatus.TRIGGERED | 已触发 |