OpenRTB的业务流程
OpenRTB的对象模型-BidRequest
OpenRTB的业务流程
一个完整的OpenRTB业务,所包含的角色,主要有以下几个:
流量主(Publisher)
ADX (AD Exchange)
Bidder(DSP)
广告主(Buyer)
他们之间的关系和完整的业务流程如下图:
1 广告主可通过DSP添加广告投放订单。
2 用户打开媒体的页面,页面中设有展示广告的位置,这个时候,媒体作为一个Publisher会向RTB交易服务平台,也就是ADX发起广告请求
3 ADX会向自己的多个竞价渠道平台(Bidder)发起竞价请求,在发起竞价请求的时候会附带一些信息,例如媒体网站、用户设备、用户相关行为数据等等,
4 竞价渠道Bidder根据步骤2附带的信息返回本Bidder的出价信息,例如:竞价的价格、广告素材、广告片段等等
5 ADX根据算法,从多个Bidder中决出胜者,给予成功反馈,如果第三步的返回中没有包含广告片段,需要Bidder再次提供
6 有些ADX会在成功反馈中附带成交账单信息,但不是所有的ADX都带
7 如果Bidder竞价没有成功,有的ADX是会是失败反馈中附带
失败原因的,但是这个不是必须的
8 ADX会将胜出的Bidder的广告返回给媒体,并通过媒体展示给用户
OpenRTB的对象模型
在OpenRTB的对象模型体系中,主要分为两大类对象模型,一类是请求用的Request模型,一类是响应用Response模型。
OpenRTB的BidRequest模型
BidRequest的各个对象之间的关系如下图:
在OpenRTB的请求对象体系中,BidRequest是最外层的顶级对象。他下面包含了十五个子对象
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | required | 竞价请求的唯一ID, 由广告交易平台提供 |
imp | array | required | 代表提供的展示信息的数组, 要求至少有一个 |
site | object | recommended | Site对象,表示发布者站点相关的详细信息, 仅仅对站点适用且推荐填充 |
app | object | recommended | App对象,表示发布应用的详细信息。仅对应用适用且推荐填充 |
device | object | recommended | Device对象, 表示展示将要被发送到的用户设备的信息 |
user | object | recommended | User对象, 表示使用设备的对象, 广告的受众 |
test | integer | 标识测试模式,拍卖不计价。 0表示实况(非测试)模式,1表示测试模式,default 0 | |
at | integer | 拍卖类型(胜出策略)1表示第一价格 ,2标识第二价格。交易特定的拍卖类型可以用大于500的值定义, default 2 | |
tmax | integer | 用于在提交竞价请求时避免超时的最大时间,以毫秒为单位,这个值通常是线下沟通的 | |
wseat | array | 允许在本次展现上进行竞拍的买家白Seat名单。 交易平台和竞拍者必须提前协商好Seat IDs | |
allimps | integer | 用于标识交易平台是否可以验证当前的展示列表包含了当前上下文中所有展示。(例如,一个页面上的所有广告位,所有的视频广告点(视频前,视频中,时候后))用于支持路由封锁。 0表示不支持或未知, 1表示提供的展示列表代表所有可用的展示。 default 0 | |
cur | array | 本次竞价请求允许的货币列表, 使用ISO-4217 字母码。 仅在交易平台接收多种货币的时候推荐填充。 | |
bcat | array | 被封锁的广告主类别,使用IAB 内容类别,参考列表5.1。 | |
badv | array | 域名封锁列表(比如 ford.com) | |
regs | object | Reg对象, 指明对本次请求有效的工业,法律或政府条例 |
在BidRequest中一些子对象用于提供潜在买家的详细信息,这些对象是强烈推荐使用的。
在这些对象中,Site和App对象,用于描述展示广告的发布媒体的类型。 但是每个竞价请求中只能使用一个,这取决于发起广告请求的是基于浏览器的页面内容或者APP应用内部内容。
接下来,再依次看看BidRequest的各个子对象的信息
BidRequest的Imp对象
Imp对象描述了一个广告位或者将要参与竞拍的广告展现。一个竞价请求可以包含多个Imp 对象,这种状况的一个示例是一个交易平台支持售卖一个页面的所有广告位。 为了便于竞拍者区分, 每一个Imp对象都要有一个唯一标识(ID).
Banner, Video以及Native对象都属于Imp对象,只是限定了自己的展示类型。 广告展示方可以选择其中的一种类型或者混合使用多种类型。 但是,对于一个BidRequest的展示必须属于提供的指定类型之一。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | required | 在当前竞价请求上下文中唯一标识本次展示的标识(通常从1开始并以此递增) |
banner | object | Banner对象, 如果展示需要以banner的形式提供则需要填充 | |
video | object | Video对象, 如果展示需要以视频的形式提供则需要填充 | |
native | object | Native对象, 如果展示需要以Native广告的形式提供则需要填充 | |
displaymanager | string | 广告媒体合作伙伴的名字, 用于渲染广告的SDK技术或者播放器(通常是视频或者移动广告)某些广告服务需要根据合作伙伴定制广告代码, 推荐在视频广告或应用广告中填充 | |
displaymanagerver | string | 广告媒体合作伙伴, 用于渲染广告的SDK技术或者播放器(通常是视频或者移动广告)的版本号。 某些广告服务需要根据合作伙伴定制广告代码, 推荐在视频广告或应用广告中填充 | |
instl | integer | 1标识广告是插屏或者全屏广告, 0表示不是插屏广告,default 0 | |
tagid | string | 某个特定广告位或者广告标签的标识,用于发起竞拍。 为了方便调试问题或者进行买方优化 | |
bidfloor | float | 本次展示的最低竞拍价格, 以CPM表示,default 0 | |
bidfloorcur | string | ISO-4217规定的字母码表标识的货币类型。 如果交易平台允许,可能与从竞拍者返回的竞价货币不同。 default “USD” | |
secure | integer | b标识展示请求是否需要使用HTTPS加密物料信息以及markup以保证安全, 0标识不需要使用安全链路, 1标识需要使用安全链路, 如果不填充,则表示未知, 可以认为是不需要使用安全链路。 | |
iframebuster | array | 特定交易支持的iframe buster的名字数组 | |
pmp | object | Pmp对象, 包含对本次展示生效的任何私有市场交易 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
Imp的Banner对象
Banner是最常见的展示类型。 虽然“banner”这个名词在其他的场景有很特别的意思, 在这里它可以是包括静态图像, 可扩展的广告单元或者一个在banner中播放的视频在内的很多东西。一组Banner对象可以出现在Video对象中来描述可选择在VAST贵方中定义的附加广告。
Banner作为Imp的子对象出现表示它是一个具有banner类型的展示对象. 同样的展示也可以是一个视频或者Native广告, 只要包含Video对象或者Native对象。然而, 任何为展示给定的竞价请求必须符合提供类型中的一个。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
w | integer | recommended | 展示的宽度,以像素为单位,如果没有指定wmin以及wmax, 这个值指的就是需要的展示宽度,否则指的是一个期望宽度 |
h | integer | recommended | 展示的高度,以像素为党委,如果没有指定hmin以及hmax, 这个值指的就是需要的展示高度, 否则指的是一个期望高度 |
wmax | integer | 展示宽度的最大值,以像素为单位, 如果和w一起出现, 则w应该被解释为推荐宽度或者期望宽度 | |
wmin | integer | 展示宽度的最小值,以像素为单位, 如果和w一起出现, 则w应该被解释为推荐宽度或者期望宽度 | |
hmax | integer | 展示高度的最大值,以像素为单位, 如果和h一起出现, 则h应该被解释为推荐宽度或者期望宽度 | |
hmin | integer | 展示高度的最小值,以像素为单位, 如果和h一起出现, 则h应该被解释为推荐宽度或者期望宽度 | |
id | string | banner对象的唯一标识。在一个Ad中包含Banner与Video的时候使用。值往往从1开始并依次递增,在依次展示中应当是唯一的 | |
btype | array | 限制的banner类型。参考表5.2 | |
battr | array | 限制的物料属性, 参考表5.3 | |
pos | integer | 广告在屏幕上的位置,参考表5.4 | |
mimes | array | 支持的内容mime-type. 常用的mime-type包括application/x-shockwave-flash, image/jpg以及 image/gif. | |
topframe | integer | banner是在顶层frame中而不是iframe中, 0表示不是, 1表示是 | |
expdir | array | banner可以扩展的方向,参考表5.5 | |
api | array | 本次展示支持的API框架列表, 参考表5.6. 如果一个API没有被显式在列表中指明,则表示不支持 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
Imp的Video对象
这个对象表示一个流式视频展示。 许多属性对于最小可用功能不是必须的,但是为了在需要的时候提供更好的控制能力会被使用。OpenRTB中的视频通常都是与标准一致的,复合广告的概念也是支持的, 可以包含用于定义复合广告的一组Banner对象。
Video作为Imp的子对象出现表示它是一个具有视频类型的展示对象。 同样的展示也可以是一个Banner或者Native广告, 只要包含Banner对象或者Native对象。然而, 任何为展示给定的竞价请求必须符合提供类型中的一个。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
mimes | array | required | 支持的内容mime-type, 常用的类型包括用于windows媒体的video/x-ms-wmv以及用于Flash视频的video/x-flv. |
minduration | integer | recommended | 最小的视频长度, 以秒为单位 |
maxduration | integer | recommended | 最大的视频长度, 以秒为单位 |
protocol | integer | DEPRECATED | 注意,使用protocols是高度推荐的。 支持的视频竞价响应协议。参考表5.8.至少一个支持的协议必须在protocol或者protocols属性中被指定 |
protocols | array | recommended | 支持的视频竞价响应协议数组。参考表5.8.至少一个支持的协议必须在protocol或者protocols属性中被指定 |
w | integer | recommeded | 视频播放器的宽度,像素为单位 |
h | integer | recommeded | 视频播放器的高度,像素为单位 |
startdelay | integer | recommended | 视频前,中及之后的广告位中视频广告的启动延时,以秒为单位, 参考表5.10 |
linearity | integer | 展示是否必须是线性的, 如果没有指定,则标识都是被允许的,参考表5.11 | |
sequence | integer | 如果在同一个竞价请求中提供了多个展示, 则需要考虑多个物料传输的顺序 | |
battr | array | 限制的物料属性,参考表5.3 | |
maxextended | integer | 最大的视频广告延长时间长度(如果支持延长)。如果为空或者0,表示不允许延长, 如果为-1,表示允许延时,且没有时间限制, 如果为大于0的数字, 则表示可以延长的时间长度比maxduration大的值 | |
minbitrate | integer | 最小的比特率,以Kbps为单位。交易平台可以动态的设置这个值或者为所有发布者统一设置该值 | |
maxbitrate | integer | 最大的比特率,以Kbps为单位。交易平台可以动态的设置这个值或者为所有发布者统一设置该值 | |
boxingallowed | integer | default 1 是否允许将4:3的内容展示在16:9的窗口, 0表示不允许,1表示允许 | |
playbackmethod | array | 允许的播放方式, 如果没有指定,表示支持全部,参考表5.9 | |
delivery | array | 支持的传输方式 (例如流式传输,逐步传输),如果没有指定,表示全部支持,参考表5.13 | |
pos | integer | 广告在屏幕上的位置,参考表5.4 | |
companionad | array | 如果支持复合广告,表示一组Banner对象 | |
api | array | 本次展示支持的API框架列表, 参考表5.6. 如果一个API没有被显式在列表中指明,则表示不支持 | |
companiontype | array | 支持的VAST companion 广告类型, 参考表5.12。 如果在companionad中填充了Banner对象则推荐使用 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
Imp的Native对象
表示一个Native类型的展示。Native广告单元需要无缝的插入其周围的内容中(例如, 一个对Twitter或Facebook赞助)。 因此,响应必须具有良好的结构, 让展示者能够在细粒度上控制渲染过程。
Native小组委员会为OpenRTB开发了一个组合规范,名为Native Ad规范。 定义了Native广告的请求参数以及响应结构。这个对象以字符串的形式提供请求参数, 这样的话具体的请求参数就可以按照Native Ad规范独立演进。同样的, 广告markup也会按照该文档指定的结构提供。
Native作为Imp的子对象出现表示它是一个具有native类型的展示对象。 同样的展示也可以是一个Banner或者Video广告, 只要包含Banner对象或者Video对象。然而, 任何为展示给定的竞价请求必须符合提供类型中的一个。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
request | string | required | 遵守Native Ad规范的请求体 |
ver | string | recommended | Native Ad规范的版本, 为了高效解析强烈推荐 |
api | array | 本次展示支持的API框架列表, 参考表5.6. 如果一个API没有被显式在列表中指明,则表示不支持 | |
battr | array | 限制的物料属性,参考表5.3 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Site对象
如果广告载体是一个网站时应该包含这个对象,如果是非浏览器应用时则不需要。 一个竞价请求一定不能同时包含Site对象和App对象。 提供一个站点标识或者页面地址是很有用的, 但是不是严格必须的。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | recommended | 交易特定的站点标识 |
name | string | 站点名称 (可以在展示者请求中作为别名标识) | |
domain | string | 站点的域名 (例如,”mysite.foo.com”) | |
cat | array | 站点的一组IAB 内容类型,参考表5.1 | |
sectioncat | array | 描述站点当前部分的一组IAB内容类型,参考表5.1 | |
pagecat | array | 描述站点当前视图的一组IAB内容类型,参考表5.1 | |
page | string | 展示广告将要被展示的页面地址 | |
ref | string | 引导到当前页面的referrer地址 | |
search | string | 引导到当前页面的搜索字符串 | |
mobile | integer | 移动优化标志, 0表示否,1表示是 | |
privacypolicy | integer | 表示该站点是否有隐私策略, 0表示没有, 1表示有 | |
publisher | Object | Publisher对象, 站点发布者的详细信息 | |
content | Object | Content对象, 该站点内容的详细信息 | |
keywords | string | 逗号分隔的站点的关键字信息 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的App对象
如果广告载体是非浏览器应用(通常是移动设备)时应该包含该对象, 网站则不需要包含。一个竞价请求一定不能同时包含Site对象和App对象。 提供一个App标识或者bundle是很有用的, 但是不是严格必须的。
BidRequest的Publisher对象
用于描述展示广告的媒体的发布者。通常发布者就是OpenRTB事务中的卖方。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | recommended | 交易特定的发布者标识 |
name | string | 发布者名称 (可以在展示者请求中作为别名标识) | |
cat | array | 发布者的IAB内容类型数组, 参考表5.1 | |
domain | string | 发布者的顶级域名(例如, “publisher.com” ) | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Content对象
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | 内容唯一标识 | |
episode | integer | 情节数目(通常用于视频内容) | |
title | string | 内容标题。 视频示例: “Search Committee”(电视), ”A New Hope”(电影), “Endgame”(为网络制作) 非视频示例: “Why an Antarctic Glacier is Melting So Quickly”(时报杂志文章) | |
series | string | 内容系列。 视频示例:“The Office”(电视), ”Start Wars”(电影,”Arby ‘N’ The Chief”(为网络制作) 非视频示例: “Ecocentric”(时报杂志博客) | |
season | string | 内容季数, 通常用于视频内容(例如,“第三季”) | |
producer | object | 内容提供者的详细信息 | |
url | string | 内容的url, 用于买方了解使用的上下文或者审查 | |
cat | array | 内容生产者的IAB内容类型数组, 参考表5.1 | |
videoquality | integer | 视频质量,按照IAB的分类,参考表5.11 | |
context | integer | 内容类型(游戏,视频,文本等), 参考表5.14 | |
contentrating | string | 内容分级(例如, MPAA美国电影分级制度) | |
userrating | string | 内容的用户评分(比如,星数,点赞数等) | |
qagmediarating | integer | 媒体评分,按照QAG规范。参考表5.15 | |
keywords | string | 逗号分隔的内容的关键字信息 | |
livestream | integer | 0表示不是实时,1表示实时 | |
sourcerelationship | integer | 0表示间接源, 1表示直接源 | |
len | integer | 内容长度, 用于音频或者视频 | |
language | string | 内容语言, 使用ISO-639-1-alpha-2 | |
embeddable | integer | 表示内容是否可嵌套(例如一个可嵌套的视频播放器), 0表示不可以, 1表示可以 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Producer对象
定义内容的提供者, 广告会在这些内容中展示。 当内容会被多个发布者展示时是对于区分发布者和生产者是否是同一实体是有用的。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | 内容生产者标识, 当内容会被多个发布者展示且可能使用嵌套标签展示在一个站点的时候有用 | |
name | string | 内容提供者名称 (例如, “Warner Bros”) | |
cat | array | 内容提供者的IAB内容类型数组, 参考表5.1 | |
domain | string | 内容提供者的顶级域名(例如, “producer.com” ) | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Device对象
提供用户使用的设备的详细信息。设备信息包括硬件,平台以及附加信息。设备可以是一部移动手机, 桌面电脑,机顶盒或者其他数码设备。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
ua | string | recommended | 浏览器User-Agent字符串 |
geo | object | recommended | Geo对象,用用户当前位置表示设备位置 |
dnt | integer | recommended | 浏览器在HTTP头中设置的标准的 “Do Not Track”标识, 0表示不限制追踪, 1表示限制(不允许)追踪 |
ip | string | recommended | 最接近设备的IPv4地址 |
ipv6 | string | 最接近设备的IPV6地址 | |
devicetype | integer | 设备类型,参考被5.17 | |
make | string | 设备制造商,例如 “Apple” | |
model | string | 设备型号,例如 “iphone” | |
os | string | 设备操作系统, 例如 “ios” | |
osv | string | 设备操作系统版本号, 例如 “3.1.2” | |
hwv | string | 设备硬件版本, 例如 “5S” | |
h | integer | 屏幕的物理高度, 以像素为单位 | |
w | integer | 屏幕的物理宽度,以像素为单位 | |
ppi | integer | 以像素每英寸表示的屏幕尺寸 | |
pxratio | float | 设备物理像素与设备无关像素的比率 | |
js | integer | 支持javascript, 0表示不支持, 1表示支持 | |
flashver | string | 浏览器支持的Flash版本 | |
language | string | 浏览器语言,使用ISO-639-1-alpha-2 | |
carrier | string | ISP的附带信息(如版本号)。“WIFI”通常在移动设备中表示高带宽。(例如,video freendly vs. cellular). | |
connectiontype | integer | 网络连接类型, 参考表5.18 | |
ifa | string | 广告主标识, 明文表示 | |
didsha1 | string | 硬件设备ID(例如 IMEI),使用SHA1哈希算法 | |
didmd5 | string | 硬件设备ID(例如 IMEI),使用md5哈希算法 | |
dpidsha1 | string | 设备平台ID(例如 Android ID),使用SHA1哈希算法 | |
dpidmd5 | string | 设备平台ID(例如 Android ID),使用md5哈希算法 | |
macidsha1 | string | 设备mac地址,使用SHA1哈希算法 | |
macidmd5 | string | 设备mac地址,使用md5哈希算法 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
最佳实践: 当前没有关于设备生产商,型号,操作系统或其他附加信息的有效的开源列表。 交易平台通常使用商业产品或者其他专有列表来填充这些属性。 在适当的开放标准可用之前, 推荐交易平台向竞拍者发布他们支持的设备生产商, 型号,操作系统以及附加信息。
最佳实践: 对于移动设备的IP合理的检测方式不是去直接检测的,通常存在于HTTP 的x-forwarded-for头中, 跳过私有的网络(例如10.x.x.x或者192.x.x.x), 扫描出已知的IP. 当交易平台向竞拍者传递设备的IP地址的时候, 要求交易平台仔细的研究并实现该属性。
BidRequest的Geo对象
用于封装一个地理位置信息的多种不同属性。 当作为Device对象的子节点的时候,标识设备的地理位置或者用户当前的地理位置。 当作为User的子节点的时候,标识用户家的位置(也就是说,不必是用户的当前位置)。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
lat | float | 纬度信息,取值范围-90.0到+90.0, 负值表示南方 | |
lon | float | 经度信息, 取值返回-180.0到+180.0, 负值表示西方 | |
type | integer | 位置信息的源, 当传递lat/lon的时候推荐填充, 参考表5.16 | |
country | string | 国家码, 使用 ISO-3166-1-alpha-3 | |
region | string | 区域码, 使用ISO-3166-2; 如果美国则使用2字母区域码 | |
regionfips104 | string | 国家的区域,使用 FIPS 10-4 表示。 虽然OpenRTB支持这个属性,它已经与2008年被NIST撤销了 | |
metro | string | 谷歌metro code; 与Nielsen DMA相似但不完全相同, 参见附录A | |
city | string | 城市名,使用联合国贸易与运输位置码, 参见附录A | |
zip | string | 邮政编码或者邮递区号 | |
utcoffset | integer | 使用UTC加或者减分钟数的方式表示的本地时间 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的User对象
描述了解或者持有设备的用户的信息(也就是广告的受众)。 用户id是一个exchange artifact, 可能随着屏幕旋转或者其他的隐私策略改变。 尽管如此,用户id必须在足够长的一段时间内保持不变,以为目标用户定向和用户访问频率限制提供合理的服务。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | recommended | 交易特定的用户标识, 推荐id和buyeruid中至少提供一个。 |
buyeruid | string | recommended | 买方为用户指定的ID,由交易平台为买方映射。推荐id和buyeruid中至少提供一个。 |
yob | integer | 生日年份,使用4位数字表示 | |
gender | strnig | 性别, M表示男性, F表示女性, O标识其他类型,不填充表示未知 | |
keywords | string | 逗号分隔的关键字, 兴趣或者意向列表 | |
customdata | string | 可选特性, 用于传递给竞拍者信息,在交易平台的cookie中设置。字符串必须使用base85编码的 cookie,可以是任意格式。 JSON加密的时候必须包括转义的引号。 | |
geo | object | Geo对象, 用户家的位置信息。不必是用户的当前位置 | |
data | array | 附加的用户信息, 每个 Data对象表示一个不同的数据源 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Data对象
Data和Segment对象一起允许指定用户附加信息。数据可能来自多个数据源, 可能来自交易平台自身或者第三方提供的信息, 可以使用id属性区分。 一个竞价请求可以混合来自多个提供者的数据信息。 交易平台应该优先提供正在使用的数据提供者的信息。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | 交易特定的数据提供者标识 | |
name | string | 交易特定的数据提供者名称 | |
segment | array | 包含数据内容的一组Segment对象 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Segment对象
数据字段, 描述用户信息数据的键值对。 其父对象Data是某个给定数据提供者的数据字段的集合。交易平台必须优先将字段的名称和值传递给竞拍者。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | 数据提供者的特定数据段的ID | |
name | string | 数据提供者的特定数据段的名称 | |
value | string | 表示数据字段值的字符串 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Regs对象
描述任何适用于该请求的法律,政府或者工业管控条例。 coppa(Children’s Online Privacy Protection Act)标志着是否该请求是否符合美国联邦贸易委员会颁布的美国儿童在线隐私保护法案,详情可参考7.1节。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
coppa | integer | 标志着该请求是否遵从COPPA法案, 0表示不遵从, 1表示遵从 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Pmp对象
包含本展示涉及的买卖双方的直接交易相关的私有市场信息。 真实的交易信息使用一组Deal对象表示, 详情可参考7.2节。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
private_auction | integer | 标识在Deal对象中指明的席位的竞拍合格标准, 0标识接受所有竞拍, 1标识竞拍受deals属性中描述的规则的限制 | |
deals | array | 一组Deal对象, 用于传输适用于本次展示的交易信息 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
BidRequest的Deal对象
描述限制买卖双方之间交易的一些条款。 它在Pmp集合中的出现表示该展示符合交易描述的条款。详情参考7.2节。
属性 | 类型 | 必要性 | 描述 |
---|---|---|---|
id | string | required | 直接交易的唯一ID |
bidfloor | float | default 0 本次展示的最低竞价,以CPM为单位 | |
bidfloorcur | string | default ‘USD’ 使用ISO-4217码表指定的货币。 如果交易平台允许,这可能与竞价者返回的竞价货币类型不一致 | |
at | integer | 可选的覆盖竞价请求中的竞拍类型, 1表示第一价格竞拍,2标识第二价格竞拍, 3表示使用bidfloor可以作为交易价格 | |
wseat | array | 允许参与本次交易竞价的买方席位白名单。 席位ID需要交易平台和竞拍者提前协商, 忽略本属性标示没有席位限制 | |
wadomain | array | 允许参与本次交易竞价的广告主域名列表(例如, advertiser.com). 忽略本属性标示没有广告主限制。 | |
ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |