Back to Bidders

Sovrn

Features

Bidder Code sovrn Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no GPP Support no
Supports Deals check with bidder Prebid.js Adapter yes
IAB GVL ID 13 Prebid Server Adapter yes
Floors Module Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support check with bidder
Safeframes OK check with bidder

"Send All Bids" Ad Server Keys

These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.
hb_pb_sovrn hb_bidder_sovrn hb_adid_sovrn
hb_size_sovrn hb_source_sovrn hb_format_sovrn
hb_cache_host_sovrn hb_cache_id_sovrn hb_uuid_sovrn
hb_cache_path_sovrn hb_deal_sovrn

Bid Params

Name Scope Description Example Type
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.

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 required The array of supported video protocols [1, 2] integer array
w recommended Width of the video player in device independent pixels (DIPS) 5 integer
h recommended Height of the video player in device independent pixels (DIPS) 5 integer
startdelay recommended Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements 5 integer
placement recommended Placement type for the impression. Refer to List 5.9 5 integer
linearity recommended 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 [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 recommended Ad position on screen. Refer to Ad Position 5 integer
api recommended List of supported API frameworks for this impression. Refer to API Frameworks [1, 2, 3] integer array

Note

Protocols list

MIME types:

With VPAID2:

video/mp4, video/3gpp, application/javascript

Without VPAID2:

video/mp4, video/3gpp

Video Playback Methods:

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:

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:

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:

Value Description
1 VPAID 1.0
2 VPAID 2.0
3 MRAID-1
4 ORMMA
5 MRAID-2
6 MRAID-3

Source: OpenRTB scpecification

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'
        }
      }]
    },

    var bannerAdUnit = {
      code: 'banner-div',
      sizes: [[300, 250]],
      bids: [{
        bidder: 'sovrn',
        params: {
          tagid: '315045'
        }
      }]
    }

Back to Bidders