3. StandardRequest

Cloud-DSP收到的HTTP竞价请求信息保存在StandardRequest中,StandardRequest用protobuf(Google Protobuf)实现,本节将介绍StandardRequest对象。

3.1 StandardRequest Object

参数 类型 含义
id string 可选,请求ID
key string 必填,在Cloud-SSP创建完广告位后,SSP会为每个广告位返回字符串格式的唯一标识
appid int64 可选,应用ID
userid int64 可选,用户ID
count int 可选,单次请求广告创意个数
ua string 可选,User Agent
ip string 可选,Ip地址
did string 推荐,移动设备IMEI[明文]
didsha1 string 可选,移动设备IMEI[SHA-1处理]
didmd5 string 可选,移动设备IMEI[MD5处理]
dpid string 推荐,移动设备Android-ID[明文]
dpidsha1 string 可选,移动设备Android-ID[SHA-1处理]
dpidmd5 string 可选,移动设备Android-ID[MD5处理]
mac string 推荐,设备网卡MAC[明文]
macsha1 string 可选,设备网卡MAC[SHA-1处理]
macmd5 string 可选,设备网卡MAC[MD5处理]
idfa string 可选,移动设备IDFA[明文]
idfasha1 string 可选,移动设备IDFA[SHA-1处理]
idfamd5 string 可选,移动设备IDFA[MD5处理]
cookie string 推荐,用户Cookie
maker string 推荐,设备制造商
model string 推荐,设备型号
os object 推荐,设备操作系统类型
osv string 推荐,设备操作系统版本号
screen_w int 可选,设备屏幕宽度
screen_h int 可选,设备屏幕高度
devicetype object 推荐,设备类型
carrier object 推荐,网络运营商
connectiontype object 推荐,网络接入方式
lat double 可选,GPS经度值
lon double 可选,GPS纬度值
country string 可选,设备当前所在国家
prov string 可选,设备当前所在省份
city string 可选,设备当前所在城市
commercial string 可选,设备当前所在商圈
locationtype object 可选,定位信息获取方式

说明

必填:该字段在当前对象中必须存在
推荐:推荐填写,该字段在后续环节中会被使用,准确的填写能够有效提高当前对象的可用性
可选:可以缺失的字段,一般情况下字段缺失将被系统解析为“未知”

下文中出现同样字段均参见此说明

3.1.1 OS Object

OS对象描述了请求发起方的设备操作系统类型。

参数 含义
WINDOWS Windows操作系统,包含PC和移动版本
MACOS Apple PC设备的操作系统
LINUX Linux操作系统
IOS Apple移动设备的操作系统
ANDROID Android操作系统

3.1.2 DeviceType Object

DeviceType对象描述了请求发起方的设备类型。

参数 含义
PERSONAL_COMPUTER 个人电脑PC
PHONE 手机设备
TABLET 平板电脑

3.1.3 Carrier Object

Carrier对象描述了请求发起方的运营商类型。

参数 含义
CARRIER_CHINA_TELECOM 中国电信
CARRIER_CHINA_MOBILE 中国移动
CARRIER_CHINA_UNICON 中国联通
CARRIER_CHINA_NETCOM 中国网通

说明

更多的运营商类型可以通过修改接口协议进行扩展

3.1.4 ConnectionType Object

ConnectionType对象描述了请求发起方的网络连接类型。

参数 含义
WIFI Wi-Fi无线网络
CELL_2G 移动网络2G
CELL_3G 移动网络3G
CELL_4G 移动网络4G
ETHERNET 有线网络

3.1.5 LocationType Object

LocationType对象描述了请求发起方的定位信息获取方式。

参数 含义
GPS_LOCATION GPS
IP IP翻译
USER_PROVIDED 用户自行提供

3.2. Sample StandardRequest

3.2.1 StandardRequest from pc browser

3.2.1.1 Json

{
  "key" : "02c27a51-0ec1-4d57-b581-9eaafd6a64dc",
  "did" : "ABCDEF0123456789",
  "devicetype" : PERSONAL_COMPUTER,
  "os" : WINDOWS,
  "carrier" : WIFI,
  "connectiontype" : CARRIER_CHINA_TELECOM
}

3.2.1.2 Form表单形式

http://ssp-ip:port/ps/std?key=02c27a51-0ec1-4d57-b581-9eaafd6a64dc&did=ABCDEF0123456789&devicetype=0&os=0&carrier=0&connectiontype=0

3.2.2 StandardRequest from mobile browser & app

3.2.1.2 Json

{
  "key" : "02c27a51-0ec1-4d57-b581-9eaafd6a64dc",
  "did" : "ABCDEF0123456789",
  "devicetype" : PHONE,
  "maker" : "apple",
  "os" : IOS,
  "osv" : "10.0",
  "carrier" : CARRIER_CHINA_MOBILE,
  "connectiontype" : CELL_4G
}

3.2.2.2 Form表单形式

http://ssp-ip:port/ps/std?key=02c27a51-0ec1-4d57-b581-9eaafd6a64dc&did=ABCDEF0123456789&devicetype=1&maker=apple&os=3&carrier=1&connectiontype=3