From 3d93acaa12a2e71843bc598db90dbf85088f74f7 Mon Sep 17 00:00:00 2001 From: mikhalovich Date: Thu, 9 Dec 2021 17:04:27 +0300 Subject: [PATCH 1/6] EX-3450 Create Sovrn docs on how to use prebid video --- dev-docs/bidders/sovrn.md | 108 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 108 insertions(+) diff --git a/dev-docs/bidders/sovrn.md b/dev-docs/bidders/sovrn.md index 98c383cbeb..4db21e0633 100644 --- a/dev-docs/bidders/sovrn.md +++ b/dev-docs/bidders/sovrn.md @@ -22,3 +22,111 @@ fpd_supported: true |------------|----------|----------------------|------------|----------| | `tagid` | required | The sovrn Ad Tag ID | `'315045'` | `string` | | `bidfloor` | optional | Bid floor in dollars | `'0.04'` | `string` | + +### Bid Params for video ads + +{: .table .table-bordered .table-striped } +| Name | Scope | Description | Example | Type | +|---------------------|----------|------------------------------------------------------------------------------------------|-----------------|-----------------| +| `video.mimes` | required | Content MIME types supported | `['video/mp4']` | `string array` | +| `video.minduration` | required | Minimum video ad duration in seconds | `5` | `integer` | +| `video.maxduration` | required | Maximum video ad duration in seconds | `10` | `integer` | +| `video.protocols` | optional | The array of supported video protocols | `[1, 2]` | `integer array` | +| `video.w` | optional | Width of the video player in device independent pixels (DIPS) | `5` | `integer` | +| `video.h` | optional | Height of the video player in device independent pixels (DIPS) | `5` | `integer` | +| `video.startdelay` | optional | Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements | `5` | `integer` | + +### Note + +[Protocols list](https://docs.prebid.org/dev-docs/bidders/conversant.html#protocols) + +#### MIME types: + +##### iOS with VPAID2: + +video/3gpp, +video/mov, +video/mp4, +video/mpv, +application/javascript + +##### iOS without VPAID2: + +video/3gpp, +video/mov, +video/mp4, +video/mpv + +##### Others with VPAID2: + +video/mp4, +video/3gpp, +application/javascript + +##### Others without VPAID2: + +video/mp4, +video/3gpp + +Source: [OpenRTB scpecification](https://developers.smaato.com/demand-partners/openrtb-2-5-specifications/) + +### Example + +#### Video instream adUnit + +``` + var instreamAdUnit = { + code: 'instream-div', + sizes: [[640, 480]], + mediaTypes: { + video: { + mimes: ['video/mp4'], + minduration: 4, + maxduration: 6, + context: 'instream' + } + }, + bids: [{ + bidder: 'sovrn', + params: { + tagid: '315045' + } + }] + } +``` +#### Video outstream adUnit + +``` + var outstreamAdUnit = { + code: 'outstream-div', + sizes: [[640, 480]], + mediaTypes: { + video: { + mimes: ['video/mp4'], + minduration: 4, + maxduration: 6, + context: 'outstream' + } + }, + bids: [{ + bidder: 'sovrn', + params: { + tagid: '315045' + } + }] + }, +``` +#### Banner adUnit + +``` + var bannerAdUnit = { + code: 'banner-div', + sizes: [[300, 250]], + bids: [{ + bidder: 'sovrn', + params: { + tagid: '315045' + } + }] + } +``` From ca5685a2928f10c43db45a2e8e754a417ee3ceda Mon Sep 17 00:00:00 2001 From: mikhalovich Date: Thu, 23 Dec 2021 16:35:14 +0300 Subject: [PATCH 2/6] EX-3450 Add all supported fields for video ad --- dev-docs/bidders/sovrn.md | 84 ++++++++++++++++++++++++++++++++++----- 1 file changed, 74 insertions(+), 10 deletions(-) diff --git a/dev-docs/bidders/sovrn.md b/dev-docs/bidders/sovrn.md index 4db21e0633..e8bb8f0415 100644 --- a/dev-docs/bidders/sovrn.md +++ b/dev-docs/bidders/sovrn.md @@ -26,15 +26,32 @@ fpd_supported: true ### Bid Params for video ads {: .table .table-bordered .table-striped } -| Name | Scope | Description | Example | Type | -|---------------------|----------|------------------------------------------------------------------------------------------|-----------------|-----------------| -| `video.mimes` | required | Content MIME types supported | `['video/mp4']` | `string array` | -| `video.minduration` | required | Minimum video ad duration in seconds | `5` | `integer` | -| `video.maxduration` | required | Maximum video ad duration in seconds | `10` | `integer` | -| `video.protocols` | optional | The array of supported video protocols | `[1, 2]` | `integer array` | -| `video.w` | optional | Width of the video player in device independent pixels (DIPS) | `5` | `integer` | -| `video.h` | optional | Height of the video player in device independent pixels (DIPS) | `5` | `integer` | -| `video.startdelay` | optional | Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements | `5` | `integer` | +| Name | Scope | Description | Example | Type | +|------------------|----------|--------------------------------------------------------------------------------------------------------------------------------|--------------------|---------- ---| +| `mimes` | required | Content MIME types supported | `['video/mp4']` | `string array` | +| `minduration` | required | Minimum video ad duration in seconds | `5` | `integer` | +| `maxduration` | required | Maximum video ad duration in seconds | `10` | `integer` | +| `protocols` | optional | The array of supported video protocols | `[1, 2]` | `integer array` | +| `w` | optional | Width of the video player in device independent pixels (DIPS) | `5` | `integer` | +| `h` | optional | Height of the video player in device independent pixels (DIPS) | `5` | `integer` | +| `startdelay` | optional | Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements | `5` | `integer` | +| `placement` | optional | Placement type for the impression. Refer to List 5.9 | `5` | `integer` | +| `linearity` | optional | Indicates if the impression must be linear, nonlinear, etc. Allowed by default | `0` | `integer` | +| `skip` | optional | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes | `0` | `integer` | +| `skipmin` | optional | Only if the ad is skippable. Videos of total duration greater than this number of seconds can be skippable | `5` | `integer` | +| `skipafter` | optional | Only if the ad is skippable. Number of seconds a video must play before skipping is enabled | `5` | `integer` | +| `sequence` | optional | For multiple ad in the same bid request. This value allow will for the coordinated delivery of multiple ad | `5` | `integer` | +| `battr` | optional | Blocked creative attributes | `[1]` | `integer array` | +| `maxextended` | optional | Max extended ad duration beyond the maxduration if extension is allowed. Blank or 0 - blocked. -1 - allowed without time limit | `5` | `integer` | +| `minbitrate` | optional | Minimum bit rate in Kbps | `5` | `integer` | +| `maxbitrate` | optional | Maximum bit rate in Kbps | `5` | `integer` | +| `boxingallowed` | optional | Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0 = no, 1 = yes | `5` | `integer` | +| `playbackmethod` | optional | Playback methods that may be in use. See [Video Playback Methods](#video-playback-methods) | `[1]` | `integer array` | +| `playbackend` | optional | The event that causes playback to end. Refer to Playback Cessation Modes | `5` | `integer` | +| `delivery` | optional | Supported delivery methods (1 = streaming, 2 = progressive, 3 = download). If none specified, assume all are supported. | `[1, 2]` | `integer array` | +| `pos` | optional | Ad position on screen. Refer to [Ad Position](#ad-position) | `5` | `integer` | +| `api` | optional | List of supported API frameworks for this impression. Refer to [API Frameworks](api-frameworks) | `[1, 2, 3]` | `integer array` | + ### Note @@ -68,7 +85,54 @@ application/javascript video/mp4, video/3gpp -Source: [OpenRTB scpecification](https://developers.smaato.com/demand-partners/openrtb-2-5-specifications/) +#### Video Playback Methods: + +{: .table .table-bordered .table-striped } +| Value | Description | +|-------|----------------------------------------------------------| +| `1` | Initiates on Page Load with Sound On | +| `2` | Initiates on Page Load with Sound Off by Default | +| `3` | Initiates on Click with Sound On | +| `4` | Initiates on Mouse-Over with Sound On | +| `5` | Initiates on Entering Viewport with Sound On | +| `6` | Initiates on Entering Viewport with Sound Off by Default | + +#### Playback Cessation Modes: + +{: .table .table-bordered .table-striped } +| Value | Description | +|-------|-----------------------------------------------------------------------------------------------------------| +| `1` | On Video Completion or when Terminated by User | +| `2` | On Leaving Viewport or when Terminated by User | +| `3` | On Leaving Viewport Continues as a Floating/Slider Unit until Video Completion or when Terminated by User | + +#### Ad Position: + +{: .table .table-bordered .table-striped } +| Value | Description | +|-------|----------------| +| `0` | Unknown | +| `1` | Above the Fold | +| `2` | DEPRECATED | +| `3` | Below the Fold | +| `4` | Header | +| `5` | Footer | +| `6` | Sidebar | +| `7` | Full Screen | + +#### API Frameworks: + +{: .table .table-bordered .table-striped } +| Value | Description | +|-------|-------------| +| `1` | VPAID 1.0 | +| `2` | VPAID 2.0 | +| `3` | MRAID-1 | +| `4` | ORMMA | +| `5` | MRAID-2 | +| `6` | MRAID-3 | + +Source: [OpenRTB scpecification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) ### Example From cb1581938a5484361bc29ac6e8a4d227030221da Mon Sep 17 00:00:00 2001 From: mikhalovich Date: Thu, 23 Dec 2021 16:47:03 +0300 Subject: [PATCH 3/6] EX-3450 Fix table --- dev-docs/bidders/sovrn.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/sovrn.md b/dev-docs/bidders/sovrn.md index e8bb8f0415..7240db992e 100644 --- a/dev-docs/bidders/sovrn.md +++ b/dev-docs/bidders/sovrn.md @@ -27,7 +27,7 @@ fpd_supported: true {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type | -|------------------|----------|--------------------------------------------------------------------------------------------------------------------------------|--------------------|---------- ---| +|------------------|----------|--------------------------------------------------------------------------------------------------------------------------------|-----------------|-----------------| | `mimes` | required | Content MIME types supported | `['video/mp4']` | `string array` | | `minduration` | required | Minimum video ad duration in seconds | `5` | `integer` | | `maxduration` | required | Maximum video ad duration in seconds | `10` | `integer` | From 5251dcbedbaeafcd3dfbcec2db8087086493f32d Mon Sep 17 00:00:00 2001 From: Chris Pabst Date: Fri, 7 Jan 2022 16:31:55 -0700 Subject: [PATCH 4/6] EX-3450: Remove incorrect iOS information --- dev-docs/bidders/sovrn.md | 19 ++----------------- 1 file changed, 2 insertions(+), 17 deletions(-) diff --git a/dev-docs/bidders/sovrn.md b/dev-docs/bidders/sovrn.md index 7240db992e..5abb3b9dd5 100644 --- a/dev-docs/bidders/sovrn.md +++ b/dev-docs/bidders/sovrn.md @@ -59,28 +59,13 @@ fpd_supported: true #### MIME types: -##### iOS with VPAID2: - -video/3gpp, -video/mov, -video/mp4, -video/mpv, -application/javascript - -##### iOS without VPAID2: - -video/3gpp, -video/mov, -video/mp4, -video/mpv - -##### Others with VPAID2: +##### With VPAID2: video/mp4, video/3gpp, application/javascript -##### Others without VPAID2: +##### Without VPAID2: video/mp4, video/3gpp From c582abf1559dba258a915d88de9a9ccfff0ed126 Mon Sep 17 00:00:00 2001 From: Chris Pabst Date: Tue, 18 Jan 2022 16:19:52 -0700 Subject: [PATCH 5/6] EX-3450: PR update --- dev-docs/bidders/sovrn.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/sovrn.md b/dev-docs/bidders/sovrn.md index 5abb3b9dd5..39608964b7 100644 --- a/dev-docs/bidders/sovrn.md +++ b/dev-docs/bidders/sovrn.md @@ -23,7 +23,7 @@ fpd_supported: true | `tagid` | required | The sovrn Ad Tag ID | `'315045'` | `string` | | `bidfloor` | optional | Bid floor in dollars | `'0.04'` | `string` | -### Bid Params for video ads +### Bid Params for video ads. These params should be added to `mediatype.video`. {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type | From 342e68ef2c4c146cd90d78bde6c8d63a46f6bcb3 Mon Sep 17 00:00:00 2001 From: Chris Pabst Date: Wed, 9 Mar 2022 13:09:07 -0700 Subject: [PATCH 6/6] SOVRN: PR update --- dev-docs/bidders/sovrn.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/dev-docs/bidders/sovrn.md b/dev-docs/bidders/sovrn.md index 39608964b7..1a9485d8d3 100644 --- a/dev-docs/bidders/sovrn.md +++ b/dev-docs/bidders/sovrn.md @@ -13,6 +13,7 @@ schain_supported: true gvl_id: 13 floors_supported: true fpd_supported: true +media_types: banner, video --- ### Bid Params @@ -23,7 +24,7 @@ fpd_supported: true | `tagid` | required | The sovrn Ad Tag ID | `'315045'` | `string` | | `bidfloor` | optional | Bid floor in dollars | `'0.04'` | `string` | -### Bid Params for video ads. These params should be added to `mediatype.video`. +Bid Params for video ads. These params should be added to `mediatype.video`. {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type |