1.Overview

Cloud-SSP是百度智能云推出的开源流量资源管理框架,本文将介绍开发者如何接入Cloud-SSP系统。

1.1.Transport Protocol

Cloud-SSP与开发者之间的通信如下所示:

image.png

  1. Publisher (webpage/app) 向Cloud-SSP发广告请求。
  2. Cloud-SSP收到广告请求后,封装BidRequest,发送给Buyer。
  3. Buyer将广告响应写入SSPResponse,返回给Cloud-SSP。
  4. Cloud-SSP将广告结果返回给Publisher进行展现。

Publisher可以通过HTTP GET、HTTP POST两种通信协议接入Cloud-SSP,其具体请求分别为:

  1. HTTP GET:将流量属性参数填写在Request Parameter中发送到SSP
  2. HTTP POST:将SellingRequest序列化成json或proto binary保存在HTTP body中
    一个典型的广告请求请求如下所示(以API为例):
POST /ps/std_json  HTTP/1.1
HOST: cloudssp_selling_host
Content-Length: length

{
  "key" : "01234567-89ab-cdef-0123-456789",
  ...
}

Cloud-SSP响应请求后,将SellingReponse的序列化为JSON(对于GET或JSON协议的POST请求)或PB(对于proto binary的POST请求)数据保存在http响应中。

一个典型的SSP响应如下所示:

HTTP/1.1 200 OK
Content-Length: length

protobuf_json_of_SellingReponse