update

leeowenowen · Jun 30, 2016 · 0244e77 · 0244e77
1 parent 28acf3e
commit 0244e77
Show file tree

Hide file tree

Showing 2 changed files with 45 additions and 1 deletion.
diff --git a/README.md b/README.md
@@ -543,12 +543,56 @@ Native作为Imp的子对象出现表示它是一个具有native类型的展示
 | wadomain | string array | 允许参与本次交易竞价的广告主域名列表（例如， advertiser.com). 忽略本属性标示没有广告主限制。 |
 | ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
 
-
 # 4. Bid Response 规范
+
+RTB响应包含着一个对特定展示的出价信息。 出价信息本质上是一个购买要约。竞价响应由顶层的竞价响应对象和用于描述该出价信息的一些可选对象组成。 表示不出价的最节省带宽的方式是使用空的HTTP响应。 不符合标准格式的响应或者没有包含实际出价信息的响应都可以解释为不出价。
+
 ## 4.1 Object Model
+
+下边是竞价响应的对象模型。模型中的顶级对象（即没有名字的最外层的JSON对象）表示 `BidResponse`. 一个竞价响应可能包含来自多个席位（即来自实际出价者的购买实体）。 实际上一个响应可能包含来自同一个席位的多个出价； 通常来自不同的camapigns,但也不一定总是这样。 这样可以提高席位的胜出可能性， 因为大多数交易平台会为了展示者的利益强制设置了一些限制列表。
+
+![](https://raw.githubusercontent.com/leeowenowen/OpenRTB_API_Specification-/master/res/bid_response_object_model.png)
+
+从上图可以看出，真实的响应对象都显示在左边：顶级对象`BidResponse`, 表示席位的`SeatBid`以及`Bid`对象。 其他展示的对象都是与竞价响应相关的来自竞价请求的对象。特别要指出的是出于积极的追踪目的， `BidResponse`包含了`BidRequest`的ID。由于一个竞价请求可以包含多个展示， 所以`Bid`对象包含了`Imp`的ID, 用以表示是对该展示的出价。 如果某个出价符合某个私有交易市场的交易管制信息， `Bid`也应当包含特定`Deal`对象的ID.
+
+图中没有展示的是扩展对象。扩展对象是一个没有定义结构的对象， 它可以添加到任何对象中以纯属交易相关的扩展信息。 使用这些对象的竞拍者有责任将这些扩展信息传递给交易平台。
+
+下表总结了竞价响应中的对象， 可以作为作为下文详细信息描述的索引。
+
+| 对象 | 章节 | 描述 |
+| --- | --- | --- |
+| BidResponse | 4.2.1 | 顶级对象 |
+| SeatBid | 4.2.2 | 竞拍者给出的一组出价信息 |
+| Bid | 4.2.3 | 在特定商业条款下购买某个指定展示的要约 | 
+
 ## 4.2 Object Specifications
+
+以下部分将会详细介绍竞价响应模型中的每个对象。 首先介绍下适用于所有如下内容的公约：
+
+- 带有`required`修饰的属性的缺失将会技术上导致协议的破坏。
+- 处于某些可选属性的业务重要性， 会被标识为`recommended`。
+- 除非默认值被显示指定，一个缺失的属性被解释为`unknown`。
+
 ### 4.2.1 BidResponse
+
+顶级的竞价形影对象（即没有名称的最外层JSON对象）。 `id`属性是竞价请求的ID,用于记录日志。 同样的`bidid`是一个可选的响应追踪标识， 如果指定了该标识， 如果之后竞拍者胜出了，则在胜出通知子流程中，需要将该标识填充进去。 至少一个 `seatbid`对象是必须的， 表示对该展示的至少一个出价。 其他的属性都是可选的。
+
+如果要表示不出价， 可以选择使用空的HTTP响应体以及HTTP 204响应码。 如果竞拍者想要向交易平台传递不出价的原因， 可以返回一个只填充nbr属性的`BidResponse`对象。
+
+| 属性 | 类型 | 描述 |
+| --- | --- | --- |
+| id | string; **required** | 竞价请求的标识 |
+| seatbid | object array | 一组`SeatBid`对象， 如果出价，则至少应该填充一个 |
+| bidid | string | 竞拍者生成的响应ID, 辅助日志或者交易追踪 |
+| cur | string; default 'USD' | 使用ISO-4217码表标识货币类型 |
+| customdata | string | 可选特性，允许出价者以设置cookie的方式向交易平台传递信息。 字符串可以是任何格式， 必须使用base85编码，JSON编码必须包含转义的引号。 |
+| nbr | integer | 不出价的原因， 参考表5.19 |
+| ext | object | 特定交易的OpenRTB协议的扩展信息占位符 |
+
 ### 4.2.2 SeatBid
+
+
+
 ### 4.2.3 Bid
 ## 4.3 Ad Serving Options
 ### 4.3.1 Markup Served on the Win Notice

diff --git a/res/bid_response_object_model.png b/res/bid_response_object_model.png