实时竞价接口
实时竞价接口
1: 基本协议信息
请求header:
SSP采用HTTP通信协议与喜马联盟广告平台交互，广告请求(Request)与响应(Response)使用protobuf(Google Protobuf V3)进行序列化
| 基本协议 | 说明 |
|---|---|
| HTTP METHOD | POST |
| Content_Type | application/x-protobuf |
| 广告请求URL | 测试和正式域名， 请联系喜马运营 |
2: 广告请求（BidRequest）
详情请参见: 协议说明-BidRequest
3：广告响应（BidResponse）
详情请参见: 协议说明-BidResponse
4: 监测
4.1: 曝光
impression_urls 为曝光监测地址，⼴告⼀经曝光，就会⽴即上报该数组的链接，上报会从用户手机上发起，上报⽅式为http get请求。如需要相关宏替换的操作，⻅4.4支持的宏替换。
4.2: 点击
click_urls 为点击监测地址，⼴告⼀经曝光，就会⽴即上报该数组的链接，上报会从用户手机上发起，上报⽅式为http get请求。如需要相关宏替换的操作，⻅4.4支持的宏替换。
4.3: 竞价成功/失败
win_notice_url 为竞价成功通知地址，需要对结算价格字段(__SETTLE_PRICE__)进行宏替换 loss_notice_url 为竞价失败通知地址，需要对结算价格字段(__LOSS_MESSAGE__)进行宏替换
4.4: 支持的宏替换
| 宏含义 | 宏 | 规范与取值 |
|---|---|---|
| 结算价格 | __SETTLE_PRICE__ | 单位：分/cpm，采用AES加密，模式使用：ECB，填充：pkcs5padding，数据块：128位；输出：hex；字符串：utf8；支持宏替换url：impression_urls、click_urls |
| 时间戳 | __TS__ | 精确到毫秒级，例如：1589168735000 |
| 曝光区域 | __IMP_AREA_X1_Y1_X2_Y2__ | 左上角(X1,Y1), 右下角(X2,Y2) |
| 点击区域 | __UP_X__, __UP_Y__, __DOWN_X__, __DOWN_Y__ | 点击坐标单位为像素、数值为素材图片左上角为起点的X和Y轴 __DOWN_X__：用户手指按下时的横坐标 __DOWN_Y__：用户手指按下时的纵坐标 __UP_X__：用户手指离开设备屏幕时的横坐标（目前上报的值=按下的横坐标）__UP_Y__：用户手指离开设备屏幕时的纵坐标（目前上报的值=按下的纵坐标） |
| 竞价失败原因 | __LOSS_MESSAGE__ | 竞价失败的原因 |