应用内竞价
应用内竞价
说明
AdBox提供应用内竞价功能，当您使用AdBox进行实时竞价时，需要将竞价的结果调用相应接口回传。
获取广告实时价格
注意
获取价格需要联系商务开通权限，默认返回价格为0
仅将
AdBox返回的广告对象与外部广告源进行比价时需要调用以下接口回传竞价信息。若仅获取价格，不与外部广告源进行比价，不要调用回传接口回传错误的竞价信息错误的竞价信息会影响广告收益，请如实填写尽可能多的内容
/**
* 获取价格，需要开通权限
*
* @return 当前广告eCPM，单位为分
*/
- (NSInteger)eCPM;
竞胜回传接口
AdBox返回的广告对象竞胜后展示前，需要调用- (void)setBidEcpm:(NSInteger)ecpm highestLossEcpm:(NSInteger)highestLossEcpm接口，回传竞败方最高出价的相关信息
/**
* @brief 设置竞价价格，单位（分）
* @param ecpm 竞胜成功的价格，广告的最高价格
* @param highestLossEcpm 最大竞价失败方出价，广告的次高价格
*/
- (void)setBidEcpm:(NSInteger)ecpm
highestLossEcpm:(NSInteger)highestLossEcpm;
竞败回传接口
AdBox返回的广告对象竞败时，需要调用- (void)reportAdExposureFailed:(SYAdExposureFailureCode)failureCode reportParam:(SYAdExposureReportParam *)reportParam接口，回传竞胜方的相关信息
/**
* @brief 广告曝光失败后上报失败原因
* @param failureCode 曝光失败原因类型
* @param reportParam 曝光失败原因描述
* reportParam.winEcpm 胜出者的ecpm报价（单位：分）
* reportParam.adnType 胜出方，见SYAdExposureReportParam.h 中SYAdExposureAdnType定义
* reportParam.adnName 胜出平台名，见SYAdExposureReportParam.h 中SYAdADNName平台定义
*/
- (void)reportAdExposureFailed:(SYAdExposureFailureCode)failureCode reportParam:(SYAdExposureReportParam *)reportParam;
SYAdExposureReportParam 说明
| 方法 | 说明 |
|---|---|
| winEcpm | 胜出者的ecpm报价 |
| adnType | 竞胜平台类型 |
| adnName | 竞胜平台名称 |
| adUserName | 设置竞胜方广告主名称 |
| adTitle | 设置竞胜方广告标题 |
| adnMaterialType | 设置竞胜方物料类型 |
| adnMaterialUrl | 设置竞胜方物料URL |
| isShow | 竞胜方dsp本次请求是否展示 |
| isClick | 竞胜方dsp本次请求是否被点击 |
参数的注解说明
SYAdExposureAdnType 说明
| 值 | 说明 |
|---|---|
| SYAdExposureAdnTypeKuaishou | 输给快手联盟其他广告 |
| SYAdExposureAdnTypeOther | 输给其他ADN |
| SYAdExposureAdnTypeSelfSale | 输给自售广告主 |
SYAdADNName 说明
| 值 | 说明 |
|---|---|
| SYAdADNNameDSP | ZJ |
| SYAdADNNameChuanshanjia | 穿山甲/头条广告 |
| SYAdADNNameGuangdiantong | 优量汇/广点通/腾讯广告 |
| SYAdADNNameBaidu | 百度联盟/百青藤 |
| SYAdADNNameKS | 快手联盟 |
| SYAdADNNameBeiZi | 倍孜 |
| SYAdADNNameQuMeng | 趣盟/趣头条 |
| SYAdADNNameSIGMOB | Sigmob |
| SYAdADNNameOther | 其他 |
SYAdExposureFailureCode 说明
| 值 | 说明 |
|---|---|
| SYAdExposureFailureMediaBasePriceFilter | 价格低于媒体侧底价 |
| SYAdExposureFailureBidFailed | 竞价失败 |
| SYAdExposureFailureCacheInvalid | 缓存失效 |
| SYAdExposureFailureExposurePriorityReduce | 曝光优先级降低 |
| SYAdExposureFailureExposureReturnTimeout | 请求超时 |
| SYAdExposureFailureExposureMediaBlocking | 主动屏蔽（物料原因、竞品、频控） |
| SYAdExposureFailureOther | 其他原因 |
SYAdExposureAdnMaterialType 说明
| 值 | 说明 |
|---|---|
| SYAdExposureAdnMaterialTypeHorizontalImg | 横版图片 |
| SYAdExposureAdnMaterialTypeVerticalImg | 竖版图片 |
| SYAdExposureAdnMaterialTypeThreeImg | 组图 |
| SYAdExposureAdnMaterialTypeHorizontalVideo | 横版视频 |
| SYAdExposureAdnMaterialTypeVerticalVideo | 竖版视频 |
| SYAdExposureAdnMaterialTypeStreamer | 横幅 |
| SYAdExposureAdnMaterialTypeOther | 未知 |
SYAdBiddingActionType 说明
| 值 | 说明 |
|---|---|
| SYAdBiddingActionTypeNone | 未点击&未曝光 |
| SYAdBiddingActionTypeSuccess | 点击&曝光 |
| SYAdBiddingActionTypeUnkown | 未知 |