Back to Bidders

Sovrn

Features

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

Bid Params

Name Scope Description Example Type
tagid required The sovrn Ad Tag ID '315045' string
bidfloor optional Bid floor in dollars 0.04 float
adunitcode optional Ad unit identifier 'example_code' 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 recommended 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'
        }
      }]
    }

"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

Back to Bidders