Field | Scope | Type | Description |
---|---|---|---|
id | required | string | 竞价ID |
imp | required | array of object | 参见“Impression Object”一节 |
site | optional | object | 参见“Site Object”一节 |
app | optional | object | 参见“App Object”一节 |
device | optional | object | 参见“Device Object”一节 |
user | optional | object | 参见“User Object”一节 |
at | optional | integer | 竞价类型
|
cur | optional | array of string | 货币编码,参见ISO 4217标准 |
bcat | optional | array of string | 屏蔽的行业,参见 https://developers.google.com/adwords/api/docs/appendix/productsservices |
badv | optional | array of string | 屏蔽的广告主,例如:www.company.com |
test | optional | integer | 是否为测试模式
|
ext | optional | object | 扩展字段 参见 “Extension Object”一节 |
Field | Scope | Type | Description |
---|---|---|---|
reqid | optional | string | 唯一的请求id |
hybrid | optional | int | 竞价类型:0 普通竞价;1 混合竞价 |
Field | Scope | Type | Description |
---|---|---|---|
id | required | string | 广告位ID |
banner | required for banner impression | object | 参见“Banner Object”一节 |
video | required for video impression | object | 参见“Video Object”一节 |
native | required for native impression | object | 参见“Native Object”一节 |
bidfloor | optional | float | 底价,单位为分/CPM |
bidfloorcur | optional | string | 货币编码,参见ISO 4217标准 |
pmp | optional | object | 参见“PMP Object”一节 |
secure | optional | integer | 标识该曝光需要 https url 的广告素材 和曝光监控; 0=不需 要 https 广告, 2=需要 https 广告 |
Field | Scope | Type | Description |
---|---|---|---|
w | required | integer | 广告位的宽度,单位为像素 |
h | required | integer | 广告位的高度,单位为像素 |
pos | optional | integer | 广告位位置
|
ext | optional | object | 参见“Extension Object”一节 |
Field | Scope | Type | Description |
---|---|---|---|
type | optional | string | 参见附录 A, 广告位类型 |
num | optional | integer | 需要的广告数目 |
Field | Scope | Type | Description |
---|---|---|---|
minduration | required | integer | 广告的最小时长,单位为秒,小于等于0表示不限制 |
maxduration | required | integer | 广告的最大时长,单位为秒,小于等于0表示不限制 |
linearity | required | integer | 是否为linear
|
mimes | required | array of string | 支持的MIME类型 video/x-flv |
protocols | required | array of integer | 支持的VAST协议
|
w | optional | integer | 播放器的宽度,单位为像素 |
h | optional | integer | 播放器的高度,单位为像素 |
minbitrate | optional | integer | 广告的最小码率,单位为kbps |
maxbitrate | optional | integer | 广告的最大码率,单位为kpbs |
Field | Scope | Type | Description |
---|---|---|---|
request | required | string | 参见“广告位说明”一节 |
ver | required | string | 原生广告规范的版本号 |
Field | Scope | Type | Description |
---|---|---|---|
private_auction | optional | integer | 竞价范围
|
deals | optional | array of object | 参见“Direct Deal Object”一节 |
Field | Scope | Type | Description |
---|---|---|---|
id | required | string | direct deal ID |
bidfloor | optional | float | 底价,单位为分/CPM |
bidfloorcur | optional | string | 货币编码,参见ISO 4217标准 |
at | optional | integer | 竞价类型
|
Field | Scope | Type | Description |
---|---|---|---|
page | optional | string | 页面URL |
mobile | optional | integer | 是否为mobile
|
content | optional | object | 参见“Content Object”一节 |
name | optional | string | 网站名称,新浪网的流量name为“sina” |
domain | optional | string | 网站域名
|
Field | Scope | Type | Description |
---|---|---|---|
name | optional | string | 应用名称
|
bundle | optional | string | A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is a numeric ID. |
cat | optional | string | 应用分类,参见 https://developers.google.com/adwords/api/docs/appendix/mobileappcategories |
ver | optional | string | 应用版本号 |
content | optional | object | 参见“Content Object”一节 |
Field | Scope | Type | Description |
---|---|---|---|
len | optional | integer | 内容长度,如视频长度,单位为秒 |
url | optional | string | 内容url |
ext | optional | object | 参见“Extension Object”一节 |
Field | Scope | Type | Description |
---|---|---|---|
channel | optional | string | 参见附录 B, 频道编码 |
Field | Scope | Type | Description |
---|---|---|---|
ip | optional | string | IP地址 |
geo | optional | object | 参见“Geo Object”一节 |
ua | optional | string | 浏览器的user agent |
make | optional | string | 设备品牌,例如:Apple, Samsung |
model | optional | string | 设备型号,例如:iPhone 5S, Galaxy S4 |
os | optional | string | 操作系统,例如:iOS, Android |
osv | optional | string | 操作系统版本,例如:7.1, 4.4.3 |
devicetype | optional | integer | 设备类型
|
connectiontype | optional | integer | 网络连接类型
|
carrier | optional | string | 运营商,参见 https://developers.google.com/adwords/api/docs/appendix/mobilecarriers |
Field | Scope | Type | Description |
---|---|---|---|
lat | optional | float | 纬度,-90 ~ 90,南纬为负 |
lon | optional | float | 经度,-180 ~ 180,西经为负 |
region | optional | string | 地域编码,参见 附录中的地域编码 |
Field | Scope | Type | Description |
---|---|---|---|
id | optional | string | 用户ID,site广告为新浪cookie ID,app广告为设备ID(Android 设备,id为IMEI;IOS设备,id为idfa),先做MD5加密,再做BASE64加密 |
data | optional | array of object | 参见“Data Object”一节 |
ext | optional | object | 参见“Ext Object”一节 |
Field | Scope | Type | Description |
---|---|---|---|
cid | optional | string | PC和WAP的cookie id |
did | optional | string | ios客户端根据某种算法生成的ID,唯一性较好,存储在钥匙串中,android客户端根据老算法生成的ID,某些情况下有较多重复 |
uid | optional | string | 微博uid |
idfa | optional | string | 苹果手机广告标志符,明文 |
idfv | optional | string | 苹果手机identifierForVendor |
imei | optional | string | Android imei的md5值 |
aid | optional | string | 通行证根据某种算法生成的ID,用于与新浪/微博系的其他APP的数据互通 |
ldid | optional | string | android客户端根据新算法生成的ID,唯一性较好,存储在app私有目录和sd卡特定目录 |
oaid | optional | string | Android 10 版本及以上的手机广告标志符,明文 |
caid | optional | string | ios设备的根据广协算法得到的caid的值,明文 |
Field | Scope | Type | Description |
---|---|---|---|
name | optional | string | 数据源名称 |
segment | optional | array of object | 参见“Segment Object”一节 |
Field | Scope | Type | Description |
---|---|---|---|
name | optional | string | 字段名称 |
value | optional | string | 字段取值 |