Cloud ADX

    BidResponse

    DSP通过BidResponse返回参与竞价的广告,本节将介绍BidResponse对象。

    BidResponse Object

    BidResponse结构如下图所示:

    image.png

    一个BidResponse中可包含多个SeatBid对象。通常,一个SeatBid代表DSP端的一个广告主。
    每个SeatBid中又可包含多个Bid对象,一个Bid代表一个参与竞价的广告,对应于BidRequest中的一个Imp对象。
    有两种方式可以表达”不参与竞价”这一语义:

    1. 返回 HTTP 204 No Content。
    2. 返回 HTTP 200 Ok,http body中的BidResponse的BidSeat列表为空。注意不可以返回一个空的http body。
    Field Mandatory Type Description
    id required string response id,必须和request id保持一致
    seatbid optional object[] seatbid列表,如果参与竞价,必须包含一个seatbid对象
    bidid optional string 由DSP生成的response id,用于 logging/tracking

    SeatBid Object

    Field Mandatory Type Description
    bid required object[] 竞价信息
    seat optional string 该次竞价是代表谁参与的
    一般设置成广告主id, 用于logging/tracking
    group optional int 是否允许对每个imp独立竞赢
    0 - 每个imp可独立竞赢
    1 - 必须同时竞赢所有的imp
    default = 0

    Bid Object

    Field Mandatory Type Description
    impid required string 该次竞价所关联的imp id
    bidtype required int 出价类型
    0 - CPM
    1 - CPC
    2 - CPD
    3 - CPT
    price required int 出价,单位:分
    crid optional string creative id, 用于logging/tracking
    adm optional string 广告html内容
    返回非原生广告时,必须填写该值
    dsp需要在该html内自行设置win-notice-url和第三方展现/点击监控
    admvideo optional string video广告的VAST内容
    admnative optional object 原生广告内容
    返回原生广告时,必须填写该值
    extdata optional string DSP返回的自定义数据,可通过宏${AUCTION_EXTDATA}引用
    • 当返回非原生广告时
      DSP需要将广告html内容填充进adm字段,并在该html中自行设置win-notice-url和第三方展现/点击监控url。所有的点击跳转行为必须使用<a>标签实现,Cloud-ADX将会替换所有的<a>标签中的href属性值,以监控点击跳转事件。
      DSP可以在adm中使用Cloud-ADX预定义的宏变量,Cloud-Adx会负责替换这些宏。
    • 当返回原生广告时
      DSP需要将原生广告信息填入AdmNative对象中,DSP可以在AdmNative中的各种url中使用宏变量,Cloud-ADX会负责替换这些宏。

    Cloud-ADX预定义的宏变量见4.1 Substitution Macros。

    AdmNative Object

    Field Mandatory Type Description
    assets optional object[] 原生广告元素列表
    link optional object 点击链接
    imptrackers optional string[] 展现监控url列表
    dsp需要将win-notice-url设置在其中

    Asset Object

    Field Mandatory Type Description
    id required int asset id,必须与请求中的asset id保持一致
    required optional int 设置为1表示该元素必须被展现
    default = 0
    title optional object 标题
    img optional object 图片
    video optional object 视频
    data optional object 其他原生元素
    link optional object 每个元素各自的点击链接
    若缺省,且该元素需要link对象时,父link对象会被使用

    Title Object

    Field Mandatory Type Description
    text requried string 标题文本内容

    Image Object

    Field Mandatory Type Description
    url requried string 图片url
    w recommended int 图片宽
    h recommended int 图片高

    Video Object

    Field Mandatory Type Description
    url required string 视频url
    w recommended int 视频宽
    h recommended int 视频高
    mime recommended int 视频格式
    duration recommended int 视频时长

    Data Object

    Field Mandatory Type Description
    value requried string 原生元素内容
    Field Mandatory Type Description
    url requried string 点击landing page
    clicktrackers optional string[] 点击监控url
    landingtype optional int URL点击后的打开方式
    上一篇
    BidRequest
    下一篇
    Appendix