Cloud ADX

    BidResponse

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

    BidResponse Object

    BidResponse结构如下图所示:

    image.png

    一个BidResponse中可包含多个Bid对象,每个Bid对象对应BidRequest中的一个Imp对象。 有两种方式可以表达”无广告返回”这一语义:

    1. 返回 HTTP 204 No Content。
    2. 返回 HTTP 200 Ok,http body中的BidResponse的Bid列表为空。
    Field Mandatory Type Description
    id required string response id,必须和request id保持一致
    bid required object[] 广告信息

    Bid Object

    Field Mandatory Type Description
    impid required string 该次竞价所关联的imp id
    adm optional string 广告html内容
    返回html广告时,会设置该值
    admvideo optional string 视频广告VAST内容
    返回视频广告时,会设置该值
    admnative optional object 原生广告内容
    返回原生广告时,会设置该值
    • 当返回非原生广告时
      Cloud-ADX会将广告html内容填充进adm字段中。
    • 当返回原生广告时
      Cloud-ADX会将原生广告信息填入AdmNative对象中。
      SSP需要确保按AdmNative中的设置进行相应的点击跳转和发送展现/点击监控。

    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