4. BidResponse

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 视频播放结束