Cloud-DSP通过BidResponse返回参与竞价的广告,本节将介绍BidResponse对象。
4.1 BidResponse Object
BidResponse对象是一次竞价响应的主题内容,包含了参与此次竞价的广告创意信息及出价信息,具体结构如下:
Field |
Type |
Description |
id |
string |
与BidRequest保持一致,用于上游将Response和Request进行匹配 |
seatbid |
object[] |
SeatBid对象列表,如果DSP参与此次竞价,则列表中至少会包含一个SeatBid对象 |
bidid |
string |
DSP生成的响应ID,用于日志和行为跟踪 |
4.2 SeatBid Object
Field |
Type |
Description |
bid |
object[] |
竞价广告信息 |
seat |
string |
一般填充参与此次竞价的广告主ID,用于日志和行为跟踪 |
group |
bool |
标识是否允许每个Imp独立竞赢,缺省值标识允许独立竞赢 |
4.3 Bid Object
Field |
Type |
Description |
impid |
string |
此次竞价关联的Imp id,与Request中的Imp对象的id对应 |
bidtype |
int |
此次竞价的出价类型 0 - CPM 1 - CPC 2 - CPD 3 - CPT |
price |
int |
当前广告出价,单位:分 |
adm |
string |
广告创意的HTML内容,返回非原生广告的时候会填写该值 |
admvideo |
string |
视频广告返回的VAST内容 |
admnative |
object |
原生广告内容,在返回原生广告的时候会填充AdmNative对象 |
crid |
string |
广告创意ID,用于日志和行为跟踪 |
extdata |
string |
DSP返回的自定义数据,可以用来替换adm、admvideo、admnative中的宏${AUCTION_EXTDATA} |
4.3.1 AdmNative Object
Field |
Type |
Description |
assets |
object[] |
原生广告的元素列表 |
link |
object |
点击链接 |
imptrackers |
string[] |
展现监控url列表 |
dsplogo |
object |
根据广告法要求,在展现广告的时候需要将广告提供平台的logo显示在广告创意中,通过Image对象提供 |
adlabel |
object |
根据广告法要求,在展现广告的时候,需要显式对广告进行标注,通过Image对象提供“广告”标注信息 |
actiontrackers |
objects[] |
原生广告的动作行为跟踪需要用到的相关日志信息 |
4.3.2 Asset Object
Field |
Type |
Description |
id |
int |
需要与请求中的asset id保持一致 |
required |
bool |
为True标识该元素必须被展现 |
title |
object |
原生广告的创意信息 |
img |
object |
原生广告的图片信息 |
data |
object |
原生广告的其他元素信息 |
link |
object |
每个元素的点击链接,缺省时默认调用AdmNative对象的点击链接 |
4.3.2.1 Title Object
Field |
Type |
Description |
text |
string |
原生广告标题的文本内容 |
4.3.2.2 Data Object
Field |
Type |
Description |
value |
string |
原生广告元素内容 |
4.3.3 Link Object
Field |
Type |
Description |
url |
string |
点击的landing page |
clicktrackers |
string[] |
点击行为的监控URL |
4.3.4 Image Object
Field |
Type |
Description |
url |
string |
图片的URL |
w |
int |
图片宽度 |
h |
int |
图片高度 |
4.3.5 ActionTracker Object
Field |
Type |
Description |
type |
int |
原生广告的需要跟踪的动作类型 |
urls |
string[] |
动作发生时的汇报URL |
4.3.5.1 ActionType Object
Value |
Description |
ACTION_APP_DOWNLOAD_START |
应用下载开始 |
ACTION_APP_DOWNLOAD_COMPLETE |
应用下载完成 |
ACTION_APP_INSTALL_COMPLETE |
应用安装完成 |
ACTION_APP_ACTIVE_COMPLETE |
应用激活完成 |
ACTION_VIDEO_PLAY_START |
视频播放开始 |
ACTION_VIDEO_PLAY_INTERRUPT |
视频播放中断 |
ACTION_VIDEO_PLAY_COMPLETE |
视频播放结束 |