OpenRTB API Specification Version 2.5 IAB Tech Lab
Page iv
4.2.2 Object: SeatBid ........................................................................................................................................ 29
4.2.3 Object: Bid.................................................................................................................................................. 29
4.3 Ad Serving Options .......................................................................................................................................... 31
4.3.1 Markup Served on the Win Notice .................................................................................................. 31
4.3.2 Markup Served in the Bid ................................................................................................................... 31
4.3.3 Comparison of Ad Serving Approaches ........................................................................................ 31
4.4 Substitution Macros ........................................................................................................................................ 32
5. Enumerated Lists Specification ....................................................................................... 34
5.1 Content Categories .......................................................................................................................................... 34
5.2 Banner Ad Types .............................................................................................................................................. 45
5.3 Creative Attributes .......................................................................................................................................... 45
5.4 Ad Position.......................................................................................................................................................... 45
5.5 Expandable Direction ..................................................................................................................................... 46
5.6 API Frameworks ............................................................................................................................................... 46
5.7 Video Linearity .................................................................................................................................................. 47
5.8 Protocols .............................................................................................................................................................. 47
5.9 Video Placement Types ................................................................................................................................. 47
5.10 Playback Methods ............................................................................................................................................ 48
5.11 Playback Cessation Modes ........................................................................................................................... 48
5.12 Start Delay .......................................................................................................................................................... 48
5.13 Production Quality .......................................................................................................................................... 49
5.14 Companion Types ............................................................................................................................................ 49
5.15 Content Delivery Methods............................................................................................................................ 49
5.16 Feed Types .......................................................................................................................................................... 50
5.17 Volume Normalization Modes .................................................................................................................... 50
5.18 Content Context ................................................................................................................................................ 50
5.19 IQG Media Ratings ........................................................................................................................................... 50
5.20 Location Type .................................................................................................................................................... 51
5.21 Device Type ........................................................................................................................................................ 51
5.22 Connection Type .............................................................................................................................................. 51
5.23 IP Location Services ........................................................................................................................................ 52
5.24 No-Bid Reason Codes ..................................................................................................................................... 52
5.25 Loss Reason Codes .......................................................................................................................................... 52
6. Bid Request/Response Samples ..................................................................................... 54
6.1 GitHub Repository ........................................................................................................................................... 54
6.2 Validator .............................................................................................................................................................. 54
6.3 Bid Requests ...................................................................................................................................................... 54
6.3.1 Example 1 – Simple Banner ............................................................................................................... 54
6.3.2 Example 2 – Expandable Creative .................................................................................................. 55
6.3.3 Example 3 – Mobile ............................................................................................................................... 56
6.3.4 Example 4 – Video .................................................................................................................................. 57
6.3.5 Example 5 – PMP with Direct Deal ................................................................................................ 59
6.3.6 Example 6 – Native Ad ......................................................................................................................... 60
6.4 Bid Responses ................................................................................................................................................... 61
6.4.1 Example 1 – Ad Served on Win Notice .......................................................................................... 61
6.4.2 Example 2 – VAST XML Document Returned Inline ............................................................... 61
6.4.3 Example 3 – Direct Deal Ad Served on Win Notice ................................................................. 62
6.4.4 Example 4 – Native Markup Returned Inline ............................................................................ 63