BidResponse
所有文档

          Cloud DSP

          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 原生广告元素内容
          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 视频播放结束
          上一篇
          Sample-BidRequest
          下一篇
          Sample-BidResponse