Prebid Server Bidder Params

This page contains documentation on the specific parameters required by each supported bidder. These docs only apply to Prebid Server bidders. For Prebid.js bidders see the Prebid.js Bidders page.

For each bidder listed below, you’ll find the following information:

Features A table of features supported by the adapter.
“Send All Bids” Ad Server Keys Used for sending all bids to the ad server, as described in Send All Bids to the Ad Server
Bid Params Ad request parameters required by a given bidder, such as the tag ID, site ID, or query string parameters

You can also download the full CSV data file.

Publishers are advised to check with legal counsel before doing business with any particular bidder.

Prebid Server Bidder List

Bidder Documentation

33Across

Features

Bidder Code 33across Prebid.org Member no
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 Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_33across hb_bidder_33across hb_adid_33across
hb_size_33across hb_source_33across hb_format_33across
hb_cache_host_33acro hb_cache_id_33across hb_uuid_33across
hb_cache_path_33acro hb_deal_33across  

Bid Params

Name Scope Description Example Type
siteId required Publisher GUID from 33Across 'examplePub123' string
productId required 33Across Product ID that the Publisher has registered for (use 'siab' for Banner or Outstream Video , 'inview' for Adhesion, 'instream' for Instream Video) 'siab' string

Ad Unit Setup for Banner

var adUnits = [
{
  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
  mediaTypes: {
    banner: {  
      sizes: [
          [300, 250], 
          [728, 90]
      ]
    }   
  } 
  bids: [{
    bidder: '33across',
    params: {
        siteId: 'examplePub123',    // required 
        productId: 'siab|inview'    // required
    }
  }]
}

Ad Unit Setup for Outstream Video

var adUnits = [
{
  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
  mediaTypes: {
    video: {                                // We recommend setting the following video params
                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation. 
      playerSize: [300, 250],               // required
      context: 'outstream',                 // required
      mimes: ['video/mp4','video/x-flv'],   // required
      protocols: [ 2, 3 ],                  // required, set at least 1 value in array
      placement: 2,                         // optional, defaults to 2 when context = outstream
      api: [ 1, 2 ],                        // optional
      skip: 0,                              // optional
      minduration: 5,                       // optional
      maxduration: 30,                      // optional
      playbackmethod: [1,3],                // optional
      battr: [ 13, 14 ],                    // optional
      linearity: 1,                         // optional
      minbitrate: 10,                       // optional
      maxbitrate: 10                        // optional
    }   
  }, 
  bids: [{
    bidder: '33across',
    params: {
        siteId: 'examplePub123',    // required     
        productId: 'siab'           // required     
    }
  }],
  ...
}

Ad Unit Setup for Instream Video

var adUnits = [
{
  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
  mediaTypes: {
    video: {                                // We recommend setting the following video params
                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation. 
      playerSize: [300, 250],               // required
      context: 'instream',                  // required
      mimes: ['video/mp4','video/x-flv'],   // required
      protocols: [ 2, 3 ],                  // required, set at least 1 value in array
      placement: 1,                         // optional, defaults to 1 when context = instream
      startdelay: 0,                        // optional, defaults to 0 when context = instream
      api: [ 1, 2 ],                        // optional
      skip: 0,                              // optional
      minduration: 5,                       // optional
      maxduration: 30,                      // optional
      playbackmethod: [1,3],                // optional
      battr: [ 13, 14 ],                    // optional
      linearity: 1,                         // optional
      minbitrate: 10,                       // optional
      maxbitrate: 10                        // optional
    }   
  }, 
  bids: [{
    bidder: '33across',
    params: {
        siteId: 'examplePub123',    // required    
        productId: 'instream'       // required     
    }
  }],
  ...
}

Ad Unit Setup for Multi-format: Banner, Video (Outstream)

var adUnits = [
{
  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
  mediaTypes: {
    banner: {  
      sizes: [
          [300, 250], 
          [728, 90]
      ]
    },
    video: {                                // We recommend setting the following video params
                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation. 
      playerSize: [300, 250],               // required
      context: 'outstream',                 // required
      mimes: ['video/mp4','video/x-flv'],   // required
      protocols: [ 2, 3 ],                  // required, set at least 1 value in array
      placement: 2,                         // optional, defaults to 2 when context = outstream
      api: [ 1, 2 ],                        // optional
      skip: 0,                              // optional
      minduration: 5,                       // optional
      maxduration: 30,                      // optional
      playbackmethod: [1,3],                // optional
      battr: [ 13, 14 ],                    // optional
      linearity: 1,                         // optional
      minbitrate: 10,                       // optional
      maxbitrate: 10                        // optional
    }   
  }, 
  bids: [{
    bidder: '33across',
    params: {
        siteId: 'examplePub123',    // required     
        productId: 'siab'           // required     
    }
  }],
  ...
}

SRA Mode

We recommend using SRA mode to optimize the bidding process as this allows our adapter to group together bid requests for Ad Units pertaining to the same product and site ID thereby minimizing the number of http requests made to our endpoint. To enable SRA set the following bidder specific config under 33Across

pbjs.setBidderConfig({
   bidders: ['33across'],
   config: {
      ttxSettings: {
        enableSRAMode: true
      }
   }
});

AAX

Features

Bidder Code aax Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support will-not-bid ORTB Blocking Support 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_aax hb_bidder_aax hb_adid_aax
hb_size_aax hb_source_aax hb_format_aax
hb_cache_host_aax hb_cache_id_aax hb_uuid_aax
hb_cache_path_aax hb_deal_aax  

Bid Params

Name Scope Description Example Type
cid required The customer id provided by Aax. 'aax_test_customer' string
crid required The placement id provided by Aax. 'aax_crid' string
video required for video Ad units Object containing video targeting parameters. See Video Object for details. video: { maxduration: 60 } object

Video Object

Name Type Description Example
mimes array of strings (Recommended) Specifies the video content MIME types supported; for example, video/x-ms-wmv and video/x-flv. [“video/x-ms-wmv”,”video/x-flv”]
minduration integer (Recommended) Specifies the minimum video ad duration, in seconds. 10
maxduration integer (Recommended) Specifies the maximum video ad duration, in seconds. 60
w integer (Recommended) Specifies the width of the video player, in pixels. Required if playerSize not present in mediaTypes.video 640
h integer (Recommended) Specifies the height of the video player, in pixels. Required if playerSize not present in mediaTypes.video 480
startdelay integer (Recommended) Specifies the start delay of the video ad 0
battr array of integers Specifies the video creative attributes to block. Refer to section 5.3 of the IAB specification for a list of attributes. [ 13, 14 ]
playbackmethod array of integers Specifies the allowed playback methods. If not specified, all are assumed to be allowed. Currently supported values are: 1: Autoplay, sound on; 2: Autoplay, sound off; 3: Click to play; 4: Mouse over to play [1, 3]
api array of integers Specifies the supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported. Currently supported values are: 1: VPAID 1.0; 2: VPAID 2.0; 3: MRAID-1; 4: ORMMA; 5: MRAID-2 [1, 2]
protocols array of integers Array of supported video protocols. Currently supported values are: 1: VAST 1.0; 2: VAST 2.0; 3: VAST 3.0; 4: VAST 1.0 Wrapper; 5: VAST 2.0 Wrapper; 6: VAST 3.0 Wrapper; 7: VAST 4.0 [1, 2]
placement integer Placement type for the impression. Possible options: 1: In-Stream; 2: In-banner; 3: Outstream/In-article; 4: In-feed; 5: Interstitial/Slider/Floating; 6: Long-Form; 1

Besides the above-mentioned parameters, we support all other OpenRTB 2.x video objects as optional parameters.

In addition to bids[].params.video, Aax adapter consumes parameters specified in the mediaTypes.video.

Example of Instream Video Ad-unit

var videoAdUnit = {
  code: 'video1',
  mediaTypes: {
    video: {
      context: "instream",
      playerSize: [640, 480],
      mimes: ['video/mp4'],
      placement: 1
    }
  },
  bids: [{
    bidder: 'aax',
    params: {
      cid: 'aax_test_customer',
      crid: 'aax_crid',  
    }
  }]
};

Example of Native Ad-unit

var adUnits = [{
  code: 'div-gpt-ad-6874091242345-0',
  mediaTypes: {
    native: {
      image: {
        required: true,
        sizes: [300, 250],
        wmin: 50,
      },
      title: {
        required: true,
        len: 80
      }
    }
  },
  bids: [{
    bidder: 'aax',
    params: {
      cid: 'aax_test_customer',
      crid: 'aax_crid'
    }
  }]
}];

Example of Banner Ad-unit

var adUnits = [{
  code: 'div-gpt-ad-6874091242345-0',
  mediaTypes: {
    banner: {
      sizes: [
        [728, 90],
        [300, 600],
        [300, 250]
      ],
    }
  },
  bids: [{
    bidder: 'aax',
    params: {
      cid: 'aax_test_customer',
      crid: 'aax_crid'
    }
  }]
}];

Aceex

Features

Bidder Code aceex Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_aceex hb_bidder_aceex hb_adid_aceex
hb_size_aceex hb_source_aceex hb_format_aceex
hb_cache_host_aceex hb_cache_id_aceex hb_uuid_aceex
hb_cache_path_aceex hb_deal_aceex  

Note:

The Example Bidding adapter requires setup before beginning. Please contact us at tech@aceex.com

Bid Params

Name Scope Description Example Type
accountid required Endpoint id 'hash' string

AcuityAds

Features

Bidder Code acuityads Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_acuityads hb_bidder_acuityads hb_adid_acuityads
hb_size_acuityads hb_source_acuityads hb_format_acuityads
hb_cache_host_acuity hb_cache_id_acuityad hb_uuid_acuityads
hb_cache_path_acuity hb_deal_acuityads  

Note:

The Example Bidding adapter requires setup before beginning. Please contact us at rafi.babler@acuityads.com

Bid Params

Name Scope Description Example Type
host required Region id 'ep1' string
accountid required Endpoint id 'hash' string

AdformOpenRTB

Features

Bidder Code adf Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support will-bid-on-one ORTB Blocking Support 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_adf hb_bidder_adf hb_adid_adf
hb_size_adf hb_source_adf hb_format_adf
hb_cache_host_adf hb_cache_id_adf hb_uuid_adf
hb_cache_path_adf hb_deal_adf  

This bidder previously had a bidder code of adformOpenRTB, but prefers new configurations to use adf.

Bid params

Name Scope Description Example Type
mid required, if inv and nmane not set Placement ID 12345 integer
inv required, if mid not set Inventory source ID 1234 integer
mname required, if mid not set Placement name "Leaderboard" string
adxDomain optional, Prebid.js only The Adform domain "adx.adform.net" string
priceType optional Price type "gross" string

Note: Bid placement should be defined using the mid parameter or inv and mname parameters (dynamic master tag) but not both.

OpenRTB request config

OpenRTB bid request app, site, device properties configured using prebid config.

pbjs.setConfig({
  ortb2: {
    app: {
      name: 'My APP'
    }
  }
});

Adform

Features

Bidder Code adform Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adform hb_bidder_adform hb_adid_adform
hb_size_adform hb_source_adform hb_format_adform
hb_cache_host_adform hb_cache_id_adform hb_uuid_adform
hb_cache_path_adform hb_deal_adform  

Adform bid adapter is deprecated since Prebid 5.0. Please refer to AdformOpenRTB adapter documentation to fetch bids from Adform demand sources.

Bid Params

Name Scope Description Example Type
mid required   12345 integer
adxDomain optional The Adform domain 'adx.adform.net' string
priceType optional An expected price type (net or gross) of bids 'net' string
mkv optional Comma-separated key-value pairs 'city:NY' string
mkw optional Comma-separated keywords 'news,sport' string
minp optional Minimum CPM price 2.55 number
cdims optional Comma-separated creative dimentions '300x250' string
url optional Custom targeting URL 'https://some.app/?home' string

Note: Spaces are not allowed between comma-separated list values. For example:

// valid params
{
  mid: 12345,
  mkv: 'city:NY,city:London',
  mkv: 'news,sport',
  cdims: '300x250,250x300'
}
// invalid params
{
  mid: 12345,
  mkv: 'city:NY, city:London',
  mkv: 'news, sport',
  cdims: '300x250, 250x300'
}

Ad Generation

Features

Bidder Code adgeneration Prebid.org Member no
Media Types display, native GDPR TCF Support no
User IDs novatiq, criteo, id5Id USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adgeneration hb_bidder_adgenerati hb_adid_adgeneration
hb_size_adgeneration hb_source_adgenerati hb_format_adgenerati
hb_cache_host_adgene hb_cache_id_adgenera hb_uuid_adgeneration
hb_cache_path_adgene hb_deal_adgeneration  

Bid Params

Name Scope Description Example Type
id required adId '1234' string

Adhese

Features

Bidder Code adhese Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs id5Id USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adhese hb_bidder_adhese hb_adid_adhese
hb_size_adhese hb_source_adhese hb_format_adhese
hb_cache_host_adhese hb_cache_id_adhese hb_uuid_adhese
hb_cache_path_adhese hb_deal_adhese  

Registration

The Adhese bid adapter may require an additional setup from the Adhese team, even for existing Adhese customers. Please reach out to your support team or info@adhese.com for more information.

Prebid Server host companies need to work with Adhese for each additional publisher.

Bid Params

Name Scope Description Example Type
account required Adhese account name 'demo' string
location required Adhese location name '_adhese_prebid_demo_' string
format required Adhese format name 'leaderboard' string
data optional Custom target data { 'ci': [9000, 9050] } object

Configuration

Adhese supports ‘iframe’ UserSync configuration only.

For Prebid.js v1.15.0 and later:

pbjs.setConfig({
  userSync: {
    filterSettings: {
      iframe: {
        bidders: '*',      // '*' represents all bidders
        filter: 'include'
      }
    }
  }
});

For Prebid.js v1.14.0 and before:

pbjs.setConfig({
   userSync: {
    iframeEnabled: true,
    enabledBidders: ['adhese']
 }});

Note: Combine the above the configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only last call for a given attribute will take effect.

AdKernel

Features

Bidder Code adkernel Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adkernel hb_bidder_adkernel hb_adid_adkernel
hb_size_adkernel hb_source_adkernel hb_format_adkernel
hb_cache_host_adkern hb_cache_id_adkernel hb_uuid_adkernel
hb_cache_path_adkern hb_deal_adkernel  

Note:

The Adkernel Bidding adaptor requires setup and approval before beginning. Please reach out to prebid@adkernel.com for more details

Bid Params

Name Scope Description Example Type
host required Ad network’s RTB host 'cpm.metaadserving.com' string
zoneId required RTB zone id '30164' string

AdKernelAdn

Features

Bidder Code adkernelAdn Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adkernelAdn hb_bidder_adkernelAd hb_adid_adkernelAdn
hb_size_adkernelAdn hb_source_adkernelAd hb_format_adkernelAd
hb_cache_host_adkern hb_cache_id_adkernel hb_uuid_adkernelAdn
hb_cache_path_adkern hb_deal_adkernelAdn  

Note:

The AdkernelAdn Header Bidding adaptor requires setup and approval before beginning. Please reach out to prebid@adkernel.com for more details

Bid Params

Name Scope Description Example Type
host optional Ad network host 'tag.adkernel.com' string
pubId required Publisher Id 102 integer

ADman Media

Features

Bidder Code adman Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs uid2, lotamePanoramaId, idx USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adman hb_bidder_adman hb_adid_adman
hb_size_adman hb_source_adman hb_format_adman
hb_cache_host_adman hb_cache_id_adman hb_uuid_adman
hb_cache_path_adman hb_deal_adman  

Note:

The Adman Bidding adapter requires setup before beginning. Please contact us at prebid@admanmedia.com Due to different integration API prebid.js and prebid-server api params are different

Prebid.JS Bid Params

Name Scope Description Example Type
placementId required Adman placement id '1234asdf' 'string'

Prebid server Bid Params

Name Scope Description Example Type
TagID required Adman placement id '1234asdf' 'string'

AdMixer

Features

Bidder Code admixer Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs AdmixerID USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_admixer hb_bidder_admixer hb_adid_admixer
hb_size_admixer hb_source_admixer hb_format_admixer
hb_cache_host_admixe hb_cache_id_admixer hb_uuid_admixer
hb_cache_path_admixe hb_deal_admixer  

Bid Params

Name Scope Description Example Type
zone required The unique identifier of the ad placement. Could be obtained from the Admixer UI or from your account manager. “e5ff8e48-4bd0-4a2c-9236-55530ab8981d” string
kvTargeting optional Key/Value - a pair of the unique values that will be used for the custom targeting option. {key1: value2, key2: value2} object

Adnuntius

Features

Bidder Code adnuntius Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support no First Party Data Support yes
Multi Format Support will-bid-on-any ORTB Blocking Support no

"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_adnuntius hb_bidder_adnuntius hb_adid_adnuntius
hb_size_adnuntius hb_source_adnuntius hb_format_adnuntius
hb_cache_host_adnunt hb_cache_id_adnuntiu hb_uuid_adnuntius
hb_cache_path_adnunt hb_deal_adnuntius  

Bid Params

Name Scope Description Example Type
auId required The ad unit ID '0000000000072345' leading zeros can be omitted. '0000000000072345' string
network optional Used if you want to make requests to multiple networks in adnuntius. 'adnuntius' string
targeting optional Targeting to be sent through to adnuntius with the request. { c: ['prebids'] } string

Targeting

The Adnuntius Documentation provides detailed information on sending targeting data to the Adnuntius adserver.

Example

Here’s an example of sending targeting information about categories to adnuntius via the bid request:

{
    code: "0000000000072345",
    mediaTypes: {
        banner: {
            sizes: [[980, 360], [980, 300], [980, 240], [980, 120]]
        }
    },
    bids: [
        {
            bidder: "adnuntius",
            params: {
                auId: "8b6bc",
                network: "adnuntius",
                targeting: {
                    c: ['prebids']
                }
            }
        }
    ]
}

Sending segments to the ad server

There’s an option to send segment id in the bidder config that will be picked up and sent to the ad server. Below is an example on how to do this:

pbjs.setBidderConfig({
    bidders: ['adnuntius', 'bidderB'],
    config: {
        ortb2: {
            user: {
                data: [{
                    name: "adnuntius",
                    segment: [
                        { id: "1" },
                        { id: "2" }
                    ]
                }]
            }
        }
    }
});

Disable cookies for adnuntius

You have the option to tell adnuntius not to set cookies in your browser. This does not mean that third party ads being served through the ad server will not set cookies. Just that Adnuintius will not set it for internal ads.


pbjs.setBidderConfig({
    bidders: ['adnuntius'],
    config: {
        useCookie: false
    }
});

Use cookie will always be set to true by default. Changing it to false will disable cookies.

Prebid Server Test Request

The following test parameters can be used to verify that Prebid Server is working properly with the server-side Adnuntius adapter. the auId below will not return a creative. Please substitute it with your own.

"imp": [{
    "id": "impression-id",
    "banner": {
        "format": [{
            "w": 980,
            "h": 240
        }, {
            "w": 980,
            "h": 360
        }]
    },
    "ext": {
        "adnuntius": {
            "auId": "abc123"
        }
    }
}]

As a publisher you have the option to set no cookie in the device request to let Adnuntius adserver know not to set cookies in the client’s browser. In order to do that you just need to pass this in the request:

"device": {  
    "ext": {
        "noCookies": true
    }
},

First Party Data

publishers can use the ortb2 configuration parameter to provide First Party Data. We accept all standard OpenRTB fields for both:

  • ortb2.site
  • ortb2.user

These fields are optional and only needed for user identification and contextual targeting. How to use it can be read here: Prebid ortb2. Currently we only support this for our prebid server bidder, but will add it to the client bidder in the future.

Video requests

Currently we only support client requests and instream context. An example request would look like this:

{
    code: 'video1',
    mediaTypes: {
        video: {
            playerSize: [640, 480],
            context: 'instream'
        }
    },
    bids: [{
        bidder: 'adnuntius',
        params: {
            auId: '00000000001cd429', //put your placement id here

            video: {
                skippable: true,
                playback_method: ['auto_play_sound_off']
            }
        }
    }]
};

AdOcean

Features

Bidder Code adocean Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adocean hb_bidder_adocean hb_adid_adocean
hb_size_adocean hb_source_adocean hb_format_adocean
hb_cache_host_adocea hb_cache_id_adocean hb_uuid_adocean
hb_cache_path_adocea hb_deal_adocean  

Note

The AdOcean bid adapter may require an additional setup from the AdOcean team. Please contact with your local Technical Support team or by visiting AdOcean website.

Bid Params

Name Scope Description Example Type
slaveId required slave ID 'adoceanmyaozpniqismex' string
masterId required master ID 'tmYF.DMl7ZBq.Nqt2Bq4FutQTJfTpxCOmtNPZoQUDcL.G7' string
emiter required traffic source id 'myao.adocean.pl' string

adOmega

Features

Bidder Code adomega Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adomega hb_bidder_adomega hb_adid_adomega
hb_size_adomega hb_source_adomega hb_format_adomega
hb_cache_host_adomeg hb_cache_id_adomega hb_uuid_adomega
hb_cache_path_adomeg hb_deal_adomega  

Note:

The adOmega bidding adapter requires setup and approval before implementation. Please reach out to hi@adomega.in for more details.

Bid Params

Name Scope Description Example Type
host required Host Name 'cpm.adomega.tech' string
zoneId required Zone Id 30164 integer

Adoppler

Features

Bidder Code adoppler Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adoppler hb_bidder_adoppler hb_adid_adoppler
hb_size_adoppler hb_source_adoppler hb_format_adoppler
hb_cache_host_adoppl hb_cache_id_adoppler hb_uuid_adoppler
hb_cache_path_adoppl hb_deal_adoppler  

Bid Params

Name Scope Description Example Type
adunit required AdUnit to bid against ‘test’ string
client optional Client name ‘ads’ string

Adot

Features

Bidder Code adot Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs pubProvidedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adot hb_bidder_adot hb_adid_adot
hb_size_adot hb_source_adot hb_format_adot
hb_cache_host_adot hb_cache_id_adot hb_uuid_adot
hb_cache_path_adot hb_deal_adot  

Prebid JS

Bid Params

Name Scope Description Example Type
placementId optional The placement ID from Adot. 'adot_placement_224521' string
video optional Object containing video targeting parameters. See Video Object for details.   object

Video Object

Name Scope Description Type
container optional Selector used for finding the element in which the video player will be displayed, e.g., #div-1. The ad unit code will be used if no container is provided. string

Bid Config

PublisherId

You can set a publisherId using pbjs.setBidderConfig for the bidder adot

Example

pbjs.setBidderConfig({
    bidders: ['adot'],
    config: {
        adot: {
            publisherId: '__MY_PUBLISHER_ID__'
        }
    }
});

Specific publisher path

You can set a specific publisher path using pbjs.setBidderConfig for the bidder adot The bidrequest will add this path to the bidder endpoint

Example

pbjs.setBidderConfig({
    bidders: ['adot'],
    config: {
        adot: {
            publisherPath: '__MY_PUBLISHER_PATH__'
        }
    }
});

Prebid server

Bid Params

Name Scope Description Example Type
placementId optional An ID which identifies this placement of the impression. 'adot_placement_224521' string
parallax optional (only for prebid-server) Specify if the wanted advertising’s creative is a parallax. true/false boolean
publisherPath optional Specific to each integration. Do not use until asked by someone from adot. /hubvisor string

Testing Bid Request

The following test parameters can be used to verify that Prebid Server is working properly with the server-side adot adapter. This is a mobile Bid-request example.

  {
  "id": "b967c495-adeb-4cf3-8f0a-0d86fa17aeb2",
  "app": {
    "id": "0",
    "name": "test-adot-integration",
    "publisher": {
      "id": "1",
      "name": "Test",
      "domain": "test.com"
    },
    "bundle": "com.example.app",
    "paid": 0,
    "domain": "test.com",
    "page": "https:\/\/www.test.com\/",
    "cat": [
      "IAB1",
      "IAB6",
      "IAB8",
      "IAB9",
      "IAB10",
      "IAB16",
      "IAB18",
      "IAB19",
      "IAB22"
    ]
  },
  "device": {
    "ua": "Mozilla\/5.0 (Linux; Android 7.0; SM-G925F Build\/NRD90M; wv) AppleWebKit\/537.36 (KHTML, like Gecko) Version\/4.0 Chrome\/80.0.3987.132 Mobile Safari\/537.36",
    "make": "phone-make",
    "model": "phone-model",
    "os": "os",
    "osv": "osv",
    "ip": "0.0.0.0",
    "ifa": "IDFA",
    "carrier": "WIFI",
    "language": "English",
    "geo": {
      "zip": "75001",
      "country": "FRA",
      "type": 2,
      "lon": 48.2,
      "lat": 2.32,
      "accuracy": 100
    },
    "ext": {
      "is_app": 1
    },
    "connectiontype": 2,
    "devicetype": 4
  },
  "user": {
    "id": "IDFA",
    "buyeruid": ""
  },
  "imp": [
    {
      "id": "dec4147e-a63f-4d25-9fff-da9bfd05bd02",
      "banner": {
        "w": 320,
        "h": 50,
        "format": [
          {
            "w": 320,
            "h": 50
          }
        ],
        "api": [
          1,
          2,
          5,
          6,
          7
        ]
      },
      "bidfloorcur": "USD",
      "bidfloor": 0.1,
      "instl": 0,
      "ext": {
        "adot": {
        }
      }
    }
  ],
  "cur": [
    "USD"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "at": 1
}

Please contact admin@we-are-adot.com if you would like to build and deploy Prebid server and use it with Adot.

Adpone

Features

Bidder Code adpone Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adpone hb_bidder_adpone hb_adid_adpone
hb_size_adpone hb_source_adpone hb_format_adpone
hb_cache_host_adpone hb_cache_id_adpone hb_uuid_adpone
hb_cache_path_adpone hb_deal_adpone  

Bid Params

Name Scope Description Example Type
placementId required The placement ID from Adpone. 234234 integer

Adprime

Features

Bidder Code adprime Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adprime hb_bidder_adprime hb_adid_adprime
hb_size_adprime hb_source_adprime hb_format_adprime
hb_cache_host_adprim hb_cache_id_adprime hb_uuid_adprime
hb_cache_path_adprim hb_deal_adprime  

Note:

The Adprime Bidding adapter requires setup before beginning. Please contact us at rafal@adprime.com

Bid Params

Name Scope Description Example Type
placementId required Adprime placement id '1234asdf' string
keywords optional page context keywords [‘car’,’sport’] array
audiences optional publisher audiences [‘aud1’,’aud2’] array

Adrino

Features

Bidder Code adrino Prebid.org Member no
Media Types native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adrino hb_bidder_adrino hb_adid_adrino
hb_size_adrino hb_source_adrino hb_format_adrino
hb_cache_host_adrino hb_cache_id_adrino hb_uuid_adrino
hb_cache_path_adrino hb_deal_adrino  

Note

The Adrino bidder adapter requires setup and approval from the Adrino team. Please reach out to wydawcy@adrino.pl for more information.

Bid Params

Name Scope Description Example Type
hash required Identifier for specific ad placement 'abcdef123456' string

Native example

var adUnits = [
    code: '/12345678/prebid_native_example_1',
    mediaTypes: {
        native: {
            image: {
                required: true,
                sizes: [[300, 210],[300,150],[140,100]]
            },
            title: {
                required: true
            },
            sponsoredBy: {
                required: false
            },
            body: {
                required: false
            },
            icon: {
                required: false
            }
        }
    },
    bids: [{
        bidder: 'adrino',
        params: {
            hash: 'abcdef123456'
        }
    }]
];

Adtarget

Features

Bidder Code adtarget Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adtarget hb_bidder_adtarget hb_adid_adtarget
hb_size_adtarget hb_source_adtarget hb_format_adtarget
hb_cache_host_adtarg hb_cache_id_adtarget hb_uuid_adtarget
hb_cache_path_adtarg hb_deal_adtarget  

Registration

To use the Adtarget bidder you will need an aid from an exchange account on https://adtarget.com.tr. For further information, please contact kamil@adtarget.com.tr.

Bid params

Name Scope Description Example Type
aid required The source ID from Adtarget platform. 529814 integer

Description

Provides a solution for accessing Video demand and display demand from Adtarget

Test Parameters

    var adUnits = [

      // Video adUnit
      {
        code: 'videoPlayer',
        mediaTypes: {
          video: {
            playerSize:[640,480]
            context: 'instream'
          }
        },
        bids: [{
          bidder: 'adtarget',
          params: {
            aid: 331133
          }
        }]
      },

      // Banner adUnit
      {
        code: 'bannerAd',
        mediaTypes: {
          banner: {
            sizes: [[300, 250]]
          }
        },
        bids: [{
          bidder: 'adtarget',
          params: {
            aid: 529814
          }
        }]
      }
    ];

Additional Configuration

It is possible to configure requests to be splitted in chunks to have less bid requests in single http request (default value is 10)

    pbjs.setBidderConfig({
        config: {              
            adtarget: {
                chunkSize: 1   // makes 1 http request per 1 adunit configured
            }
        }
    });

Adtelligent

Features

Bidder Code adtelligent Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adtelligent hb_bidder_adtelligen hb_adid_adtelligent
hb_size_adtelligent hb_source_adtelligen hb_format_adtelligen
hb_cache_host_adtell hb_cache_id_adtellig hb_uuid_adtelligent
hb_cache_path_adtell hb_deal_adtelligent  

Bid params

Name Scope Description Example Type
aid required The source ID from Adtelligent. 350975 integer

Description

Get access to multiple demand partners across Adtelligent AdExchange and maximize your yield with Adtelligent header bidding adapter.

Adtelligent header bidding adapter connects with Adtelligent demand sources in order to fetch bids. This adapter provides a solution for accessing Video demand and display demand.

Adtelligent now supports adpod.

Test Parameters

    var adUnits = [

      // Video instream adUnit
      {
        code: 'test-div',
        mediaTypes: {
          video: {
            context: 'instream',
            playerSize: [640, 480]
          }
        },
        bids: [{
          bidder: 'adtelligent',
          params: {
            aid: 331133
          }
        }]
      },

      // Video outstream adUnit
      {
        code: 'test-div',
        mediaTypes: {
          video: {
            context: 'outstream',
            playerSize: [640, 480]
          }
        },
        bids: [{
          bidder: 'adtelligent',
          params: {
            aid: 331133
          }
        }]
      },

       // Video ADPOD adUnit
      {
        code: 'test-div',
        sizes: [[640, 480]],
        mediaTypes: {
          video: {
            context: 'adpod',
            playerSize: [640, 480]            
          }
        },
        bids: [{
          bidder: 'adtelligent',
          params: {
            aid: 331133
          }
        }]
      },

      // Banner adUnit
      {
        code: 'test-div',
        mediaTypes:{
            banner:{
                sizes: [[300, 250]]
            }
        }
        bids: [{
          bidder: 'adtelligent',
          params: {
            aid: 350975
          }
        }]
      }
    ];

Additional Configuration

It is possible to configure requests to be split into chunks so as to have fewer bid requests in a single http request (default value is 10).

    pbjs.setBidderConfig({
        config: {              
            adtelligent: {
                chunkSize: 1   // makes 1 http request per 1 adunit configured
            }
        }
    });

Adtarget.me

Features

Bidder Code adtrgtme Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support no First Party Data Support yes
Multi Format Support will-bid-on-one ORTB Blocking Support 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_adtrgtme hb_bidder_adtrgtme hb_adid_adtrgtme
hb_size_adtrgtme hb_source_adtrgtme hb_format_adtrgtme
hb_cache_host_adtrgt hb_cache_id_adtrgtme hb_uuid_adtrgtme
hb_cache_path_adtrgt hb_deal_adtrgtme  

Note:

The Adtrgtme bidding adapter requires setup before beginning. Please contact us at info@adtarget.me

Advangelists

Features

Bidder Code advangelists Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_advangelists hb_bidder_advangelis hb_adid_advangelists
hb_size_advangelists hb_source_advangelis hb_format_advangelis
hb_cache_host_advang hb_cache_id_advangel hb_uuid_advangelists
hb_cache_path_advang hb_deal_advangelists  

Note:

For more information about [Advangelists https://advangelists.com], please contact lokesh@advangelists.com

Bid Params

Name Scope Description Example Type
placement required   '263' string
pubid required   '0cf8d6d643e13d86a5b6374148a4afac' string
mimes optional video only ['video/mp4', 'application/javascript'] array of strings
playbackmethod optional video only [2,6] array of numbers
maxduration optional video only 30 number
skip optional video only 0 or 1 number

AdView

Features

Bidder Code AdView Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_AdView hb_bidder_AdView hb_adid_AdView
hb_size_AdView hb_source_AdView hb_format_AdView
hb_cache_host_AdView hb_cache_id_AdView hb_uuid_AdView
hb_cache_path_AdView hb_deal_AdView  

Note:

Currently adapter doesn’t support multi impression and can not perform impression splitting, so only the first impression will be delivered.

The Example Bidding adapter requires setup before beginning. Please contact us at partner@adview.com

Bid Params

Name Scope Description Example Type
placementId required Placement ID 'posid00001' string
accountId required Account ID 'accountid01' string

adxcg

Features

Bidder Code adxcg Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs id5Id, identityLink, pubCommonId, unifiedId USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adxcg hb_bidder_adxcg hb_adid_adxcg
hb_size_adxcg hb_source_adxcg hb_format_adxcg
hb_cache_host_adxcg hb_cache_id_adxcg hb_uuid_adxcg
hb_cache_path_adxcg hb_deal_adxcg  

Note

Prebid-server activation requires setup and approval before beginning. Please reach out to your account manager or info@adxcg.com for more details.

Bid Params

Name Scope Description Example Type
adzoneid required adxcg zone id '1' string

Adyoulike

Features

Bidder Code adyoulike Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs criteo, sharedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_adyoulike hb_bidder_adyoulike hb_adid_adyoulike
hb_size_adyoulike hb_source_adyoulike hb_format_adyoulike
hb_cache_host_adyoul hb_cache_id_adyoulik hb_uuid_adyoulike
hb_cache_path_adyoul hb_deal_adyoulike  

Note:

The Adyoulike Header Bidding adaptor requires setup and approval from the Adyoulike team. Please reach out to your account manager or prebid@adyoulike.com for more information.

Bid Params

Name Scope Description Example Type
placement required The placement ID from Adyoulike. '194f787b85c829fb8822cdaf1ae64435' string

Same ‘placement’ parameter can be used from either prebid JS or prebid server.

AJA

Features

Bidder Code aja Prebid.org Member no
Media Types display, video, native GDPR TCF Support no
User IDs criteo, unifiedId, imuid USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_aja hb_bidder_aja hb_adid_aja
hb_size_aja hb_source_aja hb_format_aja
hb_cache_host_aja hb_cache_id_aja hb_uuid_aja
hb_cache_path_aja hb_deal_aja  

Note

The AJA Bidding adaptor requires setup and approval before beginning. Please reach out to ssp_support@aja-kk.co.jp for more details

Bid Params

Name Scope Description Example Type
asi required ad spot hash code '123abc' string

Configuration

AJA recommends setting UserSync by iframe for monetization.

For Prebid.js v1.15.0 and later:

pbjs.setConfig({
  userSync: {
    filterSettings: {
      iframe: {
        bidders: "*", // '*' represents all bidders
        filter: "include",
      },
    },
  },
});

For Prebid.js v1.14.0 and before:

pbjs.setConfig({
  userSync: {
    iframeEnabled: true,
    enabledBidders: ["aja"],
  },
});

AlgoriX

Features

Bidder Code algorix Prebid.org Member yes
Media Types display, video, native GDPR TCF Support no
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_algorix hb_bidder_algorix hb_adid_algorix
hb_size_algorix hb_source_algorix hb_format_algorix
hb_cache_host_algori hb_cache_id_algorix hb_uuid_algorix
hb_cache_path_algori hb_deal_algorix  

Note:

AlgoriX adapter requires setup and approval from the AlgoriX team, even for existing in-app developers and publishers. Please reach out to your account team or email to prebid@algorix.co for more information.

Bid Params

Name Scope Description Example Type
sid required Sid '30014' string
token required Token '028bca2d3b5c4f0ba155fa34864b0c4d' string
placementId optional Placement Id '123456' string
appId optional App Id 'asdasdasd' string
region optional Server Region 'APAC' or 'USE' string

Note:

  • Prebid Server adapter only checks for and uses first imp bid params. All other imp bid params are ignored.
  • placementId and appId will be generated on AlgoriX Platform.
  • region is optional param, which determine the AlgoriX server. APAC for SG endpoint, USE for US endpoint, Other for Global endpoint.

Alkimi

Features

Bidder Code alkimi Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support will-bid-on-any ORTB Blocking Support 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_alkimi hb_bidder_alkimi hb_adid_alkimi
hb_size_alkimi hb_source_alkimi hb_format_alkimi
hb_cache_host_alkimi hb_cache_id_alkimi hb_uuid_alkimi
hb_cache_path_alkimi hb_deal_alkimi  

Bid Params

Name Scope Description Example Type
token required The ID issued by Alkimi to the publisher '8a80d8e9-0cf9-4329-8486-6f5bbcd8a61a' string
bidFloor required Minimum bid for this impression expressed in CPM. 0 float
pos optional Specify the position of the ad as a relative measure of visibility or prominence. Allowed values: Above the fold: 1; Below the fold: 3; Middle of the fold: 7; 0 integer

AMX RTB

Features

Bidder Code amx Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId, amxId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_amx hb_bidder_amx hb_adid_amx
hb_size_amx hb_source_amx hb_format_amx
hb_cache_host_amx hb_cache_id_amx hb_uuid_amx
hb_cache_path_amx hb_deal_amx  

Bid Params

Name Scope Description Example Type
tagId required Tag ID 'cHJlYmlkLm9yZw' string
testMode optional Activate 100% fill ads true boolean
adUnitId optional Ad Unit ID used in reporting. Will default to bid.adUnitCode 'sticky_banner' string

Test Parameters

To enable 100% fill test ads, you can use the following params:

{
  testMode: true,
  tagId: "cHJlYmlkLm9yZw"
}

This will produce a bid at $10 with a test creative.

Note that the tagId is case-sensitive. Do not use cHJlYmlkLm9yZw in production environments: this ID is for testing only.

First Party Data

From Prebid.js >= 4.30, publishers can use the ortb2 configuration parameter to provide First Party Data. We accept all standard OpenRTB fields for both:

  • ortb2.site
  • ortb2.user

Note that all fields are optional. For contextual data (e.g. categories), standard IAB taxonomies are supported. We do not support passing first party data via bid parameters.

Example - Setting ortb2.site and ortb2.user fields

pbjs.setBidderConfig({
  bidders: ["amx"],
  config: {
    ortb2: {
      site: {
        keywords: "kw1,kw2",
        cat: ["IAB2"],
        sectioncat: ["IAB2-1"],
        pagecat: ["IAB2-22"],
        content: {
          context: 5
        }
      },
      user: {
        yob: 1981,
        keywords: "kw3",
      }
    }
  }
})

Compass

Features

Bidder Code beyondmedia Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_beyondmedia hb_bidder_beyondmedi hb_adid_beyondmedia
hb_size_beyondmedia hb_source_beyondmedi hb_format_beyondmedi
hb_cache_host_beyond hb_cache_id_beyondme hb_uuid_beyondmedia
hb_cache_path_beyond hb_deal_beyondmedia  

Prebid.JS Bid Params

Name Scope Description Example Type
placementId required Placement Id '0' 'string'

Apacdex

Features

Bidder Code apacdex Prebid.org Member no
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 Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_apacdex hb_bidder_apacdex hb_adid_apacdex
hb_size_apacdex hb_source_apacdex hb_format_apacdex
hb_cache_host_apacde hb_cache_id_apacdex hb_uuid_apacdex
hb_cache_path_apacde hb_deal_apacdex  

Table of Contents

Bid Params

Name Scope Description Example Type
placementId* required Placement ID provided by Apacdex 'plc100000' string
siteId* required Publisher site ID from Apacdex 'apacdex1234' string
floorPrice optional CPM bidfloor in USD 0.03 float
geo optional GEO data of device. See Geo Object for details. {"lat":17.98928,"lon":99.7741712,"accuracy":20} object

(*) Please do not use placementId and siteId at the same time.

Geo Object

If the publisher has GEO data of the user’s device. Make it available through the geo audience so we can improve ad targeting, which means improving bids. The list of fields can be referenced in Section 3.2.19 from the OpenRTB 2.5 document.

Name Scope Description Example Type
lat required Latitude from -90.0 to +90.0, where negative is south. 17.98928 float
lon required Longitude from -180.0 to +180.0, where negative is west. 99.7741712 float
accuracy required Estimated location accuracy in meters; recommended when lat/lon are specified and derived from a device’s location services (i.e., type = 1). Note that this is the accuracy as reported from the device. Consult OS specific documentation (e.g., Android, iOS) for exact interpretation. 20 integer
lastfix optional Number of seconds since this geolocation fix was established. Note that devices may cache location data across multiple fetches. Ideally, this value should be from the time the actual fix was taken. 30 integer
utcoffset optional Local time as the number +/- of minutes from UTC. -420 integer

Video Ad Unit

Publishers declare video inventory by passing the following parameters via mediaTypes.video

Name Scope Description Example Type
context required instream or outstream "outstream" string
playerSize required width, height of the player in pixels [640,360] - will be translated to w and h in bid request array<integers>
mimes recommended List of content MIME types supported by the player (see openRTB v2.5 for options) ["video/mp4"] array<string>
protocols recommended Supported video bid response protocol values
1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
[2,3,5,6] array<integers>
api recommended Supported API framework values:
1: VPAID 1.0
2: VPAID 2.0
3: MRAID-1
4: ORMMA
5: MRAID-2
[2] array<integers>
maxduration recommended Maximum video ad duration in seconds. 30 integer
minduration recommended Minimum video ad duration in seconds 6 integer
playbackmethod recommended Playback methods that may be in use. Only one method is typically used in practice. (see openRTB v2.5 section 5.10 for options) [2] array<integers>
skip optional Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes. 1 integer
skipafter optional Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. 6 integer
minbitrate optional Minimum bit rate in Kbps. 300 integer
maxbitrate optional Maximum bit rate in Kbps. 9600 integer
startdelay* recommended Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.
>0: Mid-Roll (value indicates start delay in second)
0: Pre-Roll
-1: Generic Mid-Roll
-2: Generic Post-Roll
0 integer
placement* recommended Placement type for the impression. (see openRTB v2.5 section 5.9 for options) 1 integer

Lists of values are in the OpenRTB 2.5 documentation as referenced above.

Sample Banner Ad Unit

var adUnits = [
  {
    code: 'test-div',
    mediaTypes: {
      banner: {
        sizes: [[300, 250], [300,600]]
      }
    },
    bids: [
      {
          bidder: 'apacdex',
          params: {
              siteId: 'apacdex1234', // siteId provided by Apacdex
              floorPrice: 0.01, // default is 0.01 if not declared
          }
      }
    ]
  }
];

Sample Video Ad Unit: Instream

var instreamAdUnit = {
  code: 'test-div',
  sizes: [[640, 480]],
  mediaTypes: {
    video: {
      playerSize: [[640, 480]],
      context: "instream"
      api: [2],
      placement: 1,
      skip: 1,
      linearity: 1,
      minduration: 1,
      maxduration: 120,
      mimes: ["video/mp4", "video/x-flv", "video/x-ms-wmv", "application/vnd.apple.mpegurl", "application/x-mpegurl", "video/3gpp", "video/mpeg", "video/ogg", "video/quicktime", "video/webm", "video/x-m4v", "video/ms-asf", video/x-msvideo"],
      playbackmethod: [6],
      startdelay: 0,
      protocols: [1, 2, 3, 4, 5, 6]
    },
  },
  bids: [
    {
      bidder: 'apacdex',
      params: {
        siteId: 'apacdex1234', // siteId provided by Apacdex
        floorPrice: 0.01, // default is 0.01 if not declared
      }
    }
  ]
};

mediaTypes.video object reference to section 3.2.7 Object: Video in the OpenRTB 2.5 document You must review all video parameters to ensure validity for your player and DSPs

Sample Video Ad Unit: Outstream

var outstreamAdUnit = {
  code: 'test-div',
  sizes: [[410, 231]],
  mediaTypes: {
    video: {
      playerSize: [[410, 231]],
      context: "outstream"
      api: [2],
      placement: 5,
      linearity: 1,
      minduration: 1,
      maxduration: 120,
      mimes: ["video/mp4", "video/x-flv", "video/x-ms-wmv", "application/vnd.apple.mpegurl", "application/x-mpegurl", "video/3gpp", "video/mpeg", "video/ogg", "video/quicktime", "video/webm", "video/x-m4v", "video/ms-asf", video/x-msvideo"],
      playbackmethod: [6],
      startdelay: 0,
      protocols: [1, 2, 3, 4, 5, 6]
    },
  },
  bids: [
    {
      bidder: 'apacdex',
      params: {
        siteId: 'apacdex1234', // siteId provided by Apacdex
        floorPrice: 0.01, // default is 0.01 if not declared
      }
    }
  ]
};

mediaTypes.video object reference to section 3.2.7 Object: Video in the OpenRTB 2.5 document You must review all video parameters to ensure validity for your player and DSPs

Applogy

Features

Bidder Code applogy Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_applogy hb_bidder_applogy hb_adid_applogy
hb_size_applogy hb_source_applogy hb_format_applogy
hb_cache_host_applog hb_cache_id_applogy hb_uuid_applogy
hb_cache_path_applog hb_deal_applogy  

Bid Params

Name Scope Description Example Type
token required Applogy tokeb ‘aaaa’ string

AppNexus

Features

Bidder Code appnexus Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs criteo, flocId, identityLink, netId, pubProvidedId, uid2, unifiedId, USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_appnexus hb_bidder_appnexus hb_adid_appnexus
hb_size_appnexus hb_source_appnexus hb_format_appnexus
hb_cache_host_appnex hb_cache_id_appnexus hb_uuid_appnexus
hb_cache_path_appnex hb_deal_appnexus  

Disclosure:

This adapter is known to use an HTTP 1 endpoint. Header bidding often generates multiple requests to the same host and bidders are encouraged to change to HTTP 2 or above to help improve publisher page performance via multiplexing.

Table of Contents

All AppNexus (Xandr) placements included in a single call to requestBids must belong to the same parent Publisher. If placements from two different publishers are included in the call, the AppNexus bidder will not return any demand for those placements.
Note: This requirement does not apply to adapters that are aliasing the AppNexus adapter.

Bid Params

Name Scope Description Example Type
placement_id (PBS) or placementId (PBJS) required The placement ID from AppNexus. You may identify a placement using the invCode and member instead of a placement ID. This parameter can be either a string or integer for Prebid.js, however integer is preferred. Legacy code can retain the string value. Prebid Server requires an integer value. 234234 integer
member optional The member ID from AppNexus. Must be used with invCode. '12345' string
invCode optional The inventory code from AppNexus. Must be used with member. 'abc123' string
publisherId optional The publisher ID from AppNexus. It is used by the AppNexus end point to identify the publisher when placement id is not provided and invCode goes wrong. The publisherId parameter can be either a string or integer for Prebid.js, however integer is preferred. 12345 integer
frameworks optional Array of integers listing API frameworks for Banner supported by the publisher. integer  
user optional Object that specifies information about an external user. See User Object for details. user: { age: 25, gender: 0, dnt: true} object
allowSmallerSizes optional If true, ads smaller than the values in your ad unit’s sizes array will be allowed to serve. Defaults to false. true boolean
usePaymentRule (PBJS) or use_pmt_rule (PBS) optional If true, Appnexus will return net price to Prebid.js after publisher payment rules have been applied. true boolean
keywords optional A set of key-value pairs applied to all ad slots on the page. Mapped to buy-side segment targeting (login required). A maximum of 100 key/value pairs can be defined at the page level. Each tag can have up to 100 additional key/value pairs defined. Values can be empty. See Passing Keys Without Values below for examples. If you want to pass keywords for all adUnits, see Auction Level Keywords for an example. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an AppNexus account manager. keywords: { genre: ['rock', 'pop'] } object
video optional Object containing video targeting parameters. See Video Object for details. video: { playback_method: ['auto_play_sound_off'] } object
app optional Object containing mobile app parameters. See the App Object for details. app : { id: 'app-id'} object
reserve optional Sets a floor price for the bid that is returned. If floors have been configured in the AppNexus Console, those settings will override what is configured here unless ‘Reserve Price Override’ is checked. See Xandr docs 0.90 float
position optional Identify the placement as above or below the fold. Allowed values: Unknown: unknown; Above the fold: above; Below the fold: below 'above' string
trafficSourceCode optional Specifies the third-party source of this impression. 'my_traffic_source' string
supplyType optional Indicates the type of supply for this placement. Possible values are web, mobile_web, mobile_app 'web' string
supplyType optional Indicates the type of supply for this placement. Possible values are web, mobile_web, mobile_app 'web' string
pubClick optional Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using AppNexus click tracking properly. 'http://click.adserver.com/' string
extInvCode optional Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. '10039' string
externalImpId optional Specifies the unique identifier of an externally generated auction. 'bacbab02626452b097f6030b3c89ac05' string
generate_ad_pod_id optional Signal to AppNexus to split impressions by ad pod and add unique ad pod id to each request. Specific to long form video endpoint only. Supported by Prebid Server, not Prebid JS. true boolean

Video Object

Name Description Type
minduration Integer that defines the minimum video ad duration in seconds. integer
maxduration Integer that defines the maximum video ad duration in seconds. integer
context A string that indicates the type of video ad requested. Allowed values: "pre_roll"; "mid_roll"; "post_roll"; "outstream". string
skippable Boolean which, if true, means the user can click a button to skip the video ad. Defaults to false. boolean
skipoffset Integer that defines the number of seconds until an ad can be skipped. Assumes skippable setting was set to true. integer
playback_method A string that sets the playback method supported by the publisher. Allowed values: "auto_play_sound_on"; "auto_play_sound_off"; "click_to_play"; "mouse_over"; "auto_play_sound_unknown". string
frameworks Array of integers listing API frameworks supported by the publisher. Allowed values: None: 0; VPAID 1.0: 1; VPAID 2.0: 2; MRAID 1.0: 3; MRAID 2.0: 4; ORMMA: 5; OMID 1.0 6. Array<integer>

User Object

Name Description Example Type
age The age of the user. 35 integer
externalUid Specifies a string that corresponds to an external user ID for this user. '1234567890abcdefg' string
segments Specifies the segments to which the user belongs. [1, 2] Array<integer>
gender Specifies the gender of the user. Allowed values: Unknown: 0; Male: 1; Female: 2 1 integer
dnt Do not track flag. Indicates if tracking cookies should be disabled for this auction true boolean
language Two-letter ANSI code for this user’s language. EN string

App Object

AppNexus supports using prebid within a mobile app’s webview. If you are interested in using an SDK, please see Prebid Mobile instead.

Name Description Example Type
id The App ID. 'B1O2W3M4AN.com.prebid.webview' string
device_id Object that contains the advertising identifiers of the user (idfa, aaid, md5udid, sha1udid, or windowsadid). { aaid: "38400000-8cf0-11bd-b23e-10b96e40000d" } object
geo Object that contains the latitude (lat) and longitude (lng) of the user. { lat: 40.0964439, lng: -75.3009142 } object

Custom Targeting keys

AppNexus returns custom keys that can be sent to the adserver through bidderSettings: buyerMemberId, dealPriority, and dealCode. The following snippet demonstrates how to add these custom keys as key-value pairs.

pbjs.bidderSettings = {
  appnexus: {
    adserverTargeting: [
      {
        key: "apn_buyer_memberid", // Use key configured in your adserver
        val: function(bidResponse) {
          return bidResponse.appnexus.buyerMemberId;
        }
      },
      {
        key: "apn_prio", // Use key configured in your adserver
        val: function(bidResponse) {
          return bidResponse.appnexus.dealPriority;
        }
      }, {
        key: "apn_dealcode", // Use key configured in your adserver
        val: function(bidResponse) {
          return bidResponse.appnexus.dealCode;
        }
      }
    ]
  }
}

Auction Level Keywords

It’s possible to pass a set of keywords for the whole request, rather than a particular adUnit. Though they would apply to all adUnits (which include the appnexus bidder) in an auction, these keywords can work together with the bidder level keywords (if for example you want to have specific targeting for a particular adUnit).

Below is an example of how to define these auction level keywords for the appnexus bidder:

pbjs.setConfig({
  appnexusAuctionKeywords: {
    genre: ['classical', 'jazz'],
    instrument: 'piano'
  }
});

Like in the bidder.params.keywords, the values here can be empty. Please see the section immediately below for more details.

Passing Keys Without Values

It’s possible to use the keywords parameter to define keys that do not have any associated values. Keys with empty values can be created in Prebid.js and can also be sent through Prebid Server to AppNexus. The following are examples of sending keys with empty values:

keywords: {
  myKeyword: '',
  myOtherKeyword: ['']
}

The preceding example passes the key myKeyword with an empty value. The key myOtherKeyword contains an empty value array.

You can define keys with values and without values in the same keywords definition. In this next example, we’ve defined the key color with an array of values: red, blue, and green. We’ve followed that with the key otherKeyword with an empty value array.

keywords: {
  color: ['red', 'blue', 'green'],
  otherKeyword: ['']
}

First Party Data

Publishers should use the ortb2 method of setting First Party Data.

At this time however, the appnexus bidder only reads the First Party Data when using the Prebid Server and Prebid Server Premium endpoints. The client-side version of the appnexus bidder does not use the values from the First Party Data fields.

PBS/PSP supports all first party data fields: site, user, segments, and imp-level first party data.

User Sync in AMP

If you are syncing user id’s with Prebid Server and are using AppNexus’ managed service, see AMP Implementation Guide cookie-sync instructions for details.

Mobile App Display Manager Version

The AppNexus endpoint expects imp.displaymanagerver to be populated for mobile app sources requests, however not all SDKs will populate this field. If the imp.displaymanagerver field is not supplied for an imp, but request.app.ext.prebid.source and request.app.ext.prebid.version are supplied, the adapter will fill in a value for diplaymanagerver. It will concatenate the two app fields as <source>-<version> fo fill in the empty displaymanagerver before sending the request to AppNexus.

Debug Auction

Enabling the AppNexus Debug Auction feature should only be done for diagnosing the AppNexus auction. Do not enable this feature in a production setting where it may impact users.

To understand what is happening behind the scenes during an auction, you can enable a debug auction by adding an apn_prebid_debug cookie with a JSON string. For example:

{ "enabled": true, "dongle": "QWERTY", "debug_timeout": 1000, "member_id": 958 }

To view the results of the debug auction, add the pbjs_debug=true query string parameter and open your browser’s developer console.

Name Description Example Type
enabled Toggle the debug auction to occur true boolean
dongle Your account’s unique debug password. QWERTY string
member_id The ID of the member running the debug auction 958 integer
debug_timeout The timeout for the debug auction results to be returned 3000 integer

Prebid Server Test Request

The following test parameters can be used to verify that Prebid Server is working properly with the server-side Appnexus adapter. This example includes an imp object with an Appnexus test placement ID and sizes that would match with the test creative.

	"imp": [{
		"id": "some-impression-id",
		"banner": {
			"format": [{
				"w": 600,
				"h": 500
			}, {
				"w": 300,
				"h": 600
			}]
		},
		"ext": {
			"appnexus": {
				"placement_id": 13144370
			}
		}
	}]

Audience Network

Features

Bidder Code audienceNetwork Prebid.org Member no
Media Types display, video, native GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_audienceNetwor hb_bidder_audienceNe hb_adid_audienceNetw
hb_size_audienceNetw hb_source_audienceNe hb_format_audienceNe
hb_cache_host_audien hb_cache_id_audience hb_uuid_audienceNetw
hb_cache_path_audien hb_deal_audienceNetw  

Registration

Audience Network will not bid on requests made from device simulators. When testing for Mobile bids, you must make bid requests using a real device.

Note: Audience Network is disabled by default. Please enable it in the app config if you wish to use it. Make sure you provide the partnerID for the auctions to run correctly.

Bid Params

Name Scope Description Example Type
placementId required The Placement ID from Audience Network '555555555555555\_555555555555555' string
format optional Format, one of “native”, “fullwidth” or “video” 'native' string

Automatad OpenRTB Bid Adapter

Features

Bidder Code automatad Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support no
Multi Format Support check with bidder ORTB Blocking Support 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_automatad hb_bidder_automatad hb_adid_automatad
hb_size_automatad hb_source_automatad hb_format_automatad
hb_cache_host_automa hb_cache_id_automata hb_uuid_automatad
hb_cache_path_automa hb_deal_automatad  

Prebid.js Bid Params

Name Scope Description Example Type
siteId required The site ID from automatad. "12adf45c" string
placementId optional The placement ID from automatad. "a34gh6d" string

Prebid-Server Bid Params

Name Scope Description Example Type
position optional Position field from automatad 22390678 string
placementId optional The placement ID from automatad. "a34gh6d" string

Avocet

Features

Bidder Code avct Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_avct hb_bidder_avct hb_adid_avct
hb_size_avct hb_source_avct hb_format_avct
hb_cache_host_avct hb_cache_id_avct hb_uuid_avct
hb_cache_path_avct hb_deal_avct  

Registration

Please contact Avocet at info@avocet.io if you would like to get started selling inventory via the Avocet platform.

Bid Params

Name Scope Description Example Type
placement required A Placement ID from Avocet. "5ebd27607781b9af3ccc3332" string

Prebid Server Note: Avocet is disabled by default. Please enable it in the app config if you wish to use it. This can be done by setting adapters.avocet.disabled to false and by setting adapters.avocet.endpoint to a valid Avocet endpoint url.

Axonix

Features

Bidder Code axonix Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_axonix hb_bidder_axonix hb_adid_axonix
hb_size_axonix hb_source_axonix hb_format_axonix
hb_cache_host_axonix hb_cache_id_axonix hb_uuid_axonix
hb_cache_path_axonix hb_deal_axonix  

Prebid Server Note:

The Axonix Bidding adapter requires setup before beginning. Please contact us at support.axonix@emodoinc.com.

Bid Params

Name Scope Description Example
supplyId required Supply UUID '2c426f78-bb18-4a16-abf4-62c6cd0ee8de'
region optional Cloud region 'us-east-1'
endpoint optional Supply custom endpoint 'https://open-rtb.axonix.com/custom'
instl optional Set to 1 if using interstitial (default: 0) 1

Beachfront

Features

Bidder Code beachfront Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs unifiedId, identityLink, uid2, hadronId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_beachfront hb_bidder_beachfront hb_adid_beachfront
hb_size_beachfront hb_source_beachfront hb_format_beachfront
hb_cache_host_beachf hb_cache_id_beachfro hb_uuid_beachfront
hb_cache_path_beachf hb_deal_beachfront  

Registration

To use the beachfront bidder you will need an appId (Exchange Id) from an exchange account on platform.beachfront.io.

For further information, please contact adops@beachfront.com.

Bid Params

Name Scope Description Example Type
appId required Beachfront Exchange ID '11bc5dd5-7421-4dd8-c926-40fa653bec76' string
bidfloor required Bid floor 0.01 float
video optional Object with video parameters. See the video section below for details.   object
banner optional Object with banner parameters. See the banner section below for details.   object
player optional Object with outstream player parameters. See the player section below for details.   object

video params

Name Scope Description Example Type
appId optional Beachfront Exchange ID for video bids. '11bc5dd5-7421-4dd8-c926-40fa653bec76' string
bidfloor optional Bid floor for video bids. 0.01 float
tagid optional Tag ID 'placement-name' string
responseType optional Video response type.
both: VAST URL and VAST XML
nurl: VAST URL only
adm: VAST XML only
'both' string
mimes optional Array of strings listing supported MIME types. ["video/mp4", "application/javascript"] Array<string>
playbackmethod optional Playback method supported by the publisher.
1: Auto-play sound on
2: Auto-play sound off
3: Click-to-play
4: Mouse-over
1 integer
maxduration optional Maximum video ad duration in seconds. 30 integer
placement optional Placement type for the impression.
1: In-Stream
2: In-Banner
3: In-Article
4: In-Feed
5: Interstitial/Slider/Floating
1 integer
skip optional Indicates if the player will allow the video to be skipped. 1 integer
skipmin optional Videos of total duration greater than this number of seconds can be skippable. 15 integer
skipafter optional Number of seconds a video must play before skipping is enabled. 5 integer

Name Scope Description Example Type
appId optional Beachfront Exchange ID for banner bids. '3b16770b-17af-4d22-daff-9606bdf2c9c3' string
bidfloor optional Bid floor for banner bids. 0.01 float
tagid optional Tag ID 'placement-name' string

player params

Name Scope Description Example Type
progressColor optional The color of the progress bar formatted as a CSS value. '#50A8FA' string
adPosterColor optional The color of the ad poster formatted as a CSS value. '#FFFFFF' string
expandInView optional Defines whether to expand the player when the ad slot is in view. Defaults to false. false boolean
collapseOnComplete optional Defines whether to collapse the player when ad playback has completed. Defaults to true. true boolean

First Party Data

Publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

  • ortb2.site.*
  • ortb2.app.*
  • ortb2.user.*

Example first party data that’s available to all bidders and all adunits:

pbjs.setConfig({
    ortb2: {
        site: {
            keywords: "kw1,kw2",
            content: {
                title: "title1",
                series: "series1"
            }
        },
        user: {
            keywords: "a,b",
            gender: "M",
            yob: 1984
        }
    }
});

Prebid Server

As seen in the JSON response from {your PBS server}\/bidder\/params (example), the beachfront bidder can take either an “appId” parameter, or an “appIds” parameter. If the request is for one media type, the appId parameter should be used with the value of the Exchange Id on the Beachfront platform.

The appIds parameter is for requesting a mix of banner and video. It has two parameters, “banner”, and “video” for the appIds of two appropriately configured exchanges on the platform. The appIds parameter can be sent with just one of its two parameters and it will behave like the appId parameter.

If the request includes an appId configured for a video response, the videoResponseType parameter can be defined as “nurl”, “adm” or “both”. These will apply to all video returned. If it is not defined, the response type will be a nurl. The definitions for “nurl” vs. “adm” are here: (https://github.com/mxmCherry/openrtb/blob/master/openrtb2/bid.go).

Beintoo

Features

Bidder Code beintoo Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_beintoo hb_bidder_beintoo hb_adid_beintoo
hb_size_beintoo hb_source_beintoo hb_format_beintoo
hb_cache_host_beinto hb_cache_id_beintoo hb_uuid_beintoo
hb_cache_path_beinto hb_deal_beintoo  

Bid Params

| Name | Scope | Description | Example | Type | |—————|———-|————-|———|———-| | placementId | required | | | string | Beintoo is an aliased bidder for AppNexus

Between

Features

Bidder Code between Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_between hb_bidder_between hb_adid_between
hb_size_between hb_source_between hb_format_between
hb_cache_host_betwee hb_cache_id_between hb_uuid_between
hb_cache_path_betwee hb_deal_between  

Prebid.js Bid Params

Name Scope Description Example Type
s required Section ID from Between SSP control panel 999999 integer
cur optional 3-letter ISO 4217 code defining the currency of the bid (currently support USD and EUR), default is USD 'USD' string

Prebid-Server Bid Params

Name Scope Description Example Type
host required Between SSP host url prefix. Defines data center where requests will be sent. Choose the closest one to the prebid-server you are using. Allowed values: lbs-eu1.ads, lbs-ru1.ads, lbs-asia1.ads, lbs-us-east1.ads 'lbs-eu1.ads' string
publisher_id required Publisher ID from Between SSP control panel '123' string

Bidmachine

Features

Bidder Code bidmachine Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_bidmachine hb_bidder_bidmachine hb_adid_bidmachine
hb_size_bidmachine hb_source_bidmachine hb_format_bidmachine
hb_cache_host_bidmac hb_cache_id_bidmachi hb_uuid_bidmachine
hb_cache_path_bidmac hb_deal_bidmachine  

Prebid Server Note:

The Bidmachine Bidding adapter requires setup before beginning. Please contact us at hi@bidmachine.io .

Bid Params

Name Scope Description Example Type
host required DC region "api-eu" string
path required URL path, will be provided by manager "auction/rtb/v2" string
seller_id required Your ID in Bidmachine system "1" string

BidMyAdz

Features

Bidder Code bidmyadz Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_bidmyadz hb_bidder_bidmyadz hb_adid_bidmyadz
hb_size_bidmyadz hb_source_bidmyadz hb_format_bidmyadz
hb_cache_host_bidmya hb_cache_id_bidmyadz hb_uuid_bidmyadz
hb_cache_path_bidmya hb_deal_bidmyadz  

Prebid Server Bid Params

Currently adapter doesn’t support multiimpression, so only the first impression will be delivered

Name Scope Description Example Type
placementId required Placement Id will be generated on BidMyAdz Platform. '1234' string

BidsCube

Features

Bidder Code bidscube Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_bidscube hb_bidder_bidscube hb_adid_bidscube
hb_size_bidscube hb_source_bidscube hb_format_bidscube
hb_cache_host_bidscu hb_cache_id_bidscube hb_uuid_bidscube
hb_cache_path_bidscu hb_deal_bidscube  

Note:

The BidsCube Bidding adapter requires setup before beginning. Please contact us at support@bidscube.com

Bid Params

Name Scope Description Example Type
placementId required Placement ID '12345' string

BizzClick

Features

Bidder Code bizzclick Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_bizzclick hb_bidder_bizzclick hb_adid_bizzclick
hb_size_bizzclick hb_source_bizzclick hb_format_bizzclick
hb_cache_host_bizzcl hb_cache_id_bizzclic hb_uuid_bizzclick
hb_cache_path_bizzcl hb_deal_bizzclick  

Note:

The Example Bidding adapter requires setup before beginning. Please contact us at support@bizzclick.com .BizzClick will only respond to the first impression and that multiple ad formats of that single impression are not supported.

Bid Params

Name Scope Description Example Type
placementId required placement id 'hash' string
accountId required account id 'bizzclickTest' string

BLIINK

Features

Bidder Code bliink Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_bliink hb_bidder_bliink hb_adid_bliink
hb_size_bliink hb_source_bliink hb_format_bliink
hb_cache_host_bliink hb_cache_id_bliink hb_uuid_bliink
hb_cache_path_bliink hb_deal_bliink  

Note:

The BLIINK Header Bidding adaptor requires setup and approval from the BLIINK team. Please reach out to your account manager for more informations.

Bid Params

Name Scope Description Example Type
tagId required The TagID from BLIINK. '32' string
imageUrl optional The image url on which the ad is displayed in case of in-image ad. 'https://image.png' string

Blue

Features

Bidder Code blue Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs id5Id, identityLink, pubProvidedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_blue hb_bidder_blue hb_adid_blue
hb_size_blue hb_source_blue hb_format_blue
hb_cache_host_blue hb_cache_id_blue hb_uuid_blue
hb_cache_path_blue hb_deal_blue  

Note:

The bidder requires setup before usage. Please get in touch with our publisher team at celsooliveira@getblue.io to get started.

Bid Params

Name Scope Description Example Type
publisherId required Unique publisher ID 'ABCDEF' string

Bright Mountain Media

Features

Bidder Code bmtm Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs id5Id, sharedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_bmtm hb_bidder_bmtm hb_adid_bmtm
hb_size_bmtm hb_source_bmtm hb_format_bmtm
hb_cache_host_bmtm hb_cache_id_bmtm hb_uuid_bmtm
hb_cache_path_bmtm hb_deal_bmtm  

Bid Params

Name Scope Description Example Type
placement_id required Placement ID will be generated on Bright Mountain Media Platform 1 integer

Boldwin

Features

Bidder Code boldwin Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_boldwin hb_bidder_boldwin hb_adid_boldwin
hb_size_boldwin hb_source_boldwin hb_format_boldwin
hb_cache_host_boldwi hb_cache_id_boldwin hb_uuid_boldwin
hb_cache_path_boldwi hb_deal_boldwin  

Note

The Boldwin Bidding adapter requires setup before beginning. Please contact us at wls_team@smartyads.com

Bid Params

Name Scope Description Example Type
placementId optional Placement Id '0' string
endpointId optional Endpoint Id '0' string

For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

Brightroll

Features

Bidder Code brightroll Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_brightroll hb_bidder_brightroll hb_adid_brightroll
hb_size_brightroll hb_source_brightroll hb_format_brightroll
hb_cache_host_bright hb_cache_id_brightro hb_uuid_brightroll
hb_cache_path_bright hb_deal_brightroll  

Registration

Brightroll requires registration for each Prebid Server host company and each publisher. Contact dsp-supply-prebid@verizonmedia.com

Bid Params

Name Scope Description Example Type
publisher required Publisher Name to use ‘pub1’ string

CatapultX

Features

Bidder Code catapultx Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_catapultx hb_bidder_catapultx hb_adid_catapultx
hb_size_catapultx hb_source_catapultx hb_format_catapultx
hb_cache_host_catapu hb_cache_id_catapult hb_uuid_catapultx
hb_cache_path_catapu hb_deal_catapultx  

Bid Params

Name Scope Description Example Type
host required RTB host 'cpm.catapultx.com' string
zoneId required Zone Id 76156 integer

CodeFuel

Features

Bidder Code CodeFuel Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support no First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_CodeFuel hb_bidder_CodeFuel hb_adid_CodeFuel
hb_size_CodeFuel hb_source_CodeFuel hb_format_CodeFuel
hb_cache_host_CodeFu hb_cache_id_CodeFuel hb_uuid_CodeFuel
hb_cache_path_CodeFu hb_deal_CodeFuel  

Description

Module that connects to Codefuel bidder to fetch bids. Display format is supported but not native format. Using OpenRTB standard.

Bid Params

| Name | Scope | Description | Example | Type | |—————|———-|————————————-|——————————————|———-| | placementId | required | Placement-Id defined by the caller | '0111f8ac-2d40-4613-8557-b47dbf622fff' | string |

Configuration

    pbjs.setConfig({
    codefuel: {
        bidderUrl: 'https://prebidtest.zemanta.com/api/bidder/prebidtest/bid/'
    }
});

Coinzilla

Features

Bidder Code coinzilla Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_coinzilla hb_bidder_coinzilla hb_adid_coinzilla
hb_size_coinzilla hb_source_coinzilla hb_format_coinzilla
hb_cache_host_coinzi hb_cache_id_coinzill hb_uuid_coinzilla
hb_cache_path_coinzi hb_deal_coinzilla  

Bid Params

Name Scope Description Example Type
placementId required The placement ID(Zone Id)   string

Colossus

Features

Bidder Code colossus Prebid.org Member no
Media Types display, video, native GDPR TCF Support no
User IDs britepoolid, identityLink, unifiedId, id5Id, uid2 USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_colossus hb_bidder_colossus hb_adid_colossus
hb_size_colossus hb_source_colossus hb_format_colossus
hb_cache_host_coloss hb_cache_id_colossus hb_uuid_colossus
hb_cache_path_coloss hb_deal_colossus  

Disclosure:

This adapter is known to use an HTTP 1 endpoint. Header bidding often generates multiple requests to the same host and bidders are encouraged to change to HTTP 2 or above to help improve publisher page performance via multiplexing.

Prebid.Server Bid Params

Name Scope Description Example Type
TagID optional Placement Id will be generated on Colossus SSP Platform. '0' string
groupId optional Group Id will be generated on Colossus SSP Platform. '0' string

You only need to use one parameter: either TagID or groupId

For prebidJS parametres, look into colossusssp.md

Compass

Features

Bidder Code compass Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_compass hb_bidder_compass hb_adid_compass
hb_size_compass hb_source_compass hb_format_compass
hb_cache_host_compas hb_cache_id_compass hb_uuid_compass
hb_cache_path_compas hb_deal_compass  

Bid Params

Name Scope Description Example Type
placementId optional Placement Id '0' 'string'
endpointId optional Endpoint Id '0' 'string'

Note

For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

ConnectAd

Features

Bidder Code connectad Prebid.org Member yes
Media Types display GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_connectad hb_bidder_connectad hb_adid_connectad
hb_size_connectad hb_source_connectad hb_format_connectad
hb_cache_host_connec hb_cache_id_connecta hb_uuid_connectad
hb_cache_path_connec hb_deal_connectad  

Prebid Server Note:

Please reach out to your ConnectAd Account Manager before configuring the S2S adapter for approval and setup.

Bid Params

Name Scope Description Example Type
siteId required The site ID from ConnectAd. 12345 integer
networkId required The network ID from ConnectAd. 10047 integer
bidfloor optional Requested Floorprice 0.15 number

Consumable

Features

Bidder Code consumable Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_consumable hb_bidder_consumable hb_adid_consumable
hb_size_consumable hb_source_consumable hb_format_consumable
hb_cache_host_consum hb_cache_id_consumab hb_uuid_consumable
hb_cache_path_consum hb_deal_consumable  

Note:

The Consumable adaptor requires setup and approval from your Consumable account manager, even for existing Consumable publishers. Please reach out to your account manager to enable Prebid.js for your account.

Bid Params

Name Scope Description Example Type
siteId required The site ID from Consumable. 12345 integer
networkId required The network ID from Consumable. 9969 integer
unitId required The unit ID from Consumable. 987654 integer
unitName required The unit name from Consumable. cnsmbl-unit string

Converge-Digital

Features

Bidder Code converge Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_converge hb_bidder_converge hb_adid_converge
hb_size_converge hb_source_converge hb_format_converge
hb_cache_host_conver hb_cache_id_converge hb_uuid_converge
hb_cache_path_conver hb_deal_converge  

Note:

The Converge-Digital Bidding adapter requires setup and approval before implementation. Please reach out to info@converge-digital.com for more details.

Bid Params

Name Scope Description Example Type
host required ConvergeDigital RTB host 'cpm.convergeselect.net' string
zoneId required Zone Id 30164 integer

Conversant

Features

Bidder Code conversant Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs criteo, id5Id, identityLink, liveIntentId, parrableId, pubCommonId, unifiedId, publinkId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_conversant hb_bidder_conversant hb_adid_conversant
hb_size_conversant hb_source_conversant hb_format_conversant
hb_cache_host_conver hb_cache_id_conversa hb_uuid_conversant
hb_cache_path_conver hb_deal_conversant  

Bid Params

Name Scope Description Example Type
site_id optional The site ID from Conversant. '87293' string
secure required (for secure pages) If impression requires secure HTTPS URL creative assets and markup. 0 for non-secure, 1 for secure. Default is non-secure 1 integer
bidfloor optional Bid floor 0.50 float
tag_id optional Identifies specific ad placement. 'cnvr-test-tag' string
white_label_url optional Override the destination URL the request is sent to. 'https://mydomain.com/hbendpoint' string
pubcid_name optional Name of the pub common id. Conversant adapter can read the id directly if the UserID module is absent. Default is _pubcid. '_pubcid' string

Video Params

Name Scope Description Example Type
position optional Ad position on screen. See details below. Only supported in bids.params. 1 integer
mimes optional Array of content MIME types supported. Required for video ['video/mp4'] Array<string>
maxduration optional Maximum duration in seconds for this video as an integer. 30 integer
api optional Array of supported API frameworks. See details below. [2] Array<integer>
protocols optional Array of supported video protocols. See details below. [2] Array<integer>

Video parameters can be included in either mediaTypes.video or bids.params except where noted.

The following values are defined in the ORTB 2.5 spec.

position

  • 0 : Unknown
  • 1 : Above the Fold
  • 3 : Below the Fold
  • 4 : Header
  • 5 : Footer
  • 6 : Sidebar
  • 7 : Full Screen

api

  • 1 : VPAID 1.0
  • 2 : VPAID 2.0
  • 3 : MRAID 1.0
  • 4 : ORMMA
  • 5 : MRAID 2.0
  • 6 : MRAID 3.0

protocols

  • 1 : VAST 1.0
  • 2 : VAST 2.0
  • 3 : VAST 3.0
  • 4 : VAST 1.0 Wrapper
  • 5 : VAST 2.0 Wrapper
  • 6 : VAST 3.0 Wrapper
  • 7 : VAST 4.0
  • 8 : VAST 4.0 Wrapper
  • 9 : DAAST 1.0
  • 10 : DAAST 1.0 Wrapper

First Party Data

Publishers should use the ortb2 method of setting for setting First Party Data. Example first party data configuration that is available to all adUnits

pbjs.setConfig({
    debug: true,
    cache: {
    url: 'https://prebid.adnxs.com/pbc/v1/cache'
    },
    ortb2: { 
        site: { 
            content: { 
                series: 'MySeries', 
                season: 'My Season', 
                episode: 3, 
                title: 'My Title' 
            } 
        } 
    }
});

Example AdUnit specific data using the ortb2Imp object

        var videoAdUnit = {
            code: 'video1',
            mediaTypes: {
                video: {
                    playerSize: [[640, 480]]
                }
            },
            ortb2Imp: {
                instl: 1,
                ext: {
                    data: {
                        adUnitSpecificAttribute: "123"
                    }
                }
            },
            bids: [{
                bidder: 'conversant',
                params: {
                    site_id: '108060',
                    mimes: ['video/mp4', 'video/webm']
                }
            }]
        }

        pbjs.que.push(function(){
            pbjs.addAdUnits(videoAdUnits);
        }

CPMStar

Features

Bidder Code cpmstar Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_cpmstar hb_bidder_cpmstar hb_adid_cpmstar
hb_size_cpmstar hb_source_cpmstar hb_format_cpmstar
hb_cache_host_cpmsta hb_cache_id_cpmstar hb_uuid_cpmstar
hb_cache_path_cpmsta hb_deal_cpmstar  

Bid Params

Name Scope Description Example Type
placementId required The placement ID from CPMStar. 81006 integer

Criteo

Features

Bidder Code criteo Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, pubProvidedId, sharedId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_criteo hb_bidder_criteo hb_adid_criteo
hb_size_criteo hb_source_criteo hb_format_criteo
hb_cache_host_criteo hb_cache_id_criteo hb_uuid_criteo
hb_cache_path_criteo hb_deal_criteo  

Notes

This bidder adapter automatically includes the Criteo User ID module and performs iFrame syncs.

Prebid-Server support is on alpha test and is currently a non-finished product. Activation requires setup and approval before beginning. Please reach out to your account manager or publishers@criteo.com for more details.

Bid Params

Name Scope Description Example Type
zoneId required (deprecated) The zone ID from Criteo. Should be replaced by networkId when using zone matching. 234234 integer
networkId required The network ID from Criteo. Please reach out your Criteo representative for more details. 456456 integer
nativeCallback optional (Prebid.js only) Callback to perform render in native integrations. Please reach out your Criteo representative for more details. function(payload) { console.log(payload); } function
integrationMode optional (Prebid.js only) Integration mode to use for ad render (none or ‘AMP’). Please reach out your Criteo representative for more details. 'AMP' string
publisherSubId optional Custom identifier for reporting. Please reach out your Criteo representative for more details. 'adunit-1' string

First Party Data

Criteo supports both ortb2 (site and user) and ortb2Imp methods to set First Party Data.

Video Object

Name Scope Description Example Type
minduration optional Minimum ad duration in seconds 5 integer
startdelay optional Duration offset (in second) from the start of the content for showing the video ad before the start of the Video. Pre-roll: 0 (default); Mid-roll: >0; Default mid-roll: -1; Post-roll: -2; 5 integer
playbackmethod required Defines how the video inventory is initiated. Page Load with Sound On: 1; Page Load with Sound Off: 2; Click with Sound On: 3; Mouse-Over with Sound On: 4; Entering Viewport with Sound On: 5; Entering Viewport with Sound Off by Default: 6; [4, 5] Array<integer>
placement required Video placement type. In-Stream: 1; In-Banner: 2; In-Article: 3: In-Feed: 4; Interstitial: 5; 1 integer
skip required Ability from the video player for the user to skip the video. Not skippable: 0; Skippable: 1; 1 integer

In addition, Criteo adapter relies on parameters specified in the mediaTypes.video definition of the video ad-units, namely:

Name Scope Description Example Type
context required outstream, instream or long-form instream string
mimes required List of the content MIME types supported by the player ["video/mp4"] Array<string>
playerSize required Width and height of the player [640, 480] Array<integer>
protocols required Supported video bid response protocols. VAST 1.0: 1; VAST 2.0: 2; VAST 3.0: 3; VAST 1.0 Wrapper: 4; VAST 2.0 Wrapper: 5; VAST 3.0 Wrapper: 6; |5, 6] Array<integer>
maxduration required Maximum ad duration in seconds 20 integer
api required API frameworks supported. VPAID 1.0: 1; VPAID 2.0: 2; MRAID-1: 3; ORMMA: 4; MRAID-2: 5; [1, 2] Array<integer>

Example of Video Ad-unit

var adUnits = [
{
    code: 'video1',
    mediaTypes: {
        video: {
            playerSize: [640, 480],
            context: 'instream',
            mimes: ["video/mp4"],
            maxduration: 30,
            api: [1, 2],
            playerSize: [640,480],
            protocols: [2, 3],
	    skip: 0,
	    playbackmethod: [1],
            placement: 1
        }
    },
    bids: [{
        bidder: 'criteo',
        params: {
            zoneId: 1455580
        }
    }]
}];

Additional Config (Optional)

Criteo Bid Adapter supports the collection of the user’s hashed email, if available.

Please consider passing it to the adapter, following these guidelines.

DataBlocks

Features

Bidder Code datablocks Prebid.org Member yes
Media Types display, native GDPR TCF Support yes
User IDs criteo,unifiedId,netId,pubcid USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_datablocks hb_bidder_datablocks hb_adid_datablocks
hb_size_datablocks hb_source_datablocks hb_format_datablocks
hb_cache_host_databl hb_cache_id_databloc hb_uuid_datablocks
hb_cache_path_databl hb_deal_datablocks  

Bid Params

Name Scope Description Example Type
sourceId required Website Source Id 111 integer
host optional Network Host to request from ‘prebid.datablocks.bet’ string
tagid optional Placement ID ‘leaderboard_1’ string
vis_optout optional Opt out of visibility metric true boolean

DecenterAds

Features

Bidder Code decenterads Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_decenterads hb_bidder_decenterad hb_adid_decenterads
hb_size_decenterads hb_source_decenterad hb_format_decenterad
hb_cache_host_decent hb_cache_id_decenter hb_uuid_decenterads
hb_cache_path_decent hb_deal_decenterads  

Note:

The Example Bidding adapter requires setup before beginning. Please contact us at support@decenterads.com

Bid Params

Name Scope Description Example Type
placementId required Placement ID '12345' string

Deepintent

Features

Bidder Code deepintent Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_deepintent hb_bidder_deepintent hb_adid_deepintent
hb_size_deepintent hb_source_deepintent hb_format_deepintent
hb_cache_host_deepin hb_cache_id_deepinte hb_uuid_deepintent
hb_cache_path_deepin hb_deal_deepintent  

Bid Params

Name Scope Description Example Type
tagId mandatory Ad Tag Id '1399' string
height optional height of the creative 350 number
width optional width of the creative 250 number
custom optional custom key value params '{"position":"right-box"}'' object
user optional user params according to IAB standards '{"gender":"F"}'' object
pos optional ad position as per IAB standards 1 number

Configuration

Deepintent recommends the UserSync configuration below. Without it, the Deepintent adapter will not able to perform user syncs, which lowers match rate and reduces monetization.

pbjs.setConfig({
  userSync: {
    filterSettings: {
      iframe: {
        bidders: '*',      // '*' represents all bidders
        filter: 'include'
      }
    }
  }
});

AdUnit Format for Banner

var adUnits = [
            {
                code: 'div-22',
                mediaTypes: {
                    banner: {
                        sizes: [
                            [300, 250],
                            [300, 600]
                         ]
                    }
                },
                bids: [{
                    bidder: 'deepintent',
                    params: {
                        tagId: "1399",
                        height: 300,
                        width: 250,
                        pos: 1,
                        user: {
                            gender: "F",
                            uid: "publisher_uid",
                            buyeruid: "test_buyeruid",
                            yob: 2000  
                        },
                        custom: {
                            "position": "right-box"
                        }
                    }
                }]
            }
        ];

video parameters

Deepintent supports video as of Prebid v1.16.0

Name Scope Description Example
video.mimes required Video MIME types ['video/mp4','video/x-flv']
video.skippable optional If ‘true’, user can skip ad true
video.minduration optional Minimum ad duration in seconds 5
video.maxduration optional Maximum ad duration in seconds 30
video.startdelay optional Start delay in seconds for pre-roll, mid-roll, or post-roll ad placements 5
video.playbackmethod optional Defines whether inventory is user-initiated or autoplay sound on/off
Values:
1: Auto-play, sound on
2: Auto-play, sound off
3: Click-to-play
4: mouse-over
1
video.api optional API frameworks supported
Values:
1: VPAID 1.0
2: VPAID 2.0
3: MRAID-1
4: ORMMA
5: MRAID-2
[1, 2]
video.protocols optional Supported video bid response protocols
Values
1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
[5, 6]
video.battr optional Blocked creative attributes, See OpenRTB 2.5 specification, List 5.3 for values [3, 9]
video.linearity optional Indicates if the impression is linear or nonlinear
Values:
1: Linear/In-Stream
2: Non-Linear/Overlay.
1
video.placement optional Video placement type. See OpenRTB 2.5 specification, List 5.9 for Values 1
video.minbitrate optional Minumim bit rate in Kbps. 50
video.maxbitrate optional Maximum bit rate in Kbps. 70

AdUnit Format for Video

var videoAdUnits = [
{
    code: 'test-div-video',
    mediaTypes: {
        video: {
            playerSize: [640, 480],
            context: 'instream'
          }
    },
    bids: [{
      bidder: 'deepintent',
      params: {
        publisherId: '32572',                     // required
        adSlot: '38519891@300x250'                // required
        video: {
            mimes: ['video/mp4','video/x-flv'],   // required
            skip: 1,                              // optional
            minduration: 5,                       // optional
            maxduration: 30,                      // optional
            startdelay: 5,                        // optional
            playbackmethod: [1,3],                // optional
            api: [ 1, 2 ],                        // optional
            protocols: [ 2, 3 ],                  // optional
            battr: [ 13, 14 ],                    // optional
            linearity: 1,                         // optional
            placement: 2,                         // optional
            minbitrate: 10,                       // optional
            maxbitrate: 10                        // optional
        }
      }
    }]
}]

Denakop

Features

Bidder Code denakop Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_denakop hb_bidder_denakop hb_adid_denakop
hb_size_denakop hb_source_denakop hb_format_denakop
hb_cache_host_denako hb_cache_id_denakop hb_uuid_denakop
hb_cache_path_denako hb_deal_denakop  

Note:

The Denakop bidding adapter requires setup and approval before implementation. Please reach out to opec@denakop.com for more details.

Bid Params

Name Scope Description Example Type
host required Host Name 'cpm.denakop.com' string
zoneId required Zone Id 30164 integer

Dianomi

Features

Bidder Code dianomi Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support will-bid-on-one ORTB Blocking Support 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_dianomi hb_bidder_dianomi hb_adid_dianomi
hb_size_dianomi hb_source_dianomi hb_format_dianomi
hb_cache_host_dianom hb_cache_id_dianomi hb_uuid_dianomi
hb_cache_path_dianom hb_deal_dianomi  

Note

  • Supports display and banner formats.
  • Uses OpenRTB standard.

Registration

The Dianomi Adapter requires setup before beginning. Please contact us at eng@dianomi.com.

Bid params

Name Scope Description Example Type
smartadId required Placement ID 12345 integer
endpoint optional for testing only www-prebid.dianomi.com string

Note: smartadId is a pre agreed ID between the publisher and Dianomi.

Native example

var adUnits = [
    code: 'your-native-container-id',
    mediaTypes: {
        native: {
            image: {
                required: false,
                sizes: [100, 50]
            },
            title: {
                required: false,
                len: 140
            },
            sponsoredBy: {
                required: false
            },
            clickUrl: {
                required: false
            },
            body: {
                required: false
            },
            icon: {
                required: false,
                sizes: [50, 50]
            }
        }
    },
    bids: [{
        bidder: 'dianomi',
        params: {
            smartadId: 9607
        }
    }]
];
var adUnits = [
    code: 'your-banner-container-id',
    mediaTypes: {
      banner: {
        sizes: [[300, 250]]
      } 
    },
    bids: [{
        bidder: 'dianomi',
        params: {
            smartadId: 9607
        }
    }]
];

Video example

var adUnits = [
    code: 'your-video-container-id',
    mediaTypes: {
      video: {
        playerSize: [[640, 480]]
      } 
    },
    bids: [{
        bidder: 'dianomi',
        params: {
            smartadId: 9607
        }
    }]
];

DisplayioAds

Features

Bidder Code displayioads Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_displayioads hb_bidder_displayioa hb_adid_displayioads
hb_size_displayioads hb_source_displayioa hb_format_displayioa
hb_cache_host_displa hb_cache_id_displayi hb_uuid_displayioads
hb_cache_path_displa hb_deal_displayioads  

Note:

The DisplayioAds bidding adapter requires setup and approval before implementation. Please reach out to elena@display.io for more details.

Bid Params

Name Scope Description Example Type
host required RTB host 'cpm.displayio.cloud' string
zoneId required Zone Id 30164 integer

DistrictM DMX

Features

Bidder Code dmx Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_dmx hb_bidder_dmx hb_adid_dmx
hb_size_dmx hb_source_dmx hb_format_dmx
hb_cache_host_dmx hb_cache_id_dmx hb_uuid_dmx
hb_cache_path_dmx hb_deal_dmx  

Bid Params

Name Scope Description Example Type
seller_id required The DMX Partner ID provided upon onboarding, this is for specific setup BURL, NURL or ADM support ‘seller_id’ string
publisher_id required Boost MemberId from DistrictM UI ‘member1’ string
tagid required Represent the placement ID from DistrictM or your own ‘123abc’ string
bidfloor optional The minimum price acceptable for a bid ‘1.0’ string
memberid optional MemberId from DistrictM UI (legacy: replaced by publisher_id) ‘member1’ string
dmxid optional Placement ID from DistrictM (legacy: replaced by tagid) ‘123abc’ string

(See districtmDMX for Prebid.js)

Duration Media

Features

Bidder Code duration Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_duration hb_bidder_duration hb_adid_duration
hb_size_duration hb_source_duration hb_format_duration
hb_cache_host_durati hb_cache_id_duration hb_uuid_duration
hb_cache_path_durati hb_deal_duration  

Bid Params

Name Scope Description Example Type
siteId required siteId is provided by your Duration Media account manager(s)   integer
placementId optional placementId is provided by your Duration Media account manager(s). This parameter allows to report on a specific ad unit   integer
video optional Object containing video targeting parameters. Note that this parameter is not used in Prebid Server. See Video Object for details. video: { playback_method: ['auto_play_sound_off'] } object

Note

If you are using Google Ad Manager (GAM), it is highly recommended to make sure the “Serve in Safeframe” box in creative settings is unchecked. If you absolutely want to run Duration Media in a Saferame creative, please contact your Duration Media repsentative to coordinate this setup.

Test Parameters

    var adUnits = [
        {
            code: 'test-div1',
            mediaTypes: {
                banner: {
                    sizes: [[300, 250]],  // a display size
                }
            },
            bids: [
                {
                    bidder: "duration",
                    params: {
                        siteId: 2,
                        placementId: 3
                    }
                }
            ]
        },{
            code: 'test-div2',
            mediaTypes: {
                banner: {
                    sizes: [[320, 50]],   // a mobile size
                }
            },
            bids: [
                {
                    bidder: "duration",
                    params: {
                        siteId: 2
                    }
                }
            ]
        }
    ];

Video Object

Name Description Type
skippable Boolean which, if true, means the user can click a button to skip the video ad. Defaults to false. boolean
playback_method Array of strings listing playback methods supported by the publisher. Allowed values: "auto_play_sound_on"; "auto_play_sound_off"; "click_to_play"; "mouseover"; "auto_play_sound_unknown"; "viewport_sound_on", "viewport_sound_off". Array<string>
position Array of strings listing video player position supported by the publisher. Allowed values: "na", "atf", "btf", "head", "foot", "sidebar", "full". Array<string>
mimes Array of strings listing the content MIME types supported, e.g., ["video/x-flv", "video/x-ms-wmv"]. Array<string>
minduration Integer that defines the minimum video ad duration in seconds. integer
maxduration Integer that defines the maximum video ad duration in seconds. integer
frameworks Array of integers listing API frameworks supported by the publisher. Allowed values: None: 0; VPAID 1.0: 1; VPAID 2.0: 2; MRAID 1.0: 3; ORMMA: 4; MRAID 2.0: 5. Array<integer>

E-volution tech

Features

Bidder Code e_volution Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs id5Id USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_e_volution hb_bidder_e_volution hb_adid_e_volution
hb_size_e_volution hb_source_e_volution hb_format_e_volution
hb_cache_host_e_volu hb_cache_id_e_voluti hb_uuid_e_volution
hb_cache_path_e_volu hb_deal_e_volution  

Note:

The E-volution Bidding adapter requires setup before beginning. Please contact us at admin@e-volution.ai

Prebid.JS Bid Params

Name Scope Description Example Type
placementId required E-volution tech placement id '1234asdf' 'string'

Prebid Server Bid Params

Name Scope Description Example Type
key required E-volution integration key 'cf64c93f277afdd928d8260653d7413d' 'string'

EMX Digital

Features

Bidder Code emx_digital Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs identityLink, uid2 USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_emx_digital hb_bidder_emx_digita hb_adid_emx_digital
hb_size_emx_digital hb_source_emx_digita hb_format_emx_digita
hb_cache_host_emx_di hb_cache_id_emx_digi hb_uuid_emx_digital
hb_cache_path_emx_di hb_deal_emx_digital  

Registration

To use this bidder you will need an account and a valid tagid from our exchange. For further information, please contact your Account Manager or adops@emxdigital.com.

Bid Params

Name Scope Description Example Type
tagid required The Tag ID from EMX Digital. test1 string
bidfloor optional The CPM bid floor 0.25 string

EngageADX

Features

Bidder Code engageadx Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_engageadx hb_bidder_engageadx hb_adid_engageadx
hb_size_engageadx hb_source_engageadx hb_format_engageadx
hb_cache_host_engage hb_cache_id_engagead hb_uuid_engageadx
hb_cache_path_engage hb_deal_engageadx  

Note:

The EngageADX bidding adapter requires setup and approval before implementation. Please reach out to admin@engageadx.com for more details.

Bid Params

Name Scope Description Example Type
host required Host 'cpm.engageadx.com' string
zoneId required Zone Id 30164 integer

Engage BDR

Features

Bidder Code engagebdr Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_engagebdr hb_bidder_engagebdr hb_adid_engagebdr
hb_size_engagebdr hb_source_engagebdr hb_format_engagebdr
hb_cache_host_engage hb_cache_id_engagebd hb_uuid_engagebdr
hb_cache_path_engage hb_deal_engagebdr  

Bid Params

Name Scope Description Example Type
sspid required SSPID parameter ‘11111’ string

E-Planning

Features

Bidder Code eplanning Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_eplanning hb_bidder_eplanning hb_adid_eplanning
hb_size_eplanning hb_source_eplanning hb_format_eplanning
hb_cache_host_eplann hb_cache_id_eplannin hb_uuid_eplanning
hb_cache_path_eplann hb_deal_eplanning  

Note:

The E-Planning Header Bidding adaptor requires setup and approval from the E-Planning team. Please go to E-Planning website for more details.

Bid Params

Name Scope Description Example Type
ci required Your partner ID (provided by E-Planning) '18f66' string
sv optional Indicates a bidder URL different than default 'ads.us.e-planning.net' string
isv optional Indicates a CDN URL different than default 'us.img.e-planning.net' string
t optional Indicates bidding for testing purposes 1 integer
ml optional  Uses placement names as ad unit names instead of sizes 1 integer
sn optional  Uses space name instead of sizes adunitName string

Epom

Features

Bidder Code epom Prebid.org Member no
Media Types display, video, native GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_epom hb_bidder_epom hb_adid_epom
hb_size_epom hb_source_epom hb_format_epom
hb_cache_host_epom hb_cache_id_epom hb_uuid_epom
hb_cache_path_epom hb_deal_epom  

Note:

The Epom Bidding adapter requires setup before beginning. Please contact us at support@epom.com

Bid Params

Currently, Epom Bidding server do not support any bid parameters. We get all we need from the referring URL

eRGADX

Features

Bidder Code ergadx Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_ergadx hb_bidder_ergadx hb_adid_ergadx
hb_size_ergadx hb_source_ergadx hb_format_ergadx
hb_cache_host_ergadx hb_cache_id_ergadx hb_uuid_ergadx
hb_cache_path_ergadx hb_deal_ergadx  

Note:

The eRGADX bidding adapter requires setup and approval before implementation. Please reach out to prashant.musale@erelego.com for more details.

Bid Params

Name Scope Description Example Type
host required RTB host 'cpm.ergadx.com' string
zoneId required Zone Id 30164 integer

FutureAds

Features

Bidder Code futureads Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs AdmixerID USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_futureads hb_bidder_futureads hb_adid_futureads
hb_size_futureads hb_source_futureads hb_format_futureads
hb_cache_host_future hb_cache_id_futuread hb_uuid_futureads
hb_cache_path_future hb_deal_futureads  

Bid Params

Name Scope Description Example Type
zone required The unique identifier of the ad placement. Could be obtained from the FutureAds UI or from your account manager. “e5ff8e48-4bd0-4a2c-9236-55530ab8981d” string
kvTargeting optional Key/Value - a pair of the unique values that will be used for the custom targeting option. {key1: value2, key2: value2} object

Gamma

Features

Bidder Code gamma Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_gamma hb_bidder_gamma hb_adid_gamma
hb_size_gamma hb_source_gamma hb_format_gamma
hb_cache_host_gamma hb_cache_id_gamma hb_uuid_gamma
hb_cache_path_gamma hb_deal_gamma  

Bid Params

Name Scope Description Example Type
siteId required Site ID 1465446377 integer
zoneId required Zone ID 1515999290 integer

Gamoshi

Features

Bidder Code gamoshi Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs id5Id, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_gamoshi hb_bidder_gamoshi hb_adid_gamoshi
hb_size_gamoshi hb_source_gamoshi hb_format_gamoshi
hb_cache_host_gamosh hb_cache_id_gamoshi hb_uuid_gamoshi
hb_cache_path_gamosh hb_deal_gamoshi  

Bid params

Name Scope Description Example Type
supplyPartnerId required ID of the supply partner you created in the Gamoshi dashboard. '12345' string
rtbEndpoint optional If you have a whitelabel account on Gamoshi, specify it here. 'rtb.mybidder.com' string

This adapter only requires you to provide your supply partner ID, and optionally your RTB endpoint, in order to request bids from your Gamoshi account.

Goldbach

Features

Bidder Code goldbach Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs criteo, unifiedId, netId, identityLink, flocId, uid2 USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_goldbach hb_bidder_goldbach hb_adid_goldbach
hb_size_goldbach hb_source_goldbach hb_format_goldbach
hb_cache_host_goldba hb_cache_id_goldbach hb_uuid_goldbach
hb_cache_path_goldba hb_deal_goldbach  

Table of Contents

All Goldbach (Xandr) placements included in a single call to requestBids must belong to the same parent Publisher. If placements from two different publishers are included in the call, the Goldbach bidder will not return any demand for those placements.
Note: This requirement does not apply to adapters that are aliasing the Goldbach adapter.

Bid Params

Name Scope Description Example Type
placementId required The placement ID from Goldbach. You may identify a placement using the invCode and member instead of a placement ID. The placementID parameter can be either a string or integer for Prebid.js, however integer is preferred. Legacy code can retain the string value. Prebid Server requires an integer value. 234234 integer
member optional The member ID from Goldbach. Must be used with invCode. '12345' string
invCode optional The inventory code from Goldbach. Must be used with member. 'abc123' string
publisherId optional The publisher ID from Goldbach. It is used by the Goldbach end point to identify the publisher when placementId is not provided and invCode goes wrong. The publisherId parameter can be either a string or integer for Prebid.js, however integer is preferred. 12345 integer
frameworks optional Array of integers listing API frameworks for Banner supported by the publisher. integer  
user optional Object that specifies information about an external user. See User Object for details. user: { age: 25, gender: 0, dnt: true} object
allowSmallerSizes optional If true, ads smaller than the values in your ad unit’s sizes array will be allowed to serve. Defaults to false. true boolean
usePaymentRule (PBJS) or use_pmt_rule (PBS) optional If true, Xandr will return net price to Prebid.js after publisher payment rules have been applied. true boolean
keywords optional A set of key-value pairs applied to all ad slots on the page. Mapped to buy-side segment targeting (login required). Values can be empty. See Passing Keys Without Values below for examples. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Goldbach account manager. keywords: { genre: ['rock', 'pop'] } object
video optional Object containing video targeting parameters. See Video Object for details. video: { playback_method: ['auto_play_sound_off'] } object
app optional Object containing mobile app parameters. See the App Object for details. app : { id: 'app-id'} object
reserve optional Sets a floor price for the bid that is returned. If floors have been configured in the Goldbach Console, those settings will override what is configured here unless ‘Reserve Price Override’ is checked. See Xandr docs 0.90 float
position optional Identify the placement as above or below the fold. Allowed values: Unknown: unknown; Above the fold: above; Below the fold: below 'above' string
trafficSourceCode optional Specifies the third-party source of this impression. 'my_traffic_source' string
supplyType optional Indicates the type of supply for this placement. Possible values are web, mobile_web, mobile_app 'web' string
supplyType optional Indicates the type of supply for this placement. Possible values are web, mobile_web, mobile_app 'web' string
pubClick optional Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Goldbach click tracking properly. 'http://click.adserver.com/' string
extInvCode optional Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. '10039' string
externalImpId optional Specifies the unique identifier of an externally generated auction. 'bacbab02626452b097f6030b3c89ac05' string
generate_ad_pod_id optional Signal to Goldbach to split impressions by ad pod and add unique ad pod id to each request. Specific to long form video endpoint only. Supported by Prebid Server, not Prebid JS. true boolean

Video Object

Name Description Type
minduration Integer that defines the minimum video ad duration in seconds. integer
maxduration Integer that defines the maximum video ad duration in seconds. integer
context A string that indicates the type of video ad requested. Allowed values: "pre_roll"; "mid_roll"; "post_roll"; "outstream". string
skippable Boolean which, if true, means the user can click a button to skip the video ad. Defaults to false. boolean
skipoffset Integer that defines the number of seconds until an ad can be skipped. Assumes skippable setting was set to true. integer
playback_method A string that sets the playback method supported by the publisher. Allowed values: "auto_play_sound_on"; "auto_play_sound_off"; "click_to_play"; "mouse_over"; "auto_play_sound_unknown". string
frameworks Array of integers listing API frameworks supported by the publisher. Allowed values: None: 0; VPAID 1.0: 1; VPAID 2.0: 2; MRAID 1.0: 3; MRAID 2.0: 4; ORMMA: 5; OMID 1.0 6. Array<integer>

User Object

Name Description Example Type
age The age of the user. 35 integer
externalUid Specifies a string that corresponds to an external user ID for this user. '1234567890abcdefg' string
segments Specifies the segments to which the user belongs. [1, 2] Array<integer>
gender Specifies the gender of the user. Allowed values: Unknown: 0; Male: 1; Female: 2 1 integer
dnt Do not track flag. Indicates if tracking cookies should be disabled for this auction true boolean
language Two-letter ANSI code for this user’s language. EN string

App Object

Goldbach supports using prebid within a mobile app’s webview. If you are interested in using an SDK, please see Prebid Mobile instead.

Name Description Example Type
id The App ID. 'B1O2W3M4AN.com.prebid.webview' string
device_id Object that contains the advertising identifiers of the user (idfa, aaid, md5udid, sha1udid, or windowsadid). { aaid: "38400000-8cf0-11bd-b23e-10b96e40000d" } object
geo Object that contains the latitude (lat) and longitude (lng) of the user. { lat: 40.0964439, lng: -75.3009142 } object

Custom Targeting keys

Goldbach returns custom keys that can be sent to the adserver through bidderSettings: buyerMemberId, dealPriority, and dealCode. The following snippet demonstrates how to add these custom keys as key-value pairs.

pbjs.bidderSettings = {
  godlbach: {
    adserverTargeting: [
      {
        key: "apn_buyer_memberid", // Use key configured in your adserver
        val: function(bidResponse) {
          return bidResponse.appnexus.buyerMemberId;
        }
      },
      {
        key: "apn_prio", // Use key configured in your adserver
        val: function(bidResponse) {
          return bidResponse.appnexus.dealPriority;
        }
      }, {
        key: "apn_dealcode", // Use key configured in your adserver
        val: function(bidResponse) {
          return bidResponse.appnexus.dealCode;
        }
      }
    ]
  }
}

Passing Keys Without Values

It’s possible to use the keywords parameter to define keys that do not have any associated values. Keys with empty values can be created in Prebid.js and can also be sent through Prebid Server to Goldbach. The following are examples of sending keys with empty values:

keywords: {
  myKeyword: '',
  myOtherKeyword: ['']
}

The preceding example passes the key myKeyword with an empty value. The key myOtherKeyword contains an empty value array.

You can define keys with values and without values in the same keywords definition. In this next example, we’ve defined the key color with an array of values: red, blue, and green. We’ve followed that with the key otherKeyword with an empty value array.

keywords: {
  color: ['red', 'blue', 'green'],
  otherKeyword: ['']
}

User Sync in AMP

If you are syncing user id’s with Prebid Server and are using Goldbach’s managed service, see AMP Implementation Guide cookie-sync instructions for details.

Mobile App Display Manager Version

The Goldbach endpoint expects imp.displaymanagerver to be populated for mobile app sources requests, however not all SDKs will populate this field. If the imp.displaymanagerver field is not supplied for an imp, but request.app.ext.prebid.source and request.app.ext.prebid.version are supplied, the adapter will fill in a value for diplaymanagerver. It will concatenate the two app fields as <source>-<version> fo fill in the empty displaymanagerver before sending the request to Goldbach.

Debug Auction

Enabling the Goldbach Debug Auction feature should only be done for diagnosing the Goldbach auction. Do not enable this feature in a production setting where it may impact users.

To understand what is happening behind the scenes during an auction, you can enable a debug auction by adding an apn_prebid_debug cookie with a JSON string. For example:

{ "enabled": true, "dongle": "QWERTY", "debug_timeout": 1000, "member_id": 958 }

To view the results of the debug auction, add the pbjs_debug=true query string parameter and open your browser’s developer console.

Name Description Example Type
enabled Toggle the debug auction to occur true boolean
dongle Your account’s unique debug password. QWERTY string
member_id The ID of the member running the debug auction 958 integer
debug_timeout The timeout for the debug auction results to be returned 3000 integer

TheMediaGrid

Features

Bidder Code grid Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support will-bid-on-any ORTB Blocking Support 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_grid hb_bidder_grid hb_adid_grid
hb_size_grid hb_source_grid hb_format_grid
hb_cache_host_grid hb_cache_id_grid hb_uuid_grid
hb_cache_path_grid hb_deal_grid  

Table of Contents

Bid Params

Name Scope Description Example Type
uid required Represents the MediaGrid bidder system Ad Slot ID associated with the respective div id from the site page. 1 integer
keywords optional A set of key-value pairs applied to all ad slots on the page. Values can be empty. keywords: { topic: ['stress', 'fear'] } object
bidFloor optional Floor of the impression opportunity. If present in the request overrides XML info. 0.8 float

Parameter keywords must have following format:

{
   "site":{
      "publisher1":[
         {
            "name":"SomeKeywordsBlockName",
            "segment1Name":[
               "segment2Value"
            ],
            "segment2Name":[
               "segment2Value1",
               "segment2Value2",
               ...
            ],
            ...
         }
      ],
      ...
   }
}

Bidder Config

You can allow writing in localStorage pbjs.setBidderConfig for the bidder grid

pbjs.setBidderConfig({
    bidders: ["grid"],
    config: {
        localStorageWriteAllowed: true
    }
})

If it will be “true” this allow TheMediaGrid Bid Adapter to write userId in first party localStorage

First Party Data

Publishers should use the ortb2 method of setting First Party Data.

Global site or user data using setConfig(), or Bidder-specific using setBidderConfig() supports following fields:

  • ortb2.user.data[]: Standard IAB segment taxonomy user data
  • ortb2.user.ext.device: Non standard arbitrary user device
  • ortb2.user.keywords: Standard IAB OpenRTB 2.5 user.keywords field. It will be included in ext.keywords.user.ortb2
  • ortb2.site.keywords: Standard IAB OpenRTB 2.5 site.keywords field. It will be included in ext.keywords.site.ortb2
  • ortb2.site.cat[]: Standard IAB OpenRTB 2.5 site.cat field. It will be sent as part of site.cat array
  • ortb2.site.pagecat[]: Standard IAB OpenRTB 2.5 site.pagecat field. It will be sent as part of site.cat array
  • ortb2.site.content.genre: Standard IAB OpenRTB 2.5 site.content.genre field

AdUnit-specific data using AdUnit.ortb2Imp supports following fields:

  • ortb2.imp[].ext.data.*
  • ortb2.imp[].instl

GroupM

Features

Bidder Code groupm Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_groupm hb_bidder_groupm hb_adid_groupm
hb_size_groupm hb_source_groupm hb_format_groupm
hb_cache_host_groupm hb_cache_id_groupm hb_uuid_groupm
hb_cache_path_groupm hb_deal_groupm  

This bidder is not available in PBJS 6.24 and later.

Bid Params

Name Scope Description Example Type
publisherId required Publisher ID '32572' string
adSlot optional Ad Slot Name (see below) '38519891' string
pmzoneid optional Zone ID 'zone1,zone2' string
lat optional Latitude '40.712775' string
lon optional Longitude '-74.005973' string
yob optional Year of Birth '1982' string
gender optional Gender 'M' string
kadpageurl optional Overrides Page URL 'http://www.yahoo.com/' string
kadfloor optional Bid Floor '1.75' string
currency optional Bid currency 'AUD' (Value configured only in the 1st adunit will be passed on.
Values if present in subsequent adunits, will be ignored.)
string
dctr optional Deal Custom Targeting
(Value configured only in the 1st adunit will be passed on.
Values if present in subsequent adunits, will be ignored.)
'key1=123\|key2=345' string
bcat optional Blocked IAB Categories
(Values from all slots will be combined and only unique values will be passed. An array of strings only. Each category should be a string of a length of more than 3 characters.)
[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ] array of strings
deals optional PMP deals
(Values from each slot will be passed per slot. An array of strings only. Each deal-id should be a string of a length of more than 3 characters.)
[ 'deal-id-5', 'deal-id-6', 'deal-id-7' ] array of strings
outstreamAU optional Oustream AdUnit described in Blue BillyWig UI. This field is mandatory if mimeType is described as video and context is outstream (i.e., for outstream videos) 'renderer_test_groupm' string

GroupM is an aliased bidder of PubMatic

Prebid Server Bid Params

Name Scope Description Example Type
publisherId required Publisher ID "32572" string
adSlot optional Ad Slot Name "38519891" string
pmzoneid optional Comma separated zone id. Used im deal targeting & site section targeting. e.g drama,sport "zone1,zone2" string
dctr optional Deal Custom Targeting, pipe separated key-value pairs "key1=123\|key2=345" string
wrapper optional Specifies GroupM openwrap configuration for a publisher "wrapper": { "profile": 123, "version": 1} object
keywords optional A set of key-value pairs; A key can have one or more values associated with it. They are used in buy-side segment targeting. "keywords": { "genre": ["rock", "pop"] } object

Prebid Server Test Request

The following test parameters can be used to verify that Prebid Server is working properly with the GroupM adapter. This example includes an imp object with an GroupM test publisher ID, ad slot, and sizes that would match with the test creative.

"imp":[
      {
         "id":“"some-impression-id”,
         "banner":{
            "format":[
               {
                  "w":300,
                  "h":250
               },
               {
                  "w":300,
                  "h":600
               }
            ]
         },
         "ext":{
            "groupm":{
               "publisherId":“156276”,
               "adSlot":"groupm_test"
            }
         }
      }
   ]

GumGum

Features

Bidder Code gumgum Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs unifiedId, identityLink USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_gumgum hb_bidder_gumgum hb_adid_gumgum
hb_size_gumgum hb_source_gumgum hb_format_gumgum
hb_cache_host_gumgum hb_cache_id_gumgum hb_uuid_gumgum
hb_cache_path_gumgum hb_deal_gumgum  

Note:

The GumGum Header Bidding adaptor requires setup and approval from the GumGum team. Please reach out to your account manager or support@gumgum.com for more information.

Client side and server side parameters differ slightly. For Server side (Prebid S2S) implementation, we currently accept the zone parameter. For Client side (Prebid.js) implementation, we accept zone and a long list of other parameters which are listed below.

Server Side Bid Params

Name Scope Description Example Type
zone required for all bid requests tracking a single domain or site Tracking ID 'ggumtest' string
pubId required for all bid requests tracking multiple domains or sites Publisher ID 123 integer
irisid optional Iris.tv ID 'iris_6f9285823a4' string
slot optional Placement ID 40 number
product required for new supported products like ‘skins’ Product Type skins string

Client Side Bid Params

Name Scope Description Example Type
zone required for all bid requests tracking a single domain or site Tracking ID 'ggumtest' string
pubId required for all bid requests tracking multiple domains or sites Publisher ID 123 integer
slot required for slot placement only Slot ID 9 integer
product required for new supported products like ‘skins’ Product Type skins string
iriscat optional Iris.tv segments 'segment1,segment2' string
irisid optional Iris.tv ID '123' string
bidfloor optional CPM bidfloor in USD 0.03 float

Legacy Client Side Bid Params

Name Scope Description Example Type
inScreen required for in-screen placement only Tracking ID 'ggumtest' string
inScreenPubID required for in-screen placement only Publisher ID 123 integer
inSlot required for slot placement only Slot ID 9 integer
video required for video placement only Tracking ID 'ggumtest' string
videoPubID required for video placement only Publisher ID 123 integer
inVideo required for in-video placement only Tracking ID 'ggumtest' string
ICV required for ICV placement only ICV ID 19 integer
bidfloor optional CPM bidfloor in USD 0.03 float

Please note that both video and in-video products require a mediaType of video while all other products require a mediaType of banner.

Client Side Examples

Client side integration currently supports slot, in-screen, video, and in-video products. The following examples are based on the ‘Client Side Bid Params’ table. All bid requests require a zone or pubId parameter:

{
    bidder: 'gumgum',
    params: {
        zone: 'zone_id' // provided by GumGum
    }
}

To enable ad requests at a publisher level, instead of zone use pubId:

{           
    bidder: 'gumgum',       
    params: {       
        pubId: pub_id // provided by GumGum     
    }       
}      

In-Screen

To enable ad requests for in-screen, either zone or pubId must be present in the params object:

{
    bidder: 'gumgum',
    params: {
        zone: 'zone_id' // provided by GumGum
    }
}

Skins

Skins ad requests require the product parameter with the value of skins in the params object:

{
    bidder: 'gumgum',
    params: {
        zone: 'zone_id', // provided by GumGum
        product: 'skins'
    }
}

Slot

Slot ad requests require the slot parameter in the params object:

{
    bidder: 'gumgum',
    params: {
        zone: 'zone_id', // provided by GumGum
        slot: 'slot_id' // provided by GumGum
    }
}

Video and In-Video

For video and in-video products, please follow the configuration shown under the in-screen example. Additionally, you will need to define a ‘video’ field in the ‘mediaTypes’ object. For example:

{
    mediaTypes: {
        video: {
            context: 'instream',
            playerSize: [640, 480],
            minduration: 1,
            maxduration: 2,
            linearity: 1,	// ** Change this to 2 for in-video
            startdelay: 1,
            placement: 1,
            protocols: [1, 2]
        }
    }
}

Please note:

All fields under video (context, playerSize, minDuration etc) are the minimum requirements to make a video ad request. You should replace playerSize, minduration, maxduration, startdelay, placement, and protocols values to your specifications (see OpenRTB spec 2.5 for more information).
linearity should be set to 1 for video product, and 2 for in-video.

Server Side Examples

At the moment, the only products supported via Prebid S2S are slot, in-screen, and video. The configuration is similar to client side configuration. Add the following object in your bids array:

{
    bidder: 'gumgum',
    params: {
        zone: 'zone_id', // provided by GumGum
    }
}

Slot

The mediaTypes field should have ‘banner’ with sizes using standard IAB display sizes (as seen in the example below). The zone id is provided by GumGum.

{
    mediaTypes: {
        banner: {
            sizes: [[300, 250], [300, 600]]
        }
    },
    bids: [
        {
            bidder: 'gumgum',
            params: {
                zone: 'zone_id' // zone id is provided by GumGum
            }
        },
    ]
}

In-Screen

The adUnits settings for both in-screen and slot have a similar structure. The only difference between slot and in-screen ad unit configuration is the sizes. In-screen products require a non-standard IAB display size (e.g. [1, 1] as seen in the example below or any other size you choose).

{
    mediaTypes: {
        banner: {
            sizes: [[1, 1]]
        }
    },
    bids: [
        {
            bidder: 'gumgum',
            params: {
                zone: 'zone_id' // zone id is provided by GumGum
            }
        },
    ]
}

Skins

The skins product requires a similar setup to its client side header bidding counterpart:

{
    bids: [
        {
            bidder: 'gumgum',
            params: {
                zone: 'zone_id', // provided by GumGum
                product: 'skins'
            }
        },
    ]
}

Video

The video product requires nearly the same setup as with Prebid client side header bidding:

{
    mediaTypes: {
        video: {
            context: 'instream',
            mimes: ['video/mp4'],
            playerSize: [640, 480],
            w: 640,
            h: 480,
            minduration: 1,
            maxduration: 2,
            linearity: 1,
            startdelay: 1,
            placement: 1,
            protocols: [1, 2]
        }
    },
    bids: [
        {
            bidder: 'gumgum',
            params: {
                zone: 'zone_id' // zone id is provided by GumGum
            }
        },
    ]
}

All fields under video (context, playerSize, minDuration etc) are the minimum requirements to make a video ad request. Please replace playerSize, w, h, mimes, minduration, maxduration, startdelay, and protocols values to your specifications (see OpenRTB spec 2.5 for more information).

HuaweiAds

Features

Bidder Code huaweiads Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_huaweiads hb_bidder_huaweiads hb_adid_huaweiads
hb_size_huaweiads hb_source_huaweiads hb_format_huaweiads
hb_cache_host_huawei hb_cache_id_huaweiad hb_uuid_huaweiads
hb_cache_path_huawei hb_deal_huaweiads  

Note:

The Example Bidding adapter requires setup before beginning. Please contact us at hwads@huawei.com.

  1. The following parameters need to be registered on the HuaweiAds platform, and at the same time, the permission to access the server interface needs to be opened on the HuaweiAds platform.
  2. You can find ( publisherid, signkey, keyid ) on the platform after registration.
  3. You need to create your advertising creative on the platform and get the corresponding ( slotid, adtype ).
  4. We need OAID, GAID, IMEI (One must not be empty, you can collect OAID first, or use GAID) in our request, so when using prebidmobile, please add something like “TargetingParams.addUserData(“oaid”, “oaid-test”) TargetingParams.addUserData(“gaid”, “gaid-test”) TargetingParams.addUserData(“imei”, “imei-test”)”.
  5. You can also send the clientTime to the HuaweiAds Adx server, like “TargetingParams.addUserData(“clientTime”, “2018-11-02 16:34:07.981+0800”)”. if not, it will use the prebid server time and zone.

Bid Params

Name Scope Description Example Type
publisherid required Publisher Id '2001000399' string
signkey required Sign Key '5d********82c38594f8b2bdfd9f********a398dca734932898e3********8d' string
keyid required Key Id '2' string
slotid required Slot Id 'u42ohmaufh' string
adtype required Ad Type 'native' string

Impactify

Features

Bidder Code impactify Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs criteo, id5Id, pubCommonId, unifiedId, uid2, netId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_impactify hb_bidder_impactify hb_adid_impactify
hb_size_impactify hb_source_impactify hb_format_impactify
hb_cache_host_impact hb_cache_id_impactif hb_uuid_impactify
hb_cache_path_impact hb_deal_impactify  

Note:

The Impactify adaptator requires setup and validation from the Impactify team. Simply email us your contact details at support@impactify.io and we’ll make sure we’ll connect you within 48h.

Bid Params

Name Scope Description Example Type
appId required Impactify publisher id (Contact us) 'example.com' string
format required Impactify ad format (screen or display) 'screen' string
style required Impactify ad style (inline, impact or static) 'impact' string

Configuration

Impactify recommends the UserSync configuration below. Without it, the Impactify adapter will not be able to perform user syncs, which lowers match rate and reduces monetization.

For Prebid.js v1.15.0 and later:

pbjs.setConfig({
  userSync: {
    filterSettings: {
      iframe: {
        bidders: '*',      // '*' represents all bidders
        filter: 'include'
      }
    }
  }
});

For Prebid.js v1.14.0 and before:

pbjs.setConfig({
   userSync: {
    iframeEnabled: true,
    enabledBidders: ['impactify']
 }});

Note: Combine the above configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only the last call for a given attribute will take effect.

Improve Digital

Features

Bidder Code improvedigital Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_improvedigital hb_bidder_improvedig hb_adid_improvedigit
hb_size_improvedigit hb_source_improvedig hb_format_improvedig
hb_cache_host_improv hb_cache_id_improved hb_uuid_improvedigit
hb_cache_path_improv hb_deal_improvedigit  

Bid params

Name Scope Description Example Type
placementId required The placement ID from Improve Digital. 1234567 integer
keyValues optional Contains one or more key-value pairings for key-value targeting { testKey1: ['testValueA'], testKey2: ['testValueB', 'testValueC'] } object
bidFloor optional Bid floor price 0.01 float
bidFloorCur optional Bid floor price currency. Supported values: USD (default), EUR, GBP, AUD, DKK, SEK, CZK, CHF, NOK 'USD' string
extend optional See the Extend mode section true boolean
rendererConfig optional Configuration object for JS renderer of the RAZR creatives. Provided by Improve Digital. { key1: value1 } object
video optional Object with video parameters. See the Video params section below for details.   object

Video params

Name Scope Description Example Type
skip optional Indicates if the player will allow the video to be skipped. 1 integer
skipmin optional Videos of total duration greater than this number of seconds can be skippable. 15 integer
skipafter optional Number of seconds a video must play before skipping is enabled. 5 integer

Configuration

Sizes

By default, the adapter doesn’t send Prebid ad unit sizes to Improve Digital’s ad server and the sizes defined for each placement in the Polaris platform will be used. If the ad server should only respond with creative sizes as defined in Prebid ad unit configuration, turn on usePrebidSizes adapter parameter like this:

pbjs.setConfig({
    improvedigital: { usePrebidSizes: true }
});

Renderer Config

Global configuration for the special creative format renderer. Please use rendererConfig bid param for ad slot specific configuration.

pbjs.setConfig({
    improvedigital: {
        rendererConfig: {
            // Global config object provided by Improve Digital
        }
    }
});

Extend Mode

Improve Digital Extend mode provides publishers with access to additional demand from other SSPs. Before enabling please contact our team for more information. The Extend mode can be enabled:

  • per ad unit via the extend bid param
  • for all ad units via setConfig():
pbjs.setConfig({
    improvedigital: {
        extend: true
    }
});

Examples

Configuration With placementId

var adUnits = [{
    code: 'div-gpt-ad-1499748733608-0',
    sizes: [[600, 290]],
    bids: [
        {
            bidder: 'improvedigital',
            params: {
                placementId:1053688
            }
        }
    ]
}];

Configuration With PlacementId and Key-Values

var adUnits = [{
    code: 'div-gpt-ad-1499748733608-0',
    sizes: [[600, 290]],
    bids: [
        {
            bidder: 'improvedigital',
            params: {
               placementId:1053689,
                keyValues: {
                    testKey1: ["testValueA"],
                    testKey2: ["testValueB", "testValueC"]
                }
            }
        }
    ]
}];

InfyTV

Features

Bidder Code infytv Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_infytv hb_bidder_infytv hb_adid_infytv
hb_size_infytv hb_source_infytv hb_format_infytv
hb_cache_host_infytv hb_cache_id_infytv hb_uuid_infytv
hb_cache_path_infytv hb_deal_infytv  

Note:

The Example Bidding adapter requires setup before beginning. Please contact us at adops@infy.tv

Bid Params

Name Scope Description Example Type
publisherId required Publisher ID '11111' string
placementId optional Placement ID '11111' string

InMobi

Features

Bidder Code inmobi Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_inmobi hb_bidder_inmobi hb_adid_inmobi
hb_size_inmobi hb_source_inmobi hb_format_inmobi
hb_cache_host_inmobi hb_cache_id_inmobi hb_uuid_inmobi
hb_cache_path_inmobi hb_deal_inmobi  

Note:

The InMobi Prebid adapter requires a setup to create placement IDs. Please contact your InMobi partner manager for setup assistance. For queries, write to us at prebid-support@inmobi.com

User Sync Disclosure:

InMobi has partnered with a third party, ID5, to use their ID as our primary user identifier for mobile web supply. We will also rely on ID5 IDs to handle compliance flows related to Data Subject Right requests in our systems. Hence, we require the publisher to use ID5’s sync URL for user syncing and passing the corresponding ID5 ID to InMobi in the bid request. For this purpose, we provide ID5’s sync URL in our Prebid adapter for User ID sync. Note that, InMobi has a direct contract with ID5 for consuming ID5 ID and the user sync via Prebid does not require the publisher to get into a contractual relationship with ID5.

To opt out of InMobi ads on mobile web inventory or for any other requests, the user needs to visit the Opt-out page on InMobi website (https://www.inmobi.com/page/opt-out/). For opting out of ID5 ID entirely, the user needs to visit ID5’s opt out page: https://id5.io/platform-privacy-policy/.

Bid Params

Name Scope Description Example Type
plc required Placement ID '1234' string

InteractiveOffers

Features

Bidder Code interactiveOffers Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_interactiveOff hb_bidder_interactiv hb_adid_interactiveO
hb_size_interactiveO hb_source_interactiv hb_format_interactiv
hb_cache_host_intera hb_cache_id_interact hb_uuid_interactiveO
hb_cache_path_intera hb_deal_interactiveO  

Note:

Module that connects to interactiveOffers demand sources. Param partnerId is required.

Bid Params

Name Scope Description Example Type
partnerId required Partner id ‘abc123’ string

Example:

{
    bidder: "interactiveOffers",
    params: {
        partnerId: "abc123"
    }
}

Invibes

Features

Bidder Code invibes Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs pubCommonId, pubProvidedId, uid2, zeotapIdPlus, id5id USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_invibes hb_bidder_invibes hb_adid_invibes
hb_size_invibes hb_source_invibes hb_format_invibes
hb_cache_host_invibe hb_cache_id_invibes hb_uuid_invibes
hb_cache_path_invibe hb_deal_invibes  

Disclosure

The bidder will use the Local Storage if allowed by the publisher and user gives consent on page with the following purposes: - set an internal Invibes ID - get the internal Invibes ID if it was set priorly for the user

The bidder will NOT set any cookies. The bidder will also try to read from Cookies if publisher gibes the internal ID if this wasn’t found in LocalStorage.

Bid Params

Name Scope Description Example Type
placementId required The Invibes placement ID '1234567' string
domainId optional Id of domain 1001 integer
customEndpoint optional Custom test domain https://bid.videostep.com/Bid/VideoAdContent integer
debug optional Debug paramentes (only prebid server) { "testBvid": "1234", "testLog": true } object

IQzone

Features

Bidder Code iqzone Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_iqzone hb_bidder_iqzone hb_adid_iqzone
hb_size_iqzone hb_source_iqzone hb_format_iqzone
hb_cache_host_iqzone hb_cache_id_iqzone hb_uuid_iqzone
hb_cache_path_iqzone hb_deal_iqzone  

Prebid.js Bid Params

Name Scope Description Example Type
placementId optional Placement Id '0' 'string'
endpointId optional Endpoint Id '0' 'string'

Note

For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

Index Exchange

Features

Bidder Code ix Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs identityLink, netId, fabrickId, zeotapIdPlus, uid2, unifiedId, id5Id, lotamePanoramaId, publinkId, hadronId, pubcid USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_ix hb_bidder_ix hb_adid_ix
hb_size_ix hb_source_ix hb_format_ix
hb_cache_host_ix hb_cache_id_ix hb_uuid_ix
hb_cache_path_ix hb_deal_ix  

Overview

Module Name: Index Exchange Adapter
Module Type: Bidder Adapter
Maintainer: prebid.support@indexexchange.com

Description

Publishers may access Index Exchange’s (IX) network of demand sources through our Prebid.js and Prebid Server adapters. Both of these modules are GDPR and CCPA compliant.

IX Prebid.js Adapter

This module connects publishers to Index Exchange’s (IX) network of demand sources through Prebid.js. This module is GDPR and CCPA compliant.

It is compatible with the new Prebid.js 5.0 ad unit format where banner and video properties, including the size parameter, are stored in the adUnits[].mediaTypes object. IX still supports both size as an optional parameter and the Missing Sizes feature, but we recommend upgrading to the Prebid.js 5.0 format.

For more information about how the adUnits[].mediaTypes object is formatted in Prebid.js 5.0, refer to the following example.

var adUnits = [{
    // ...
    mediaTypes: {
        banner: {
            sizes: [
                [300, 250],
                [300, 600]
            ]
        },
        video: {
            context: 'instream',
            playerSize: [300, 250]
        }
    },
    // ...
}];

Supported Media Types (Prebid.js)

Type Support
banner Fully supported for all IX approved sizes
video Fully supported for all IX approved sizes
native Supported

Supported Media Types (Prebid Server)

Type Support
banner Fully supported
video Fully supported, including ad pods for OTT
native Supported

Ad Unit or Bidder Parameters

These params can be specified in the ad unit level, which will be the preferred way going forward with PBJS 5.0

Each of the IX-specific parameters provided under the object are detailed here.

The following parameters are specified in the ad unit adUnits[].mediaTypes. This includes each of the IX-specific parameters provided under adUnits[].bids[].params.

In Prebid.js versions 5.0 and above, mediaType and sizes are not required to be defined at the ad unit level.

Key Scope Type Description
siteId Required String An IX-specific identifier that is associated with this ad unit. It will be associated to the single size, if the size provided. This is similar to a placement ID or an ad unit ID that some other modules have. For example, '3723', '6482', '3639'
sizes Optional Number[Number[]] The size/sizes associated with the site ID, as listed in the ad unit under adUnits[].mediaTypes.banner.sizes. For example, [300, 250], [300, 600], [728, 90]

Video

Key Scope Type Description
siteId Required String An IX-specific identifier that is associated with this ad unit. It will be associated to the single size, if the size is provided. This is similar to a placement ID or an ad unit ID that some other modules have. For example, '3723', '6482', '3639'
size Optional Number[] The single size that is associated with the site ID, as listed in the ad unit under adUnits[].sizes or adUnits[].mediaTypes.video.playerSize. For example, [300, 250], [300, 600].

This parameter is optional in Prebid.js versions 5.0 and above. Versions prior to 5.0 will still require a size parameter.
video Optional Hash The video object will serve as the properties of the video ad. You can create any field under the video object that is mentioned in the OpenRTB Spec v2.5. Some fields like mimes, protocols, minduration, maxduration are required. Properties not defined at this level, will be pulled from the Adunit level.
video.w Required Integer The width of the video player in pixels that will be passed to demand partners.
*If you are using Index’s outstream player and have placed the video object at the bidder level, this is a required field. You must define the size of the video player using the video.w and video.h parameters, with a minimum video player size of 300 x 250.
video.h Required Integer The height of the video player in pixels that will be passed to demand partners.
*If you are using Index’s outstream player and have placed the video object at the bidder level, this is a required field. You must define the size of the video player using the video.w and video.h parameters, with a minimum video player size of 300 x 250.
video.playerSize Optional* Integer The video player size that will be passed to demand partners.
*If you are using Index’s outstream player and have placed the video object at the adUnit level, this is a required field. You must define the size of the video player using this parameter, with a minimum video player size of 300 x 250.
video.mimes Required String[] If you are using Index’s outstream video player and want to learn more about what is supported, see List of supported OpenRTB bid request fields for Sellers.
video.minduration Required Integer Minimum video ad duration in seconds.
video.maxduration Required Integer Maximum video ad duration in seconds.
video.protocol / video.protocols Required Integer / Integer[] Either a single protocol provided as an integer, or protocols provided as a list of integers. 2 - VAST 2.0, 3 - VAST 3.0, 5 - VAST 2.0 Wrapper, 6 - VAST 3.0 Wrapper
video.playerConfig Optional Hash The Index specific outstream player configurations.
video.playerConfig.floatOnScroll Optional Boolean A boolean specifying whether you want to use the player’s floating capabilities, where:
- true: Use the Index player’s float capabilities.
Note: If you set floatOnScroll to true, Index updates the placement value to 5.
Note: We do not recommend using the player’s default float capabilities if you have more than one outstream ad unit per page.
- false: Do not use the Index player’s float capabilities (default).
video.playerConfig.floatSize Optional Integer[] The height and width of the floating player in pixels. If you do not specify a float size, the player adjusts to the aspect ratio of the player size that is defined when it is not floating. Index recommends that you review and test the float size to your user experience preference.

Native

Index supports the native assets that Prebid.js recognizes. For the list of native assets, see Prebid.js Native Implementation Guide on the Prebid site.

Setup Guide

Follow these steps to configure and add the IX module to your Prebid.js integration.

The examples in this guide assume the following starting configuration (you may remove banner or video, if either does not apply).

In regards to video, context can either be 'instream' or 'outstream'.

var adUnits = [{
    code: 'banner-div-a',
    mediaTypes: {
        banner: {
            sizes: [
                [300, 250],
                [300, 600]
            ]
        }
    },
    bids: []
},
{
    code: 'video-div-a',
    mediaTypes: {
        video: {
            context: 'instream',
            playerSize: [1280, 720]
        }
    },
    bids: []
}];

1. Add IX to the appropriate ad units

For each size in an ad unit that IX will be bidding on, add one of the following bid objects under adUnits[].bids:

{
    bidder: 'ix',
    params: {
        siteId: '123456'
    }
}

Set params.siteId in the bid object to the values provided by your IX representative.

Examples

Banner:

var adUnits = [{
    code: 'banner-div-a',
    mediaTypes: {
        banner: {
            sizes: [
                [300, 250],
                [300, 600]
            ]
        }
    },
    bids: [{
        bidder: 'ix',
        params: {
            siteId: '123456'
        }
    }, {
        bidder: 'ix',
        params: {
            siteId: '123456'
        }
    }]
}];

Video (Instream):

var adUnits = [{
    code: 'video-div-a',
    mediaTypes: {
        video: {
            // Preferred location for openrtb v2.5 compatible video obj
            context: 'instream',
            playerSize: [300, 250],
            api: [2],
            protocols: [2, 3, 5, 6],
            minduration: 5,
            maxduration: 30,
            mimes: ['video/mp4', 'application/javascript'],
            placement: 3
        }
    },
    bids: [{
        bidder: 'ix',
        params: {
            siteId: '12345'
        }
    }, {
        bidder: 'ix',
        params: {
            siteId: '12345',
            video: {
                // openrtb v2.5 compatible video obj
                // If required, use this to override mediaTypes.video.XX properties
            }
        }
    }]
}];

Please note that you can re-use the existing siteId within the same flex position.

Video (Outstream): Publishers have two options to receive outstream video demand from Index:

Index’s outstream video player Publishers who are using Index as a bidding adapter in Prebid.js can show outstream video ads on their site from us by using Index’s outstream video player. This allows a video ad to display inside of a video player and can be placed anywhere on a publisher’s site, such as in-article, in-feed, and more.

Define a new video object for our outstream video player at either the adUnit level or the bidder level. If you are setting it at the bidder level, define the size of the video player using the parameters video.h and video.w. If you are setting it at the adUnit level, define the size using video.playerSize.</br>Note: The bidder level video configurations override the adunit level configurations. The playerConfig is only a bidder level configuration.

For more information on how to structure the video object, refer to the following code example:

var adUnits = [{
    code: 'div-gpt-ad-1571167646410-1',
    mediaTypes: {
        video: {
            playerSize: [640, 360],
            context: 'outstream',
            api: [2],
            protocols: [2, 3, 5, 6],
            minduration: 5,
            maxduration: 30,
            mimes: ['video/mp4', 'application/javascript'],
            placement: 5
        }
    },
    bids: [{
        bidder: 'ix',
        params: {
            siteId: '715964'
            video: {
                playerConfig: {
                    floatOnScroll: true,
                    floatSize: [300,250]
                }
            }
        }
    }]
}];

Please note that your use of the outstream video player will be governed by and subject to the terms and conditions of i) any master services or license agreement entered into by you and Index Exchange; ii) the information provided on our knowledge base linked here and here, and iii) our Privacy Policy. Your use of Index’s outstream video player constitutes your acknowledgement and acceptance of the foregoing.

Video Caching

Note that the IX adapter expects a client-side Prebid Cache to be enabled for instream video bidding.

pbjs.setConfig({
    usePrebidCache: true,
    cache: {
        url: 'https://prebid.adnxs.com/pbc/v1/cache'
    }
});

Native

We support the three native template rendering options that are provided in the Setting up Prebid Native in Google Ad Manager. The following code is an example of a Prebid native set up using Google Ad Manager, but the concept and implementation should be similar for other ad servers.

pbjs.addAdUnits({
    code: slot.code,
    mediaTypes: {
        native: {
            image: {
                required: true,
                sizes: [150, 50]
            },
            title: {
                required: true,
                len: 80
            },
            sponsoredBy: {
                required: true
            },
            clickUrl: {
                required: true
            },
            privacyLink: {
                required: false
            },
            body: {
                required: true
                len: 90
            },
            icon: {
                required: true,
                sizes: [50, 50]
            }
        }
    },
    bids: [{
        bidder: 'ix',
        params: {
            siteId: '715966'
        }
    }]
});

User Sync

Add the following code to enable user sync. IX strongly recommends enabling user syncing through iFrames. This functionality improves DSP user match rates and increases the IX bid rate and bid price. Be sure to call pbjs.setConfig() only once. Note: While we recommend iframe-based user syncing, we also support image-based user syncing. If both are enabled, we will default to using iframe, because it allows us more flexibility to optimize the frequency, timing, and coverage for syncing.

pbjs.setConfig({
    userSync: {
        iframeEnabled: true,
        filterSettings: {
            iframe: {
                bidders: ['ix'],
                filter: 'include'
            }
        }
    }
});

The detectMissingSizes feature

By default, the IX bidding adapter bids on all banner sizes available in the ad unit when configured to at least one banner size. If you want the IX bidding adapter to only bid on the banner size it’s configured to, switch off this feature using detectMissingSizes.

pbjs.setConfig({
    ix: {
        detectMissingSizes: false
    }
});

OR

pbjs.setBidderConfig({
    bidders: ["ix"],
    config: {
        ix: {
            detectMissingSizes: false
        }
    }
});

2. Include ixBidAdapter in your build process

When running the build command, include ixBidAdapter as a module, as well as dfpAdServerVideo if you require video support.

gulp build --modules=ixBidAdapter,dfpAdServerVideo,fooBidAdapter,bazBidAdapter

If a JSON file is being used to specify the bidder modules, add "ixBidAdapter" to the top-level array in that file.

[
    "ixBidAdapter",
    "dfpAdServerVideo",
    "fooBidAdapter",
    "bazBidAdapter"
]

And then build.

gulp build --modules=bidderModules.json

Setting First Party Data (FPD)

As a part of 4.30, IX will start to pick up FPD in the global FPD module, as well as continue to pick up IX bidder-specific FPD. Previous versions of IX Bid Adapter will only support the IX bidder-specific FPD.

Global FPD

As of Prebid.js 4.30, use the more generic ortb2 interface, which can be used for more than just First Party Data.

The First Party Data feature allows publishers to specify key/value data in one place where each compatible bid adapter can read it.

To supply global data, use the setConfig() function as illustrated below:

pbjs.setConfig({
   ortb2: {
       site: {
            ...
       },
       user: {
            ...
       }
    }
});

Use the setBidderConfig() function to supply bidder-specific data.

For more information about the standard or more detailed examples, refer to First Party Data Feature.

IX bidder-specific FPD

FPD allows you to specify key-value pairs that are passed as part of the query string to IX for use in Private Marketplace Deals which rely on query string targeting for activation. For example, if a user is viewing a news-related page, you can pass on that information by sending category=news. Then in the IX Private Marketplace setup screens, you can create Deals which activate only on pages that contain category=news. Please reach out to your IX representative if you have any questions or need help setting this up.

To include FPD in a bid request, it must be set before pbjs.requestBids is called. To set it, call pbjs.setConfig and provide it with a map of FPD keys to values as such:

pbjs.setConfig({
    ix: {
        firstPartyData: {
            '<key name>': '<key value>',
            '<key name>': '<key value>',
            // ...
        }
    }
});

The values can be updated at any time by calling pbjs.setConfig again. The changes will be reflected in any proceeding bid requests.

Continue to use IX bidder-specific First Party Data for IX deals. Global First Party Data is not yet supported in IX deals. Consult your IX representative with any questions.

Setting a Server Side Timeout

Setting a server-side timeout allows you to control the max length of time taken to connect to the server. The default value when unspecified is 50ms.

This is distinctly different from the global bidder timeout that can be set in Prebid.js in the browser.

To add a server-side timeout, it must be set before pbjs.requestBids is called. To set it, call pbjs.setConfig and provide it with a timeout value as such:

pbjs.setConfig({
    ix: {
        timeout: 50
    }
});

The timeout value must be a positive whole number in milliseconds.

IX Prebid Server Adapter

Publishers who would like to retrieve IX demand via a Prebid Server instance can do so by adding IX to the list of bidders for a Prebid Server bid request, with a valid site ID. For example:

"imp": [
  {
    "id": "test2",
    "banner": {
      "format": [
        {
          "w": 300,
          "h": 600
        }
      ]
    },
    "ext": {
      "ix": {
        "siteId": "12345"
      }
    }
  }
]

Important Prebid Server Note

Any party operating their own hosted Prebid Server instances must reach out to IX (prebid.support@indexexchange.com) to receive approval and customized setup instructions. Please do not send Prebid Server requests without first contacting us – you will not receive bid responses.

Additional Information

Bid Request Limit

If a single bid request to IX contains more than 20 impression requests (i.e. more than 20 objects in bidRequest.imp), only the first 20 will be accepted, the rest will be ignored.

To avoid this situation, ensure that when pbjs.requestBid is invoked, that the number of bid objects (i.e. adUnits[].bids) with adUnits[].bids[].bidder set to 'ix' across all ad units that bids are being requested for does not exceed 20.

Time-To-Live (TTL)

Banner bids from Index have a TTL of 600 seconds while video bids have a TTL of 3 hours, after which time they become invalid.</br> Note: Index supports the bid.exp attribute in the bid response which allows our adapter to specify the maximum number of seconds allowed between the auction and billing notice. In the absence of the bid.exp attribute, the TTL provided above applies.

FAQs

Why do I have to input size in adUnits[].bids[].params for IX when the size is already in the ad unit?

If you are using Prebid.js version 5.0 and above, the size parameter is not a required field. Only the siteID is required, and it is stored with the sizes in the ad unit.

How can I view the bid request sent to IX by Prebid.js?

In your browser of choice, create a new tab and open the developer tools. In developer tools, select the network tab. Then, navigate to a page where IX is set up to bid. Now, in the network tab, search for requests to casalemedia.com/cygnus. These are the bid requests.

JANet

Features

Bidder Code janet Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_janet hb_bidder_janet hb_adid_janet
hb_size_janet hb_source_janet hb_format_janet
hb_cache_host_janet hb_cache_id_janet hb_uuid_janet
hb_cache_path_janet hb_deal_janet  

Bid params

Name Scope Description Example Type
aid required The source ID from janet. 529814 integer

Description

JANet header bidding adapter connects with JANet demand sources in order to fetch bids. This adapter provides a solution for accessing Video demand and display demand.

Test Parameters

    var adUnits = [

      // Video instream adUnit
      {
        code: 'test-div',
        mediaTypes: {
          video: {
            context: 'instream',
            playerSize: [640, 480]
          }
        },
        bids: [{
          bidder: 'janet',
          params: {
            aid: 472386
          }
        }]
      },

      // Video outstream adUnit
      {
        code: 'test-div',
        mediaTypes: {
          video: {
            context: 'outstream',
            playerSize: [640, 480]
          }
        },
        bids: [{
          bidder: 'janet',
          params: {
            aid: 472386
          }
        }]
      },

       // Video ADPOD adUnit
      {
        code: 'test-div',
        sizes: [[640, 480]],
        mediaTypes: {
          video: {
            context: 'adpod',
            playerSize: [640, 480]            
          }
        },
        bids: [{
          bidder: 'janet',
          params: {
            aid: 472386
          }
        }]
      },

      // Banner adUnit
      {
        code: 'test-div',
        mediaTypes:{
            banner:{
                sizes: [[300, 250]]
            }
        }
        bids: [{
          bidder: 'janet',
          params: {
            aid: 529814
          }
        }]
      }
    ];

Additional Configuration

It is possible to configure requests to be split into chunks so as to have fewer bid requests in a single http request (default value is 10).

    pbjs.setBidderConfig({
        config: {              
            janet: {
                chunkSize: 1   // makes 1 http request per 1 adunit configured
            }
        }
    });

Jixie

Features

Bidder Code jixie Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs uid2, unifiedId USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_jixie hb_bidder_jixie hb_adid_jixie
hb_size_jixie hb_source_jixie hb_format_jixie
hb_cache_host_jixie hb_cache_id_jixie hb_uuid_jixie
hb_cache_path_jixie hb_deal_jixie  

Registration

To use this bidder you will need an account and a valid unit from us. For further information, please contact contact@jixie.io

Bid Params

Name Scope Description Example Type
unit required The unit from jixie '1000012-VyuoGmDQQQ' string
accountid optional The accountid from jixie '12345678901234567890' string
jxprop1 optional special property #1 'somethingspecial1' string
jxprop2 optional special property #2 'somethingspecial2' string

Kargo

Features

Bidder Code kargo Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs unifiedId USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support no
Multi Format Support will-bid-on-any ORTB Blocking Support 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_kargo hb_bidder_kargo hb_adid_kargo
hb_size_kargo hb_source_kargo hb_format_kargo
hb_cache_host_kargo hb_cache_id_kargo hb_uuid_kargo
hb_cache_path_kargo hb_deal_kargo  

Disclosure:

This adapter is known to use an HTTP 1 endpoint. Header bidding often generates multiple requests to the same host and bidders are encouraged to change to HTTP 2 or above to help improve publisher page performance via multiplexing.

Note:

Kargo is an invitation-only marketplace. Please reach out to your Kargo account manager to get setup. Also, you must test on a mobile device, or emulate a mobile device by manipulating the user agent string sent to the server.

Bid Params

Name Scope Description Example Type
tagid required openrtb2.BidRequest.Imp[0].TagID '31355' string

Kidoz

Features

Bidder Code kidoz Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_kidoz hb_bidder_kidoz hb_adid_kidoz
hb_size_kidoz hb_source_kidoz hb_format_kidoz
hb_cache_host_kidoz hb_cache_id_kidoz hb_uuid_kidoz
hb_cache_path_kidoz hb_deal_kidoz  

Registration

Kidoz is exclusively for Mobile app COPPA compatible ads, 100% kid relevant and appropriate.

In order for a company to receive bids from Kidoz, they must first open a publisher account at Kidoz.net (https://accounts.kidoz.net/publishers/register) and accept the Kidoz Terms and Conditions and Privacy Policy. Kidoz publishers must confirm that all of their content properties are COPPA and GDPR compliant and perform no monitoring or tracking of U13 users in their operations. New publishers are provided a Publisher ID and AccessToken, this can also be used to login to their dashboard at the Kidoz.net portal to monitor their account activity.

Bid Params

Name Scope Description Example Type
access_token required Kidoz access_token ‘123abc’ string
publisher_id required Kidoz publisher_id ‘44444’ string

Krushmedia

Features

Bidder Code krushmedia Prebid.org Member no
Media Types display, video, native GDPR TCF Support no
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_krushmedia hb_bidder_krushmedia hb_adid_krushmedia
hb_size_krushmedia hb_source_krushmedia hb_format_krushmedia
hb_cache_host_krushm hb_cache_id_krushmed hb_uuid_krushmedia
hb_cache_path_krushm hb_deal_krushmedia  

Bid Params

Name Scope Description Example Type
key required Unique client id on krushmedia platform 0 string

Kubient

Features

Bidder Code kubient Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_kubient hb_bidder_kubient hb_adid_kubient
hb_size_kubient hb_source_kubient hb_format_kubient
hb_cache_host_kubien hb_cache_id_kubient hb_uuid_kubient
hb_cache_path_kubien hb_deal_kubient  

Note:

The Kubient Bidder Adapter requires setup and approval before beginning. Please reach out to prebid@kubient.com for more details.

Banner Settings:

var adUnits = [ { code: ‘banner-ad-unit’, mediaTypes: { banner: { sizes: [[300, 100]] } }, bids: [{ bidder: ‘kubient’, params: { zoneid: “5fbb948f1e22b”, } }] } ];

Video Settings:

var adUnits = [ { code: ‘video-ad-unit’, mediaTypes: { video: { playerSize: [300, 250], // required context: ‘instream’, // required mimes: [‘video/mp4’,’video/x-flv’], // required protocols: [ 2, 3 ], // required, set at least 1 value in array placement: 1, // optional, defaults to 2 when context = outstream api: [ 1, 2 ], // optional skip: 0, // optional minduration: 5, // optional maxduration: 30, // optional playbackmethod: [1,3], // optional battr: [ 13, 14 ], // optional linearity: 1, // optional minbitrate: 10, // optional maxbitrate: 10 // optional } }, bids: [{ bidder: ‘kubient’, params: { zoneid: “60ad1c0b35864”, } }] } ];

Bid Params

Name Scope Description Example Type
zoneid required The AdUnit or Tag specific ID '5fbb948f1e22b' string

Lifestreet

Features

Bidder Code lifestreet Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_lifestreet hb_bidder_lifestreet hb_adid_lifestreet
hb_size_lifestreet hb_source_lifestreet hb_format_lifestreet
hb_cache_host_lifest hb_cache_id_lifestre hb_uuid_lifestreet
hb_cache_path_lifest hb_deal_lifestreet  

Bid Params

Name Scope Description Example Type
slot required Ad Slot 'slot166704' string
adkey required Ad Key '78c' string
ad_size required Ad Size '160x600' string

LockerDome

Features

Bidder Code lockerdome Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_lockerdome hb_bidder_lockerdome hb_adid_lockerdome
hb_size_lockerdome hb_source_lockerdome hb_format_lockerdome
hb_cache_host_locker hb_cache_id_lockerdo hb_uuid_lockerdome
hb_cache_path_locker hb_deal_lockerdome  

Bid Params

Name Scope Description Example Type
adUnitId required The ad unit ID from LockerDome 'LD10809467961050726' string

Logicad for Publishers

Features

Bidder Code logicad Prebid.org Member no
Media Types display, native GDPR TCF Support no
User IDs all USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_logicad hb_bidder_logicad hb_adid_logicad
hb_size_logicad hb_source_logicad hb_format_logicad
hb_cache_host_logica hb_cache_id_logicad hb_uuid_logicad
hb_cache_path_logica hb_deal_logicad  

Bid Params

Name Scope Description Example Type
tid required Logicad for Publishers placement ID 'PJ2P' string
page optional Url of the webpage where the request is originating from 'url' string
cur optional Currency of request and response (Default: JPY ) 'JPY' string
test optional Indicates bidding for testing purposes true boolean

Luna Media

Features

Bidder Code lunamedia Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_lunamedia hb_bidder_lunamedia hb_adid_lunamedia
hb_size_lunamedia hb_source_lunamedia hb_format_lunamedia
hb_cache_host_luname hb_cache_id_lunamedi hb_uuid_lunamedia
hb_cache_path_luname hb_deal_lunamedia  

Note:

For more information about Luna Media, please contact info@lunamedia.io

Bid Params

Name Scope Description Example Type
placement required   '263' string
pubid required   '0cf8d6d643e13d86a5b6374148a4afac' string
mimes optional video only ['video/mp4', 'application/javascript'] array of strings
playbackmethod optional video only [2,6] array of numbers
maxduration optional video only 30 number
skip optional video only 0 or 1 number

Madvertise

Features

Bidder Code madvertise Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_madvertise hb_bidder_madvertise hb_adid_madvertise
hb_size_madvertise hb_source_madvertise hb_format_madvertise
hb_cache_host_madver hb_cache_id_madverti hb_uuid_madvertise
hb_cache_path_madver hb_deal_madvertise  

Prebid.js Bid Params

Name Scope Description Example Type
zoneId required Prebid version 5.x+ Zone code. This parameter should be the unique Publisher ID of your mobile application or website. /1111111/banner string
s required in-scope only for 4.x Zone code. This parameter should be the unique Publisher ID of your mobile application or website. Replace by zoneId starting 5.x /1111111/banner string
lat optional Latitude 48.866667 float
long optional Longitude 2.333333 float
age optional Age 19 integer
gender optional Gender m or f 'f' string
locale optional Locale 'fr' string
floor optional Bid floor 1.0 float

Example

{
    bidder: 'madvertise',
    params: { 
            zoneId: "/4543756/prebidadaptor/madvertiseHB",
            tgt:'aa=a;bb=b'
    }
}

Prebid Server Bid Params

Name Scope Description Example Type
zoneId required The zone ID provided by Madvertise. '/1111111/banner' string

Example

{
    "id": "some-request-id",
    "test": 1,
    "site": {
        "page": "prebid.org"
    },
    "imp": [
        {
            "id": "some-impression-id",
            "banner": {
                "format": [
                    {
                        "w": 320,
                        "h": 50
                    }
                ]
            },
            "ext": {
                "prebid": {
                    "bidder": {
                        "madvertise": {
                            "zoneId": "/1111111/banner"
                        }
                    }
                }
            }
        }
    ],
    "tmax": 1000
}

Marsmedia

Features

Bidder Code marsmedia Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_marsmedia hb_bidder_marsmedia hb_adid_marsmedia
hb_size_marsmedia hb_source_marsmedia hb_format_marsmedia
hb_cache_host_marsme hb_cache_id_marsmedi hb_uuid_marsmedia
hb_cache_path_marsme hb_deal_marsmedia  

Bid Params

Name Scope Description Example Type
zoneId required The zone ID from Mars Media Group. 9999 integer
var adUnits = [
{
  code: 'marsmedia-ad-123456-1', // ad slot HTML element ID  
  mediaTypes: {
    banner: {  
      sizes: [
          [300, 250]
      ]
    }   
  } 
  bids: [{
    bidder: 'marsmedia',
    params: {
        zoneId: 9999    // required 
    }
  }]
}

Instream Video - Ad Unit Setup

var adUnits = [
{
  code: 'marsmedia-ad-123456-1', // ad slot HTML element ID  
  mediaTypes: {
    video: {                                // We recommend setting the following video params
                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation. 
      playerSize: [300, 250],               // required
      context: 'instream',                  // required
      mimes: ['video/mp4','video/x-flv'],   // required
      protocols: [ 2, 3 ],                  // required, set at least 1 value in array
      placement: 1,                         // optional, defaults to 1 when context = instream
      startdelay: 0,                        // optional, defaults to 0 when context = instream
      api: [ 1, 2 ],                        // optional
      skip: 0,                              // optional
      minduration: 5,                       // optional
      maxduration: 30,                      // optional
      playbackmethod: [1,3],                // optional
      battr: [ 13, 14 ],                    // optional
      linearity: 1,                         // optional
      minbitrate: 10,                       // optional
      maxbitrate: 10                        // optional
    }   
  }, 
  bids: [{
    bidder: 'marsmedia',
    params: {
        zoneId: 9999    // required    
    }
  }],
  ...
}

MediaFuse

Features

Bidder Code mediafuse Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_mediafuse hb_bidder_mediafuse hb_adid_mediafuse
hb_size_mediafuse hb_source_mediafuse hb_format_mediafuse
hb_cache_host_mediaf hb_cache_id_mediafus hb_uuid_mediafuse
hb_cache_path_mediaf hb_deal_mediafuse  

Prebid Server Test Request

The following test parameters can be used to verify that Prebid Server is working properly with the server-side Mediafuse adapter. This example includes an Mediafuse test placement ID and sizes that would match with the test creative.

var adUnits = [
   // Banner adUnit
   {
      code: 'banner-div',
      mediaTypes: {
        banner: {
          sizes: [[300, 250], [300,600]]
        }
      },
      bids: [{
         bidder: 'mediafuse',
         params: {
           placementId: 13144370
         }
       }]
   },
   // Native adUnit
   {
      code: 'native-div',
      sizes: [[1, 1]],
      mediaTypes: {
        native: {
          title: {
            required: true
          },
          body: {
            required: true
          },
          image: {
            required: true
          },
          sponsoredBy: {
            required: true
          },
          icon: {
            required: false
          }
        }
      },
      bids: [{
        bidder: 'mediafuse',
        params: {
          placementId: 13232354,
          allowSmallerSizes: true
        }
      }]
   },
   // Video instream adUnit
   {
      code: 'video-instream',
      sizes: [[640, 480]],
      mediaTypes: {
        video: {
          playerSize: [[640, 480]],
          context: 'instream'
        },
      },
      bids: [{
        bidder: 'mediafuse',
        params: {
          placementId: 13232361,
          video: {
            skippable: true,
            playback_methods: ['auto_play_sound_off']
          }
        }
      }]
   },
   // Video outstream adUnit
   {
     code: 'video-outstream',
     sizes: [[300, 250]],
     mediaTypes: {
       video: {
         playerSize: [[300, 250]],
         context: 'outstream',
         // Certain ORTB 2.5 video values can be read from the mediatypes object; below are examples of supported params.
         // To note - mediafuse supports additional values for our system that are not part of the ORTB spec.  If you want
         // to use these values, they will have to be declared in the bids[].params.video object instead using the mediafuse syntax.
         // Between the corresponding values of the mediaTypes.video and params.video objects, the properties in params.video will 
         // take precedence if declared; eg in the example below, the `skippable: true` setting will be used instead of the `skip: 0`.
         minduration: 1,
         maxduration: 60,
         skip: 0,   // 1 - true, 0 - false
         skipafter: 5,
         playbackmethod: [2], // note - we only support options 1-4 at this time
         api: [1,2,3]   // note - option 6 is not supported at this time
       }
     },
     bids: [
       {
         bidder: 'mediafuse',
         params: {
           placementId: 13232385,
           video: {
             skippable: true,
             playback_method: 'auto_play_sound_off'
           }
         }
       }
     ]
   },
   // Banner adUnit in a App Webview
   // Only use this for situations where prebid.js is in a webview of an App
   // See Prebid Mobile for displaying ads via an SDK
   {
     code: 'banner-div',
     mediaTypes: {
       banner: {
         sizes: [[300, 250], [300,600]]
       }
     }
     bids: [{
       bidder: 'mediafuse',
       params: {
         placementId: 13144370,
         app: {
           id: "B1O2W3M4AN.com.prebid.webview",
           geo: {
             lat: 40.0964439,
             lng: -75.3009142
           },
           device_id: {
             idfa: "4D12078D-3246-4DA4-AD5E-7610481E7AE", // Apple advertising identifier
             aaid: "38400000-8cf0-11bd-b23e-10b96e40000d", // Android advertising identifier
             md5udid: "5756ae9022b2ea1e47d84fead75220c8", // MD5 hash of the ANDROID_ID
             sha1udid: "4DFAA92388699AC6539885AEF1719293879985BF", // SHA1 hash of the ANDROID_ID
             windowsadid: "750c6be243f1c4b5c9912b95a5742fc5" // Windows advertising identifier
           }
         }
       }
     }]
   }
];

Media.net

Features

Bidder Code medianet Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_medianet hb_bidder_medianet hb_adid_medianet
hb_size_medianet hb_source_medianet hb_format_medianet
hb_cache_host_median hb_cache_id_medianet hb_uuid_medianet
hb_cache_path_median hb_deal_medianet  

Bid Params

Name Scope Description Example Type
cid required The customer id provided by Media.net. '8CUX0H51C' string
crid required The placement id provided by Media.net '1234567' string
bidfloor optional Bidfloor for the impression 1.0 float
video required for video Ad units Object containing video targeting parameters. See Video Object for details. video: { maxduration: 60 } object

Video Object

Name Type Description Example
mimes array of strings (Recommended) Specifies the video content MIME types supported; for example, video/x-ms-wmv and video/x-flv. [“video/x-ms-wmv”,”video/x-flv”]
minduration integer (Recommended) Specifies the minimum video ad duration, in seconds. 10
maxduration integer (Recommended) Specifies the maximum video ad duration, in seconds. 60
w integer (Recommended) Specifies the width of the video player, in pixels. Required if playerSize not present in mediaTypes.video 640
h integer (Recommended) Specifies the height of the video player, in pixels. Required if playerSize not present in mediaTypes.video 480
startdelay integer (Recommended) Specifies the start delay of the video ad 0
battr array of integers Specifies the video creative attributes to block. Refer to section 5.3 of the IAB specification for a list of attributes. [ 13, 14 ]
playbackmethod array of integers Specifies the allowed playback methods. If not specified, all are assumed to be allowed. Currently supported values are: 1: Autoplay, sound on; 2: Autoplay, sound off; 3: Click to play; 4: Mouse over to play [1, 3]
api array of integers Specifies the supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported. Currently supported values are: 1: VPAID 1.0; 2: VPAID 2.0; 3: MRAID-1; 4: ORMMA; 5: MRAID-2 [1, 2]
protocols array of integers Array of supported video protocols. Currently supported values are: 1: VAST 1.0; 2: VAST 2.0; 3: VAST 3.0; 4: VAST 1.0 Wrapper; 5: VAST 2.0 Wrapper; 6: VAST 3.0 Wrapper; 7: VAST 4.0 [1, 2]
placement integer Placement type for the impression. Possible options: 1: In-Stream; 2: In-banner; 3: Outstream/In-article; 4: In-feed; 5: Interstitial/Slider/Floating; 6: Long-Form; 1

Besides the above-mentioned parameters, we support all other OpenRTB 2.x video objects as optional parameters.

In addition to bids[].params.video, Media.net adapter consumes parameters specified in the mediaTypes.video.

Example of Instream Video Ad-unit

var videoAdUnit = {
  code: 'video1',
  mediaTypes: {
    video: {
      context: "instream",
      playerSize: [640, 480],
      mimes: ['video/mp4'],
      placement: 1
    }
  },
  bids: [{
    bidder: 'medianet',
    params: {
      cid: '8CUX0H51C',
      crid: '776755783',  
      // Site member is to be used only for testing
      site: {
        page: 'http://smoketesting.net/prebidtest/',
        domain: 'smoketesting.net',
        ref: 'http://smoketesting.net/prebidtest/'
      }
    }
  }]
};

Example of Native Ad-unit

var adUnits = [{
  code: 'div-gpt-ad-1544091247692-0',
  mediaTypes: {
    native: {
      image: {
        required: true,
        sizes: [300, 250],
        wmin: 50,
      },
      title: {
        required: true,
        len: 80
      }
    }
  },
  bids: [{
    bidder: 'medianet',
    params: {
      cid: '8CUX0H51C',
      crid: '776755783',
      // Site member is to be used only for testing
      site: {
        page: 'http://smoketesting.net/prebidtest/',
        domain: 'smoketesting.net',
        ref: 'http://smoketesting.net/prebidtest/'
      }
    }
  }]
}];

Example of Banner Ad-unit

var adUnits = [{
  code: 'div-gpt-ad-1460505748561-0',
  mediaTypes: {
    banner: {
      sizes: [
        [728, 90],
        [300, 600],
        [300, 250]
      ],
    }
  },
  bids: [{
    bidder: 'medianet',
    params: {
      cid: '8CUX0H51C',
      crid: '451466393',
      // Site member is to be used only for testing
      site: {
        page: 'http://smoketesting.net/prebidtest/',
        domain: 'smoketesting.net',
        ref: 'http://smoketesting.net/prebidtest/'
      }
    }
  }]
}];

Mgid

Features

Bidder Code mgid Prebid.org Member no
Media Types display, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_mgid hb_bidder_mgid hb_adid_mgid
hb_size_mgid hb_source_mgid hb_format_mgid
hb_cache_host_mgid hb_cache_id_mgid hb_uuid_mgid
hb_cache_path_mgid hb_deal_mgid  

Table of Contents

Description

One of the easiest way to gain access to MGID demand sources - MGID header bidding adapter.

MGID header bidding adapter connects with MGID demand sources to fetch bids for display placements. Please reach out to your account manager or prebid@mgid.com for more information.

Bid params

Name Scope Description Example Type
accountId required The account ID from Mgid '123' string
placementId optional The placement ID from Mgid '123456' string
bidFloor optional Lowest value of expected bid price 1.1 float
currency optional Currency of request and response 'GBP' string

Test Parameters

300x600 banner test

var adUnits = [{
  code: 'div-prebid',
  mediaTypes: {
    banner: {
      sizes: [[300, 600]]
    }
  },
  // Replace this object to test a new Adapter!
  bids: [{
    bidder: 'mgid',
    params : {
      accountId : "219" //test accountId, please replace after test
    }
  }]
}];

300x250 banner test

var adUnits = [{
  code: 'div-prebid',
  mediaTypes: {
    banner: {
      sizes: [[300, 250]]
    }
  },
  // Replace this object to test a new Adapter!
  bids: [{
    bidder: 'mgid',
    params : {
      accountId : "219" //test accountId, please replace after test
    }
  }]
}];

native test

var adUnits = [{
  code: 'div-prebid',
  mediaTypes: {
    native: {
        image: {
            sendId: true,
            required: true,
            sizes: [80, 80]
        },
        clickUrl: {
            sendId: true,
            required: false
        },
        title: {
            required: true,
            len: 80
        },
        sponsored: {
            required: false
        }
    }
  },
  // Replace this object to test a new Adapter!
  bids: [{
    bidder: 'mgid',
    params : {
        accountId : "219" //test accountId, please replace after test
    }
  }]
}];

Mobfox_PB

Features

Bidder Code mobfoxpb Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_mobfoxpb hb_bidder_mobfoxpb hb_adid_mobfoxpb
hb_size_mobfoxpb hb_source_mobfoxpb hb_format_mobfoxpb
hb_cache_host_mobfox hb_cache_id_mobfoxpb hb_uuid_mobfoxpb
hb_cache_path_mobfox hb_deal_mobfoxpb  

Prebid.JS Bid Params

Name Scope Description Example Type
placementId required Placement Id will be generated on Mobfox Platform. '0' string

Prebid Server Bid Params

Currently adapter doesn’t support multiimpression, so only the first impression will be delivered

Name Scope Description Example Type
TagID required Placement Id will be generated on Mobfox Platform. For direct integration '0' string
key required Endpoint id will be generated on Mobfox Platform. For s2s integration '0' string

MobileFuse

Features

Bidder Code mobilefuse Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support yes

"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_mobilefuse hb_bidder_mobilefuse hb_adid_mobilefuse
hb_size_mobilefuse hb_source_mobilefuse hb_format_mobilefuse
hb_cache_host_mobile hb_cache_id_mobilefu hb_uuid_mobilefuse
hb_cache_path_mobile hb_deal_mobilefuse  

Bid Params

Name Scope Description Example Type
placement_id required An ID which identifies this specific inventory placement 1111 integer
pub_id required An ID which identifies the publisher selling the inventory 2222 integer
tagid_src optional ext if passing publisher’s ids, empty if passing MobileFuse IDs in placement_id field. Defaults to empty ’’ string

Motionspots

Features

Bidder Code motionspots Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_motionspots hb_bidder_motionspot hb_adid_motionspots
hb_size_motionspots hb_source_motionspot hb_format_motionspot
hb_cache_host_motion hb_cache_id_motionsp hb_uuid_motionspots
hb_cache_path_motion hb_deal_motionspots  

Note:

The Motionspots bidding adapter requires setup and approval before implementation. Please reach out to kiran@collectcent.com for more details.

Bid Params

Name Scope Description Example Type
host required RTB host 'cpm.motionspots.com' string
zoneId required Zone Id 30164 integer

Nano Interactive

Features

Bidder Code nanointeractive Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_nanointeractiv hb_bidder_nanointera hb_adid_nanointeract
hb_size_nanointeract hb_source_nanointera hb_format_nanointera
hb_cache_host_nanoin hb_cache_id_nanointe hb_uuid_nanointeract
hb_cache_path_nanoin hb_deal_nanointeract  

Requirements:

To be able to get identification key (pid), please contact us at
https://www.nanointeractive.com/publishers

Bid Params

Name Scope Description Example Type
pid required Identification key, provided by Nano Interactive '5afaa0280ae8996eb578de53' string
category optional Contextual taxonomy 'automotive' string
categoryName optional Contextual taxonomy (from URL query param) 'cat_name' string
nq optional User search query 'automobile search query' string
name optional User search query (from URL query param) 'search_param' string
subId optional Channel - used to separate traffic sources '123' string

Configuration

The category and categoryName are mutually exclusive. If you pass both, categoryName takes precedence.
The nq and name are mutually exclusive. If you pass both, name takes precedence.

Example with only required field pid

var adUnits = [{
    code: 'nano-div',
    sizes: [[300, 250], [300,600]],
    bids: [{
        bidder: 'nanointeractive',
        params: {
            pid: '5afaa0280ae8996eb578de53'
        }
    }]
}];

Example with category

var adUnits = [{
    code: 'nano-div',
    sizes: [[300, 250], [300,600]],
    bids: [{
        bidder: 'nanointeractive',
        params: {
            pid: '5afaa0280ae8996eb578de53',
            category: 'automotive',
            subId: '123'
        }
    }]
}];

Example with categoryName

var adUnits = [{
    code: 'nano-div',
    sizes: [[300, 250], [300,600]],
    bids: [{
        bidder: 'nanointeractive',
        params: {
            pid: '5afaa0280ae8996eb578de53',
            // Category "automotive" is in the URL like:
            // https://www....?cat_name=automotive&...
            categoryName: 'cat_name',
            subId: '123'
        }
    }]
}];

Example with nq

var adUnits = [{
    code: 'nano-div',
    sizes: [[300, 250], [300,600]],
    bids: [{
        bidder: 'nanointeractive',
        params: {
            pid: '5afaa0280ae8996eb578de53',
            // User searched "automobile search query" (extracted from search text field)
            nq: 'automobile search query',
            subId: '123'
        }
    }]
}];

Example with name

var adUnits = [{
    code: 'nano-div',
    sizes: [[300, 250], [300,600]],
    bids: [{
        bidder: 'nanointeractive',
        params: {
            pid: '5afaa0280ae8996eb578de53',
            // User searched "automobile search query" and it is in the URL like:
            // https://www....?search_param=automobile%20search%20query&...
            name: 'search_param',
            subId: '123'
        }
    }]
}];

Example with category and nq

var adUnits = [{
    code: 'nano-div',
    sizes: [[300, 250], [300,600]],
    bids: [{
        bidder: 'nanointeractive',
        params: {
            pid: '5afaa0280ae8996eb578de53',
            category: 'automotive',
            nq: 'automobile search query',
            subId: '123'
        }
    }]
}];

Example with categoryName and name

var adUnits = [{
    code: 'nano-div',
    sizes: [[300, 250], [300,600]],
    bids: [{
        bidder: 'nanointeractive',
        params: {
            pid: '5afaa0280ae8996eb578de53',
            categoryName: 'cat_name',
            name: 'search_param',
            subId: '123'
        }
    }]
}];

NextMillennium

Features

Bidder Code nextMillennium Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support no First Party Data Support no
Multi Format Support check with bidder ORTB Blocking Support 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_nextMillennium hb_bidder_nextMillen hb_adid_nextMillenni
hb_size_nextMillenni hb_source_nextMillen hb_format_nextMillen
hb_cache_host_nextMi hb_cache_id_nextMill hb_uuid_nextMillenni
hb_cache_path_nextMi hb_deal_nextMillenni  

bid params

Name Scope Description Example Type
placement_id required Placement ID, provided by nextMillennium '12345' String
group_id optional Group ID, provided by nextMillennium '12345' String

Required one of the two parameters placement_id or group_id.

Further information for the auction on NextMillennium side is generated automatically.

NinthDecimal

Features

Bidder Code ninthdecimal Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_ninthdecimal hb_bidder_ninthdecim hb_adid_ninthdecimal
hb_size_ninthdecimal hb_source_ninthdecim hb_format_ninthdecim
hb_cache_host_ninthd hb_cache_id_ninthdec hb_uuid_ninthdecimal
hb_cache_path_ninthd hb_deal_ninthdecimal  

Bid Params

Name Scope Description Example Type
pubid required An id used to identify NinthDecimal publisher ‘abcd1234’ string
placement optional A placement created on adserver. ‘1111’ string

Nobid

Features

Bidder Code nobid Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_nobid hb_bidder_nobid hb_adid_nobid
hb_size_nobid hb_source_nobid hb_format_nobid
hb_cache_host_nobid hb_cache_id_nobid hb_uuid_nobid
hb_cache_path_nobid hb_deal_nobid  

Bid Params

Name Scope Description Example Type
siteId required siteId is provided by your NoBid account manager(s)   integer
placementId optional placementId is provided by your NoBid account manager(s). This parameter allows to report on a specific ad unit   integer
video optional Object containing video targeting parameters. Note that this parameter is not used in Prebid Server. See Video Object for details. video: { playback_method: ['auto_play_sound_off'] } object

Note

If you are using Google Ad Manager (GAM), it is highly recommended to make sure the “Serve in Safeframe” box in creative settings is unchecked. If you absolutely want to run NoBid in a Saferame creative, please contact your Nobid repsentative to coordinate this setup.

Test Parameters

    var adUnits = [
        {
            code: 'test-div1',
            mediaTypes: {
                banner: {
                    sizes: [[300, 250]],  // a display size
                }
            },
            bids: [
                {
                    bidder: "nobid",
                    params: {
                        siteId: 2,
                        placementId: 3
                    }
                }
            ]
        },{
            code: 'test-div2',
            mediaTypes: {
                banner: {
                    sizes: [[320, 50]],   // a mobile size
                }
            },
            bids: [
                {
                    bidder: "nobid",
                    params: {
                        siteId: 2
                    }
                }
            ]
        }
    ];

Video Object

Name Description Type
skippable Boolean which, if true, means the user can click a button to skip the video ad. Defaults to false. boolean
playback_method Array of strings listing playback methods supported by the publisher. Allowed values: "auto_play_sound_on"; "auto_play_sound_off"; "click_to_play"; "mouseover"; "auto_play_sound_unknown"; "viewport_sound_on", "viewport_sound_off". Array<string>
position Array of strings listing video player position supported by the publisher. Allowed values: "na", "atf", "btf", "head", "foot", "sidebar", "full". Array<string>
mimes Array of strings listing the content MIME types supported, e.g., ["video/x-flv", "video/x-ms-wmv"]. Array<string>
minduration Integer that defines the minimum video ad duration in seconds. integer
maxduration Integer that defines the maximum video ad duration in seconds. integer
frameworks Array of integers listing API frameworks supported by the publisher. Allowed values: None: 0; VPAID 1.0: 1; VPAID 2.0: 2; MRAID 1.0: 3; ORMMA: 4; MRAID 2.0: 5. Array<integer>

One Fifty Two Media Server

Features

Bidder Code oftmedia Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_oftmedia hb_bidder_oftmedia hb_adid_oftmedia
hb_size_oftmedia hb_source_oftmedia hb_format_oftmedia
hb_cache_host_oftmed hb_cache_id_oftmedia hb_uuid_oftmedia
hb_cache_path_oftmed hb_deal_oftmedia  

Bid Params

Name Scope Description Example Type
aid required The source ID from OftMedia. 350975 integer

OneTag

Features

Bidder Code onetag Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_onetag hb_bidder_onetag hb_adid_onetag
hb_size_onetag hb_source_onetag hb_format_onetag
hb_cache_host_onetag hb_cache_id_onetag hb_uuid_onetag
hb_cache_path_onetag hb_deal_onetag  

Bid Params

Name Scope Description Example Type
pubId required The publisher’s ID provided by OneTag '386276e072' string
ext optional A set of custom key-value pairs { customKey: customValue } object

Video Additional Information

Note that right now video support is only provided when the context is “instream” or “outstream”.

OpenWeb

Features

Bidder Code openweb Prebid.org Member yes
Media Types display GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_openweb hb_bidder_openweb hb_adid_openweb
hb_size_openweb hb_source_openweb hb_format_openweb
hb_cache_host_openwe hb_cache_id_openweb hb_uuid_openweb
hb_cache_path_openwe hb_deal_openweb  

Bid params

Name Scope Description Example Type
aid required The source ID from OpenWeb. 650342 integer

Description

OpenWeb.com official prebid adapter. Available in both client and server side versions. OpenWeb header bidding adapter provides solution for accessing banner demand.

Test Parameters

var adUnits = [
    // Banner adUnit
    {
        mediaTypes: {
          banner: {
            sizes: [[300, 250]]
          }
        },
        code: 'div-test-div',
        bids: [{
         bidder: 'openweb',
         params: {
           aid: 650342
         }
        }]
    },
    // Prebid server 
    {
        mediaTypes: {
          banner: {
            sizes: [[300, 250]]
          }
        },
        code: 'div-test-div',
        bids: [{
         bidder: 'openweb',
         params: {
           aid: 650346
         }
        }]
    }
];

OpenX

Features

Bidder Code openx Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs admixerId, adtelligentId, amxId, britepoolId, criteo, dapId, deepintentId, dmdId, fabrickId, flocId, hadronId, id5Id, identityLink, idxId, imuId, intentIqId, kinessoId, liveIntentId, lotamePanoramaId, merkleId, mwOpenLinkId, naveggId, netId, novatiq, parrableId, pubCommonId, publinkId, quantcastId, sharedId, tapadId, uid2, unifiedId, verizonMediaId, zeotapIdPlus USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_openx hb_bidder_openx hb_adid_openx
hb_size_openx hb_source_openx hb_format_openx
hb_cache_host_openx hb_cache_id_openx hb_uuid_openx
hb_cache_path_openx hb_deal_openx  

Registration

If you have any questions regarding set up, please reach out to your account manager or support@openx.com.

Please note that OpenX is transitioning its serving architecture and currently has 2 bid adapters as of Prebid 7. The legacy adapter is named openxBidAdapter. The newer of the two is openxOrtbBidAdapter. Publishers are welcome to test with openxOrtbBidAdapter and give feedback. After the transition openxOrtbBidAdapter will replace openxBidAdapter.

IMPORTANT: only include either openxBidAdapter or openxOrtbBidAdapter in your build.

Bid Parameters

Name Scope Description Example Type
delDomain or platform required OpenX delivery domain or platform id provided by your OpenX representative. Both may be present. platform is preferred “PUBLISHER-d.openx.net” or “555not5a-real-plat-form-id0123456789” String
unit required OpenX ad unit ID provided by your OpenX representative. “1611023122” String
customParams optional User-defined targeting key-value pairs. customParams applies to a specific unit. {key1: "v1", key2: ["v2","v3"]} Object
customFloor optional Minimum price in USD. customFloor applies to a specific unit. For example, use the following value to set a $1.50 floor: 1.50

WARNING:
Misuse of this parameter can impact revenue
1.50 Number
doNotTrack optional Prevents advertiser from using data for this user.

WARNING:
Impacts all bids in the request. May impact revenue.
true Boolean
coppa optional Enables Child’s Online Privacy Protection Act (COPPA) regulations. WARNING:
Impacts all bids in the request. May impact revenue.
true Boolean

AdUnit Format for Banner

var adUnits = [
  {
    code: 'test-div',
    sizes: [[728, 90]],  // a display size
    mediaTypes: {'banner': {}},
    bids: [
      {
        bidder: 'openx',
        params: {
          unit: '539439964',
          delDomain: 'se-demo-d.openx.net',
          customParams: {
            key1: 'v1',
            key2: ['v2', 'v3']
          },
        }
      }, {
        bidder: 'openx',
        params: {
          unit: '539439964',
          platform: 'a3aece0c-9e80-4316-8deb-faf804779bd1',
          customParams: {
            key1: 'v1',
            key2: ['v2', 'v3']
          },
        }
      }
    ]
  }
];

Video

Name Scope Description Example Type
unit required OpenX ad unit ID provided by your OpenX representative. “1611023122” String
delDomain or platform required OpenX delivery domain or platform id provided by your OpenX representative. Both may be present. platform is preferred “PUBLISHER-d.openx.net” or “555not5a-real-plat-form-id0123456789” String

mediaTypes.video

The following video parameters are supported here so publishers may fully declare their video inventory:

Name Scope Description Example Type
context required instream or outstream “outstream” string
playerSize required width, height of the player in pixels [640,360] - will be translated to w and h in bid request array
mimes required List of content MIME types supported by the player (see openRTB v2.5 for options) [“video/mp4”] array
protocols recommended Supported video bid response protocol values
1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
[2,3,5,6] array
api recommended Supported API framework values:
1: VPAID 1.0
2: VPAID 2.0
3: MRAID-1
4: ORMMA
5: MRAID-2
[2] array
linearity recommended OpenRTB2 linearity. 1: linear (in-stream ad), 2: non-linear (overlay ad) 1 integer
maxduration recommended Maximum video ad duration in seconds. 30 integer
minduration recommended Minimum video ad duration in seconds 6 integer
playbackmethod recommended Playback methods that may be in use. Only one method is typically used in practice. (see openRTB v2.5 section 5.10 for options) [2] array
minbitrate optional Minimum bit rate in Kbps. 300 integer
maxbitrate optional Maximum bit rate in Kbps. 9600 integer
battr optional Blocked creative attributes [13,14] array
startdelay recommended Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.
>0: Mid-Roll (value indicates start delay in second)
0: Pre-Roll
-1: Generic Mid-Roll
-2: Generic Post-Roll
0 integer
placement recommended Placement type for the impression. (see openRTB v2.5 section 5.9 for options) 1 integer
         

AdUnit Format for Video

var videoAdUnits = [
{
    code: 'test-div-video',
    mediaTypes: {
        video: {
            playerSize: [640, 480],           // required
            context: 'instream',
            mimes: ['video/mp4','video/x-flv'],   // required
            minduration: 5,                       // optional
            maxduration: 30,                      // optional
            startdelay: 5,                        // optional
            playbackmethod: [1,3],                // optional
            api: [ 1, 2 ],                        // optional
            protocols: [ 2, 3 ],                  // optional
            battr: [ 13, 14 ],                    // optional
            linearity: 1,                         // optional
            placement: 2,                         // optional
            minbitrate: 10,                       // optional
            maxbitrate: 10                        // optional
        }
    },
    bids: [{
      bidder: 'openx',
      params: {
        unit: '1611023124',
        delDomain: 'PUBLISHER-d.openx.net'
      }
    }]
}]

Example

var adUnits = [
  {
    code: 'test-div',
    sizes: [[728, 90]],  // a display size
    mediaTypes: {'banner': {}},
    bids: [
      {
        bidder: 'openx',
        params: {
          unit: '539439964',
          delDomain: 'se-demo-d.openx.net',
          customParams: {
            key1: 'v1',
            key2: ['v2', 'v3']
          },
        }
      }, {
        bidder: 'openx',
        params: {
          unit: '539439964',
          platform: 'a3aece0c-9e80-4316-8deb-faf804779bd1',
          customParams: {
            key1: 'v1',
            key2: ['v2', 'v3']
          },
        }
      }
    ]
  },
  {
    code: 'video1',
    mediaTypes: {
      video: {
        playerSize: [640, 480],
        context: 'instream',
        mimes: ['video/x-ms-wmv, video/mp4']
      }
    },
    bids: [{
      bidder: 'openx',
      params: {
        unit: '1611023124',
        delDomain: 'PUBLISHER-d.openx.net'
      }
    }]
  }
];

First Party Data

OpenX supports FPD configured under ortb2.userand ortb2.site.content as described here. Ad unit specific FPD is not supported, and segment taxonomies (segtax) are simply passed through. If you have any questions, please reach out to us at prebid@openx.com

Example:

pbjs.setConfig({
   ...
   ortb2: {
       site: {
            content: {
                data: [{
                    name: "www.dataprovider1.com",
                    ext: { segtax: 4 },
                    segment: [
                        { id: "687" },
                        { id: "123" }
                    ]
                }]
            },
       },
       user: {
           data: [{
               name: "dataprovider.com",
               ext: { segtax: 4 },
               segment: [
                    { id: "1" }
               ]
           }],
       }
   }
   ...
});

Configuration

Add the following code to enable user syncing. By default, Prebid.js version 0.34.0+ turns off user syncing through iframes. OpenX strongly recommends enabling user syncing through iframes. This functionality improves DSP user match rates and increases the OpenX bid rate and bid price. Be sure to call pbjs.setConfig() only once.

pbjs.setConfig({
   userSync: {
      iframeEnabled: true
   }
});

Additional Details

Banner Ads

Video Ads

OperaAds

Features

Bidder Code operaads Prebid.org Member no
Media Types display, video, native GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_operaads hb_bidder_operaads hb_adid_operaads
hb_size_operaads hb_source_operaads hb_format_operaads
hb_cache_host_operaa hb_cache_id_operaads hb_uuid_operaads
hb_cache_path_operaa hb_deal_operaads  

Registration

If you have any questions regarding set up, please reach out to your account manager or adtech-prebid-group@opera.com.

Bid Parameters

Name Scope Description Example Type
placementId required Placement Id s12345678 string
endpointId required Endpoint ID ep1234566 string
publisherId required Publisher ID pub123456 string

Opt Out Advertising

Features

Bidder Code optout Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_optout hb_bidder_optout hb_adid_optout
hb_size_optout hb_source_optout hb_format_optout
hb_cache_host_optout hb_cache_id_optout hb_uuid_optout
hb_cache_path_optout hb_deal_optout  

Bid Params

Name Scope Description Example Type
publisher required Opt Out publisher ID 8 string
adslot required Opt Out Adslot prebid_demo string

Orbidder

Features

Bidder Code orbidder Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_orbidder hb_bidder_orbidder hb_adid_orbidder
hb_size_orbidder hb_source_orbidder hb_format_orbidder
hb_cache_host_orbidd hb_cache_id_orbidder hb_uuid_orbidder
hb_cache_path_orbidd hb_deal_orbidder  

Bid Params

Name Scope Description Example Type
accountId required Orbidder Account ID “someAccount” string
placementId required Placement Id “somePlacement” string
bidfloor optional Placement floor price 1.23 float
keyValues optional Custom key/value object { “key”: “value” } object

Outbrain

Features

Bidder Code outbrain Prebid.org Member yes
Media Types display, native GDPR TCF Support yes
User IDs id5Id, identityLink USP/CCPA Support yes
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support will-bid-on-one ORTB Blocking Support 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_outbrain hb_bidder_outbrain hb_adid_outbrain
hb_size_outbrain hb_source_outbrain hb_format_outbrain
hb_cache_host_outbra hb_cache_id_outbrain hb_uuid_outbrain
hb_cache_path_outbra hb_deal_outbrain  

Registration

The Outbrain Adapter requires setup before beginning. Please contact us at prebid.org@outbrain.com.

Configuration

Prebid.js

The Outbrain adapter does not work without setting the correct bidder and usersync URLs. You will receive the URLs when contacting us.

pbjs.setConfig({
    outbrain: {
      bidderUrl: 'http://bidder-url.com',
      usersyncUrl: 'http://usersync-url.com'
    }
});

Prebid server

Similar to the Prebid.js configuration described above, our prebid server adapter requires you to configure the bidder and usersync URLs. You will receive the URLs when contacting us.

Please note that you need to replace the <PREBID_SERVER_EXTERNAL_URL> part with the actual external URL of the prebid server host.

adapters:
  outbrain:
    endpoint: http://bidder-url.com
    syncurl: http://usersync-url.com?gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb=<PREBID_SERVER_EXTERNAL_URL>%2Fsetuid%3Fbidder%3Doutbrain%26uid%3D__ZUID__

Bid Params

Name Scope Description Example Type
publisher.id required The publisher account ID '2706' string
publisher.name optional The publisher name 'Publisher Name' string
publisher.domain optional The publisher domain 'publisher.com' string
tagid optional Identifier for specific ad placement or ad tag 'tag-id' string
bcat optional Blocked advertiser categories using the IAB content categories ['IAB1-1'] string array
badv optional Block list of advertisers by their domains ['example.com'] string array

Native example

var adUnits = [
    code: '/19968336/prebid_native_example_1',
    mediaTypes: {
        native: {
            image: {
                required: false,
                sizes: [100, 50]
            },
            title: {
                required: false,
                len: 140
            },
            sponsoredBy: {
                required: false
            },
            clickUrl: {
                required: false
            },
            body: {
                required: false
            },
            icon: {
                required: false,
                sizes: [50, 50]
            }
        }
    },
    bids: [{
        bidder: 'outbrain',
        params: {
            publisher: {
              id: '2706',
              name: 'Publishers Name',
              domain: 'publisher.com'
            },
            tagid: 'tag-id',
            bcat: ['IAB1-1'],
            badv: ['example.com']
        }
    }]
];
var adUnits = [
    code: '/19968336/prebid_display_example_1',
    mediaTypes: {
      banner: {
        sizes: [[300, 250]]
      } 
    },
    bids: [{
        bidder: 'outbrain',
        params: {
            publisher: {
              id: '2706',
              name: 'Publishers Name',
              domain: 'publisher.com'
            },
            tagid: 'tag-id',
            bcat: ['IAB1-1'],
            badv: ['example.com']
        }
    }]
];

Outbrain - Old

Features

Bidder Code outbrain Prebid.org Member yes
Media Types display, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_outbrain hb_bidder_outbrain hb_adid_outbrain
hb_size_outbrain hb_source_outbrain hb_format_outbrain
hb_cache_host_outbra hb_cache_id_outbrain hb_uuid_outbrain
hb_cache_path_outbra hb_deal_outbrain  

Registration

The Outbrain Adapter requires setup before beginning. Please contact us at prebid.org@outbrain.com.

Configuration

Prebid.js

The Outbrain adapter does not work without setting the correct bidder and usersync URLs. You will receive the URLs when contacting us.

pbjs.setConfig({
    outbrain: {
      bidderUrl: 'http://bidder-url.com',
      usersyncUrl: 'http://usersync-url.com'
    }
});

Prebid server

Similar to the Prebid.js configuration described above, our prebid server adapter requires you to configure the bidder and usersync URLs. You will receive the URLs when contacting us.

Please note that you need to replace the <PREBID_SERVER_EXTERNAL_URL> part with the actual external URL of the prebid server host.

adapters:
  outbrain:
    endpoint: http://bidder-url.com
    syncurl: http://usersync-url.com?gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb=<PREBID_SERVER_EXTERNAL_URL>%2Fsetuid%3Fbidder%3Doutbrain%26uid%3D__ZUID__

Bid Params

Name Scope Description Example Type
publisher.id required The publisher account ID '2706' string
publisher.name optional The publisher name 'Publisher Name' string
publisher.domain optional The publisher domain 'publisher.com' string
tagid optional Identifier for specific ad placement or ad tag 'tag-id' string
bcat optional Blocked advertiser categories using the IAB content categories ['IAB1-1'] string array
badv optional Block list of advertisers by their domains ['example.com'] string array

Native example

var adUnits = [
    code: '/19968336/prebid_native_example_1',
    mediaTypes: {
        native: {
            image: {
                required: false,
                sizes: [100, 50]
            },
            title: {
                required: false,
                len: 140
            },
            sponsoredBy: {
                required: false
            },
            clickUrl: {
                required: false
            },
            body: {
                required: false
            },
            icon: {
                required: false,
                sizes: [50, 50]
            }
        }
    },
    bids: [{
        bidder: 'outbrain',
        params: {
            publisher: {
              id: '2706',
              name: 'Publishers Name',
              domain: 'publisher.com'
            },
            tagid: 'tag-id',
            bcat: ['IAB1-1'],
            badv: ['example.com']
        }
    }]
];
var adUnits = [
    code: '/19968336/prebid_display_example_1',
    mediaTypes: {
      banner: {
        sizes: [[300, 250]]
      } 
    },
    bids: [{
        bidder: 'outbrain',
        params: {
            publisher: {
              id: '2706',
              name: 'Publishers Name',
              domain: 'publisher.com'
            },
            tagid: 'tag-id',
            bcat: ['IAB1-1'],
            badv: ['example.com']
        }
    }]
];

Pangle

Features

Bidder Code pangle Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_pangle hb_bidder_pangle hb_adid_pangle
hb_size_pangle hb_source_pangle hb_format_pangle
hb_cache_host_pangle hb_cache_id_pangle hb_uuid_pangle
hb_cache_path_pangle hb_deal_pangle  

Note:

The Pangle Bidding adapter requires setup before beginning. Please contact us at pangle_dsp@bytedance.com.

Bid Params

Name Scope Description Example Type
token required access token ‘aaaa123’ string
appid optional app id (must be used in conjunction with placementid) ‘5123400’ string
placementid optional placement id (must be used in conjunction with appid) ‘912340000’ string

PGAM

Features

Bidder Code pgam Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_pgam hb_bidder_pgam hb_adid_pgam
hb_size_pgam hb_source_pgam hb_format_pgam
hb_cache_host_pgam hb_cache_id_pgam hb_uuid_pgam
hb_cache_path_pgam hb_deal_pgam  

Bid params

Name Scope Description Example Type
aid required The source ID from PGAM. 529814 integer

Description

PGAM header bidding adapter connects with PGAM demand sources in order to fetch bids. This adapter provides a solution for accessing Video demand and display demand.

Test Parameters

    var adUnits = [

      // Video instream adUnit
      {
        code: 'test-div',
        mediaTypes: {
          video: {
            context: 'instream',
            playerSize: [640, 480]
          }
        },
        bids: [{
          bidder: 'pgam',
          params: {
            aid: 472386
          }
        }]
      },

      // Video outstream adUnit
      {
        code: 'test-div',
        mediaTypes: {
          video: {
            context: 'outstream',
            playerSize: [640, 480]
          }
        },
        bids: [{
          bidder: 'pgam',
          params: {
            aid: 472386
          }
        }]
      },

       // Video ADPOD adUnit
      {
        code: 'test-div',
        sizes: [[640, 480]],
        mediaTypes: {
          video: {
            context: 'adpod',
            playerSize: [640, 480]            
          }
        },
        bids: [{
          bidder: 'pgam',
          params: {
            aid: 472386
          }
        }]
      },

      // Banner adUnit
      {
        code: 'test-div',
        mediaTypes:{
            banner:{
                sizes: [[300, 250]]
            }
        }
        bids: [{
          bidder: 'pgam',
          params: {
            aid: 529814
          }
        }]
      }
    ];

PubMatic

Features

Bidder Code pubmatic Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support will-bid-on-one ORTB Blocking Support yes

"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_pubmatic hb_bidder_pubmatic hb_adid_pubmatic
hb_size_pubmatic hb_source_pubmatic hb_format_pubmatic
hb_cache_host_pubmat hb_cache_id_pubmatic hb_uuid_pubmatic
hb_cache_path_pubmat hb_deal_pubmatic  

Bid Params

Name Scope Description Example Type
publisherId required Publisher ID '32572' string
adSlot optional Ad Slot Name (see below) '38519891' string
pmzoneid optional Zone ID 'zone1,zone2' string
lat optional Latitude '40.712775' string
lon optional Longitude '-74.005973' string
yob optional Year of Birth '1982' string
gender optional Gender 'M' string
kadpageurl optional Overrides Page URL 'http://www.yahoo.com/' string
kadfloor optional Bid Floor '1.75' string
currency optional Bid currency 'AUD' (Value configured only in the 1st adunit will be passed on.
Values if present in subsequent adunits, will be ignored.)
string
dctr optional Deal Custom Targeting
(Value configured only in the 1st adunit will be passed on.
Values if present in subsequent adunits, will be ignored.)
'key1=123|key2=345' string
acat optional Allowed categories
(List of allowed categories for a given auction to be sent in either using ortb2 config (request.ext.prebid.bidderparams.pubmatic.acat) or using slot level params. If categories sent using both then priority will be given to ortb2 over slot level params.)
[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ] array of strings
bcat optional Blocked IAB Categories
(Values from all slots will be combined and only unique values will be passed. An array of strings only. Each category should be a string of a length of more than 3 characters.)
[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ] array of strings
deals optional PMP deals
(Values from each slot will be passed per slot. An array of strings only. Each deal-id should be a string of a length of more than 3 characters.)
[ 'deal-id-5', 'deal-id-6', 'deal-id-7' ] array of strings
outstreamAU optional Oustream AdUnit described in Blue BillyWig UI. This field is mandatory if mimeType is described as video and context is outstream (i.e., for outstream videos) 'renderer_test_pubmatic' string

Configuration

PubMatic recommends the UserSync configuration below. Without it, the PubMatic adapter will not able to perform user syncs, which lowers match rate and reduces monetization.

pbjs.setConfig({
  userSync: {
    filterSettings: {
      iframe: {
        bidders: '*',      // '*' represents all bidders
        filter: 'include'
      }
    }
  }
});

Note: Combine the above the configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only last call for a given attribute will take effect.

adSlot Specification and Multi-Size Ad Units

The adSlot parameter supports two different formats:

Format Example
Without Size '38519891'
With Size '38519891@300x205'

adSlot parameter is optional. To omit the adSlot parameter, your publisher account must have default site and tag enabled. Consult your account manager to find out if default site and tag is enabled on your account. If used, both formats are supported. Without Size is the recommended option. Both options will send the ad request with all sizes specified in the Prebid ad unit configuration.

video parameters

The PubMatic adapter supports video as of Prebid v1.16.0

Name Scope Description Example
video.mimes required Video MIME types ['video/mp4','video/x-flv']
video.skippable optional If ‘true’, user can skip ad true
video.minduration optional Minimum ad duration in seconds 5
video.maxduration optional Maximum ad duration in seconds 30
video.startdelay optional Start delay in seconds for pre-roll, mid-roll, or post-roll ad placements 5
video.playbackmethod optional Defines whether inventory is user-initiated or autoplay sound on/off
Values:
1: Auto-play, sound on
2: Auto-play, sound off
3: Click-to-play
4: mouse-over
1
video.api optional API frameworks supported
Values:
1: VPAID 1.0
2: VPAID 2.0
3: MRAID-1
4: ORMMA
5: MRAID-2
[1, 2]
video.protocols optional Supported video bid response protocols
Values
1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
[5, 6]
video.battr optional Blocked creative attributes, See OpenRTB 2.5 specification, List 5.3 for values [3, 9]
video.linearity optional Indicates if the impression is linear or nonlinear
Values:
1: Linear/In-Stream
2: Non-Linear/Overlay.
1
video.placement optional Video placement type. See OpenRTB 2.5 specification, List 5.9 for Values 1
video.minbitrate optional Minumim bit rate in Kbps. 50
video.maxbitrate optional Maximum bit rate in Kbps. 70

AdUnit Format for Video

var videoAdUnits = [
{
    code: 'test-div-video',
    mediaTypes: {
        video: {
            playerSize: [640, 480],           // required
            context: 'instream',
            mimes: ['video/mp4','video/x-flv'],   // required
            skip: 1,                              // optional
            minduration: 5,                       // optional
            maxduration: 30,                      // optional
            startdelay: 5,                        // optional
            playbackmethod: [1,3],                // optional
            api: [ 1, 2 ],                        // optional
            protocols: [ 2, 3 ],                  // optional
            battr: [ 13, 14 ],                    // optional
            linearity: 1,                         // optional
            placement: 2,                         // optional
            minbitrate: 10,                       // optional
            maxbitrate: 10                        // optional
        }
    },
    bids: [{
      bidder: 'pubmatic',
      params: {
        publisherId: '32572',                     // required
        adSlot: '38519891@300x250'                // required
      }
    }]
}]

AdUnit Format for Native

var adUnits = [
{
    code: 'test-div',    
    mediaTypes: {
       native: {
            image: {
                required: true,
                sizes: [150, 50]
            },
            title: {
                required: true,
                len: 80
            },
            sponsoredBy: {
                required: true
            },
            body: {
                required: true
            }
        }
    },
    bids: [{
      bidder: 'pubmatic',
      params: {
        publisherId: '156295',               // required
        adSlot: 'pubmatic_test2@1x1',       // required
      }
    }]
}];

Configuration for video

For Video ads, prebid cache needs to be enabled for PubMatic adapter.

pbjs.setConfig({
    cache: {
        url: 'https://prebid.adnxs.com/pbc/v1/cache'
    }
});

Prebid Server Test Request

The following test parameters can be used to verify that Prebid Server is working properly with the PubMatic adapter. This example includes an imp object with an PubMatic test publisher ID, ad slot, and sizes that would match with the test creative.

"imp":[
      {
         "id":“"some-impression-id”,
         "banner":{
            "format":[
               {
                  "w":300,
                  "h":250
               },
               {
                  "w":300,
                  "h":600
               }
            ]
         },
         "ext":{
            "pubmatic":{
               "publisherId":“156276”,
               "adSlot":"pubmatic_test"
            }
         }
      }
   ]

First Party Data

Publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

  • ortb2.site.*
  • ortb2.user.*

AdUnit-specific data is supported using AdUnit.ortb2Imp.ext.*

PubNative

Features

Bidder Code pubnative Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_pubnative hb_bidder_pubnative hb_adid_pubnative
hb_size_pubnative hb_source_pubnative hb_format_pubnative
hb_cache_host_pubnat hb_cache_id_pubnativ hb_uuid_pubnative
hb_cache_path_pubnat hb_deal_pubnative  

Registration

Before adding PubNative as a new bidder, there are 3 prerequisites:

  • As a Publisher, you need to have Prebid Mobile SDK integrated.
  • You need a configured Prebid Server (either self-hosted or hosted by 3rd party).
  • You need to be integrated with Ad Server SDK (e.g. Mopub) or internal product which communicates with Prebid Mobile SDK.

Please see documentation for more info.

Bid Params

Name Scope Description Example Type
zone_id required The ad zone identifier 1 integer
app_auth_token required The app’s authentication token ‘aaaabbbbcccc’ string

Test Parameters

Please consult with our Account Manager for testing. We need to confirm that your ad request is correctly received by our system.

The following test parameters can be used to verify that Prebid Server is working properly with the Pubnative adapter.

The following json can be used to do a request to prebid server for verifying its integration with Pubnative adapter.

{
    "id": "some-impression-id",
    "site": {
      "page": "https://good.site/url"
    },
    "imp": [
      {
        "id": "test-imp-id",
        "banner": {
          "format": [
            {
              "w": 300,
              "h": 250
            }
          ]
        },
        "ext": {
          "pubnative": {
            "zone_id": 1,
            "app_auth_token": "b620e282f3c74787beedda34336a4821"
          }
        }
      }
    ],
    "device": {
      "os": "android",
      "h": 700,
      "w": 375
    },
    "tmax": 500,
    "test": 1
}

PulsePoint

Features

Bidder Code pulsepoint Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_pulsepoint hb_bidder_pulsepoint hb_adid_pulsepoint
hb_size_pulsepoint hb_source_pulsepoint hb_format_pulsepoint
hb_cache_host_pulsep hb_cache_id_pulsepoi hb_uuid_pulsepoint
hb_cache_path_pulsep hb_deal_pulsepoint  

Disclosure

This bidder sets adId on the bid response and hasn’t responded to the Prebid.js team to confirm uniqueness of this value. See Issue 6381.

Bid Params

Name Scope Description Example Type
cf required Ad size identifier '300X250' string
cp required Publisher Id 12345 integer
ct required Ad Tag Id 12345 integer
bcat optional Blocked IAB Categories [ 'IAB1-5', 'IAB1-6' ] array of strings
battr optional Blocked Creative Attributes [ 1, 2, 5 ] array of integers
badv optional Blocked Advertisers by their domains ['ford.com', 'pepsi.com'] array of strings
bidfloor optional Bid floor price CPM 1.23 float
video required Required for video requests. OpenRTB Video object. { w: 400, h: 300 } object

Video parameters

Parameters on the Video object in Bid params for PulsePoint. OpenRTB 2.5 Video object specification is used. Below are some sample parameters from the OpenRTB Video specs. Please use mediaTypes.video to specify video params in place of this parameter for PBJS 5.0 and later.

Name Scope Description Example
video.mimes required Content MIME types supported ['video/mp4','video/x-flv']
video.minduration optional Minimum video ad duration in seconds 8
video.maxduration optional Maximum video ad duration in seconds 20
video.protocols optional Array of supported video protocols [2, 3]
video.w optional Width of the video player in device independent pixels 400
video.h optional Height of the video player in device independent pixels 300
video.startdelay optional Start delay in seconds 5
video.skip optional Indicates if the player will allow the video to be skipped 1
video.minbitrate optional Minumim bit rate in Kbps. 200
video.maxbitrate optional Maximum bit rate in Kbps. 500
video.api optional List of supported API frameworks for this impression [1, 2]

Quantumdex

Features

Bidder Code quantumdex Prebid.org Member no
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 Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_quantumdex hb_bidder_quantumdex hb_adid_quantumdex
hb_size_quantumdex hb_source_quantumdex hb_format_quantumdex
hb_cache_host_quantu hb_cache_id_quantumd hb_uuid_quantumdex
hb_cache_path_quantu hb_deal_quantumdex  

Description

Quantumdex is an aliased bidder of Apacdex bid adapter. Please refer to Apacdex documentation for bid parameters and implementation guide.

RevContent

Features

Bidder Code revcontent Prebid.org Member no
Media Types display, native GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_revcontent hb_bidder_revcontent hb_adid_revcontent
hb_size_revcontent hb_source_revcontent hb_format_revcontent
hb_cache_host_revcon hb_cache_id_revconte hb_uuid_revcontent
hb_cache_path_revcon hb_deal_revcontent  

Note

To use RevContent bidder, you need to have an existing RevContent account. To create a new account visit https://www.RevContent.com. If you are an existing user, contact the account rep for api access and information.

For prebid server, Revcontent only uses basic OpenRTB requests, so only the endpoint will need to be customized. Your request must contain either app.name or site.domain to be considered valid. Revcontent will provide you with a custom endpoint that will contain your account details that you will specify in your adapater configuration, and you must manually enable the adapter. For example, your pbs.yaml would contain the following:

adapters:
  revcontent:
    disabled: false
    endpoint: https://trends.revcontent.com/rtb?apiKey=<api key here>&userId=<account user id here>

Prebid.js Bid Params

Name Scope Description Example Type
apiKey required API key. '8a33sdfsdfdsfsdfssss544f8sdfsdfsdfd3b1c' string
userId required Account User ID 69565 number
widgetId recommended Widget ID. 599995 number
domain recommended Domain Name - Default referral hostname 'test.com' string
endpoint optional Api Endpoint - Used for testing 'trends.revcontent.com' string
bidfloor optional Bid Floor 0.1 float
template optional Format of the display ad '<a href="{clickUrl}">{title}</a>' string

RhythmOne

Features

Bidder Code rhythmone Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_rhythmone hb_bidder_rhythmone hb_adid_rhythmone
hb_size_rhythmone hb_source_rhythmone hb_format_rhythmone
hb_cache_host_rhythm hb_cache_id_rhythmon hb_uuid_rhythmone
hb_cache_path_rhythm hb_deal_rhythmone  

Bid Params

Name Scope Description Example Type
placementId required The ID issued by RhythmOne to the publisher '34887' string
zone optional Optional string issued by RhythmOne to the publisher '1r' string
path optional Optional string issued by RhythmOne to the publisher 'mvo' string

Rich Audience

Features

Bidder Code richaudience Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs criteo, id5Id, identityLink, liveIntentId, pubCommonId, unifiedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_richaudience hb_bidder_richaudien hb_adid_richaudience
hb_size_richaudience hb_source_richaudien hb_format_richaudien
hb_cache_host_richau hb_cache_id_richaudi hb_uuid_richaudience
hb_cache_path_richau hb_deal_richaudience  

Bid Params

Name Scope Description Example Type
pid required The placement ID from Rich Audience. 'ADb1f40rmi' string
supplyType required Define if site or app. 'site / app' string
ifa optional Identifier For Advertisers 'AAAAAAAAA-BBBB-CCCC-1111-222222220000234234234234234' string
bidfloor optional Bid Floor 0.80 float
keywords optional A key-value applied only to the configured bid. This value is optional. Strings separated by semicolon. car=mercedes;car=audi; string
player optional Object containing video targeting parameters. See Video Object for details. player: {init: 'open', end: 'close', skin: 'dark'} object

Video Object

Name Scope Description Example Type
init optional Start mode of the player open or close 'open / close' string
end optional End mode of the player open or close 'open / close' string
skin optional Choose the background color 'dark / light' string

Roundel

Features

Bidder Code roundel Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs identityLink, netId, fabrickId, zeotapIdPlus USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_roundel hb_bidder_roundel hb_adid_roundel
hb_size_roundel hb_source_roundel hb_format_roundel
hb_cache_host_rounde hb_cache_id_roundel hb_uuid_roundel
hb_cache_path_rounde hb_deal_roundel  

Overview

Roundel is an aliased bidder for Index Exchange and must be configured alongside the IdentityLink user ID module.

Bid Params

Bidder params for roundel follow the same structure as the Index Exchange bidder. Please reference configuration examples here.

RtbAnalytica

Features

Bidder Code rtbanalytica Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_rtbanalytica hb_bidder_rtbanalyti hb_adid_rtbanalytica
hb_size_rtbanalytica hb_source_rtbanalyti hb_format_rtbanalyti
hb_cache_host_rtbana hb_cache_id_rtbanaly hb_uuid_rtbanalytica
hb_cache_path_rtbana hb_deal_rtbanalytica  

Note:

The RtbAnalytica bidding adapter requires setup and approval before implementation. Please reach out to vivek@rtbanalytica.com for more details.

Bid Params

Name Scope Description Example Type
host required RtbAnalytica RTB host 'cpm.rtbanalytica.com' string
zoneId required Zone Id 30164 integer

RTBHouse

Features

Bidder Code rtbhouse Prebid.org Member yes
Media Types display, native GDPR TCF Support yes
User IDs id5Id, identityLink, pubProvidedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_rtbhouse hb_bidder_rtbhouse hb_adid_rtbhouse
hb_size_rtbhouse hb_source_rtbhouse hb_format_rtbhouse
hb_cache_host_rtbhou hb_cache_id_rtbhouse hb_uuid_rtbhouse
hb_cache_path_rtbhou hb_deal_rtbhouse  

Bid Params

Name Scope Description Example Type
publisherId required Unique publisher ID 'ABCDEF' string
region required Assigned region 'prebid-eu' string
bidfloor optional Minimal CPM value 0.01 float
channel optional Inventory channel identifier, limited to 50 characters Partner 1 - News string

Please note:

  • Since 4.43 the bidfloor param will be ignored if a value is specified via floor module.

  • The channel param is available starting from Prebid 6.6.0. Please reach your RTBHouse representative for details on how to enable and use the channel param.

Rubicon Project

Features

Bidder Code rubicon Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support will-bid-on-one ORTB Blocking Support partial

"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_rubicon hb_bidder_rubicon hb_adid_rubicon
hb_size_rubicon hb_source_rubicon hb_format_rubicon
hb_cache_host_rubico hb_cache_id_rubicon hb_uuid_rubicon
hb_cache_path_rubico hb_deal_rubicon  

Disclosure:

This adapter is known to use an HTTP 1 endpoint. Header bidding often generates multiple requests to the same host and bidders are encouraged to change to HTTP 2 or above to help improve publisher page performance via multiplexing.

Registration

For both Prebid.js and Prebid Server, the Rubicon Project adapter requires setup and approval from the Magnite team, even for existing accounts. Please reach out to your account team or globalsupport@magnite.com for more information.

Bid Params

Name Scope Description Example Type
accountId required The publisher account ID 4934 integer
siteId required A unique ID for your site 13945 integer
zoneId required A unique ID for your site’s ad placements 23948 integer
position optional Set the page position. Valid values are “atf” and “btf”. 'atf' string
userId optional Site-specific user ID may be reflected back in creatives for analysis. Note that userId needs to be the same for all slots. '12345abc' string
floor optional Sets the global floor – no bids will be made under this value. 0.50 float
latLong optional Sets the latitude and longitude for the visitor (avail since PBJS 1.10) [40.7608, 111.8910] Array<float>
inventory optional See below for details on First Party Data. In release 4.29 and earlier, this parameter allows the definition of an object defining arbitrary key-value pairs concerning the page for use in targeting. The values must be arrays. {"rating":["5-star"], "prodtype":["tech","mobile"]} object
visitor optional See below for details on First Party Data. In release 4.29 and earlier, this parameter allows the definition of an object defining arbitrary key-value pairs concerning the visitor for use in targeting. The values must be arrays. {"ucat":["new"], "search":["iphone"]} object
keywords optional See below for details on First Party Data. In release 4.29 and earlier, this can be used to influence reports for client-side display. To get video or server-side reporting, please use First Party data or the inventory/visitor parameters. ['travel', 'tourism'] Array<string>
video required for video Video targeting parameters. See the video section below. {"language": "en"} object

First Party Data

In release 4.30 and later, publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

  • ortb2.site.ext.data.*
  • ortb2.site.keywords
  • ortb2.site.content.data[]
  • ortb2.user.ext.data.*
  • ortb2.user.data[]

With regards to Contextual and Audience segments, the Magnite exchange supports the IAB standard taxonomies. See the segment management user guide for more information.

Example first party data that’s available to all bidders and all adunits:

pbjs.setConfig({
  ortb2: {
    site: {
      keywords: "kw1,kw2",              // sent to Rubicon as 'keywords' available in reports for client-side display ads
      ext: {
        data: {
           prodtype: ["tech","mobile"]  // site.ext.data is sent to Rubicon as "inventory" data
        }
      }
    },
    user: {
      ext: {
        data: {
          ucat:["new"]                  // user.ext.data is sent to Rubicon as "visitor" data
        }
      }
    }
  }
};

Example of first party data available only to the Rubicon Project bidder. Applies across all ad units.

pbjs.setBidderConfig({
  bidders: ["rubicon"],
  config: {
    ortb2: {
      site: {
        keywords: "kw1,kw2",             // sent to Rubicon as 'keywords' available in reports for client-side display ads
        ext: {
          data: {
            prodtype: ["tech","mobile"]  // site.ext.data is sent to Rubicon as "inventory" data
          }
        }
      },
      user: {
        ext: {
          data: {
            ucat:["new"]                  // user.ext.data is sent to Rubicon as "visitor" data
          }
        }
      }
    }
  }
};

For Prebid.js 4.29 and before, use the bidder specific AdUnit parameters noted above:

var adUnit = {
    ...
    bids: [{
        bidder: 'rubicon',
        params: {
            accountId: 7780,                     // replace account/site/zone params
            siteId: 87184,
            zoneId: 413290,
            inventory: {
                prodtype: ["tech","mobile"]
            },
            visitor: {
                ucat:["new"]
            }
        }
    }]
};

ORTB Blocking

Rubicon supports passing up to 50 domains in badv for anything hitting Prebid Server, which includes these scenarios:

  1. client-side video
  2. s2sConfig
  3. App
  4. AMP

For example:

pbjs.setConfig({
  ortb2: {
    badv: ["domain1.com", "domain2.com"]
  }
)};

mediaTypes.video

The following video parameters are supported here so publishers may fully declare their video inventory:

Name Scope Description Example Type
context required instream or outstream “outstream” string
playerSize required width, height of the player in pixels [640,360] - will be translated to w and h in bid request array
mimes required List of content MIME types supported by the player (see openRTB v2.5 for options) [“video/mp4”] array
protocols required Supported video bid response protocol values
1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
[2,3,5,6] array
api required Supported API framework values:
1: VPAID 1.0
2: VPAID 2.0
3: MRAID-1
4: ORMMA
5: MRAID-2
[2] array
linearity required OpenRTB2 linearity. 1: linear (in-stream ad), 2: non-linear (overlay ad) 1 integer
maxduration recommended Maximum video ad duration in seconds. 30 integer
minduration recommended Minimum video ad duration in seconds 6 integer
playbackmethod recommended Playback methods that may be in use. Only one method is typically used in practice. (see openRTB v2.5 section 5.10 for options) [2] array
skip optional Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes. 1 integer
skipafter optional Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. 6 integer
minbitrate optional Minimum bit rate in Kbps. 300 integer
maxbitrate optional Maximum bit rate in Kbps. 9600 integer
startdelay* recommended Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.
>0: Mid-Roll (value indicates start delay in second)
0: Pre-Roll
-1: Generic Mid-Roll
-2: Generic Post-Roll
0 integer
placement* recommended Placement type for the impression. (see openRTB v2.5 section 5.9 for options) 1 integer
         

bids.params.video

The following Rubicon Project-specific video parameters are supported:

Name Scope Description Example Type
size_id optional for Prebid.js, required for Prebid Server Integer indicating the Rubicon Project video ad format ID. If not set, Prebid.js can infer from mediaTypes.video.context, placement, startDelay 201 integer
language recommended Indicates the language of the content video, in ISO 639-1/alpha2. Highly recommended for successful monetization for pre-, mid-, and post-roll video ads. Not applicable for interstitial and outstream. 'en' string

Here’s a video example for Prebid.js 2.5 or later:

var videoAdUnit = {
    code: 'myVideoAdUnit',
    mediaTypes: {
        video: {
            context: 'instream',
            playerSize: [640, 480],
            mimes: ['video/mp4', 'video/x-ms-wmv'] // you must review all video
            protocols: [2,3,5,6],                  // parameters to ensure validity
            api: [2],                              // for your player and DSPs
            maxduration:30,          
            linearity: 1
        }
    },
    bids: [{
        bidder: 'rubicon',                        
        params: {
            accountId: 7780,                       // replace params
            siteId: 87184,
            zoneId: 413290,
            video: {
                language: 'en'
            }
        }
    }]
};

This example adunit will also work in Prebid.js 2.4 and earlier, but mimes, protocols and api are not required.

We recommend discussing video demand with your Magnite account representative.

Lists of values are in the OpenRTB 2.5 documentation as referenced above.

Outstream Video

As of Prebid.js 4.37 Magnite’s Rubicon Project adapter supports outstream video in two ways: using your own renderer or using ours. See the Prebid.org Outstream documentation for more information on using your own renderer.

Outstream Renderer

The Magnite outstream renderer is a JavaScript tag that will load our outstream video player and render when it is 50% or more in view, pause when it’s more than 50% out of view, and close when the ad has completed playing.

The renderer appearance can be configured with the following parameters, all of them optional. If any parameter is missing, the default value will be used. All options are case-sensitive and unknown options will be ignored. Additional advanced options are available by calling your Magnite account representative.

pbjs.setConfig({
  rubicon: {
    rendererConfig: {
      align: 'center',         // player placement: left|center|right (default is center)
      position: 'append'       // position relative to ad unit: append|prepend|before|after (default is after)
      closeButton: true,       // display 'Close' button (default is false)
      label: 'Advertisement',  // custom text to display above the player (default is '-')
      collapse: true           // remove the player from the page after ad playback (default is true)
    }
  }
});
  • The Rubicon Project exchange does not make multi-format requests. If multiple mediatypes are defined, we bid on banner first, then video. Native bids will only be made if it’s the only mediatype present.
  • Note that only the Prebid-Server-side rubicon adapter currently supports native.

Setting up the Prebid Server Adapter

If you’re a Prebid Server host company looking to enable the Rubicon server-side adapter, you’ll need to contact globalsupport@magnite.com. They will provide:

  • a Magnite DV+ XAPI login and password that you’ll place in the PBS config
  • a partner code you can use for cookie-syncing with Magnite’s service

Configuration

Single-Request

By default, the Rubicon Project adapter sends one request to rubiconproject.com for each AdUnit. For example, if there are 4 PBJS AdUnits defined on the page, you’ll see 4 calls out to rubiconproject.com/fastlane.json.

As of PBJS 1.12, the Rubicon Project adapter supports Single Request mode, where all AdUnit requests are made in a single call to rubiconproject.com. To turn this feature on, call setConfig:

pbjs.setConfig({
   rubicon: {singleRequest: true}
});

Notes

1) There can only be one siteId and zoneId in an AdUnit bid. To get bids on multiple sitesIds or zoneIds, just add more ‘rubicon’ entries in the bids array.

2) Bids through the Rubicon Project Exchange are by default ‘net’. For certain use cases it is possible for publishers to define a bid as either ‘net’ or ‘gross’. In either case the Rubicon platform does not signal externally to other systems either bid state.

For Prebid, the Rubicon Project bid adapter reports the revenue type as ‘gross’ by default before 2.35 and ‘net’ by default in 2.35 and later (as the vast majority of accounts are net and all new accounts are net).

It’s important to note that what the Rubicon Prebid bid adapter reports is not directly related to the setting with the Rubicon Project exchange. If you are a publisher who has set your Rubicon exchange revenue type set to ‘gross’ and you’d like the Rubicon bid adapter to also report ‘gross’, you can change the 2.35+ default ‘net’ setting in Prebid.js with:

pbjs.setConfig({ rubicon: {netRevenue: false} });

SA Lunamedia

Features

Bidder Code sa_lunamedia Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_sa_lunamedia hb_bidder_sa_lunamed hb_adid_sa_lunamedia
hb_size_sa_lunamedia hb_source_sa_lunamed hb_format_sa_lunamed
hb_cache_host_sa_lun hb_cache_id_sa_lunam hb_uuid_sa_lunamedia
hb_cache_path_sa_lun hb_deal_sa_lunamedia  

Prebid Server Bid Params

Name Scope Description Example Type
key required Placement integration key '1234' string
type optional Supported values are publisher and network. 'publisher' string

Seeding Alliance

Features

Bidder Code seedingAlliance Prebid.org Member no
Media Types display, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support no
Multi Format Support check with bidder ORTB Blocking Support 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_seedingAllianc hb_bidder_seedingAll hb_adid_seedingAllia
hb_size_seedingAllia hb_source_seedingAll hb_format_seedingAll
hb_cache_host_seedin hb_cache_id_seedingA hb_uuid_seedingAllia
hb_cache_path_seedin hb_deal_seedingAllia  

Bid params

Name Scope Description Example Type
adUnitId required ID of the Ad Unit 8ao string
url optional URL from the Page example.tld string

Sharethrough

Features

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

"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_sharethrough hb_bidder_sharethrou hb_adid_sharethrough
hb_size_sharethrough hb_source_sharethrou hb_format_sharethrou
hb_cache_host_sharet hb_cache_id_sharethr hb_uuid_sharethrough
hb_cache_path_sharet hb_deal_sharethrough  

Disclosure:

This adapter is known to use an HTTP 1 endpoint. Header bidding often generates multiple requests to the same host and bidders are encouraged to change to HTTP 2 or above to help improve publisher page performance via multiplexing.

Note:

The Sharethrough bidder adapter requires additional setup and approval from the Sharethrough Integrations team. Please reach out to your account manager for more information to start using it.

Bid Params

| Name | Scope | Description | Example | Type | |————-|———-|————————————————————|——————————|———————-| | pkey | required | The placement key | 'DfFKxpkRGPMS7A9f71CquBgZ' | string | | bcat | optional | (deprecated) Array of blocked IAB Categories | ['IAB1-2', 'IAB1-3'] | string[] | | badv | optional | (deprecated) Array of blocked Advertisers by their domains | ['ford.com', 'pepsi.com'] | string[] |

Note: Providing bcat and badv via Bid Params is deprecated, the First Party Data method should be preferred (see below). When both methods are provided, first party data values will be used and bid param values will be ignored.

First Party Data

Publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

  • ortb2.site.*
  • ortb2.user.*

For example:

pbjs.setConfig({
  ortb2: {
    site: {
      name: "example",
      cat: ["IAB2"],
      keywords: "power tools, drills",
      content: {
        userrating: "4"
      }
    },
    user: {
      yob: 1985,
      gender: "m",
      keywords: "a,b",
      ext: {
        data: {
          registered: true,
          interests: ["cars"]
        }
      }
    }
  }
});

ORTB Blocking

Sharethrough supports blocking advertiser domains (badv) and/or IAB Categories (bcat) via First Party Data.

For example:

pbjs.setConfig({
  ortb2: {
    bcat: ["IAB1", "IAB2-1"],
    badv: ["domain1.com", "domain2.com"],
  }
});

SilverMob

Features

Bidder Code silvermob Prebid.org Member no
Media Types display, video, native GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_silvermob hb_bidder_silvermob hb_adid_silvermob
hb_size_silvermob hb_source_silvermob hb_format_silvermob
hb_cache_host_silver hb_cache_id_silvermo hb_uuid_silvermob
hb_cache_path_silver hb_deal_silvermob  

Note:

The SilverMob Bidding adapter requires setup before beginning. Please contact us at partners@silvermob.com

Bid Params

Name Scope Description Example Type
zoneid required Placement id '3011' string
host required Data center location 'us' string

Smaato

Features

Bidder Code smaato Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_smaato hb_bidder_smaato hb_adid_smaato
hb_size_smaato hb_source_smaato hb_format_smaato
hb_cache_host_smaato hb_cache_id_smaato hb_uuid_smaato
hb_cache_path_smaato hb_deal_smaato  

Table of Contents

Registration

The Smaato adapter requires setup and approval from the Smaato team, even for existing Smaato publishers. Please reach out to your account team or prebid@smaato.com for more information.

Note

The Smaato adapter will convert bidfloors to ‘USD’ currency as needed.

Bid Params

Name Scope Description Example Type
publisherId required Your Smaato publisher id '1100012345' string
adspaceId required Your Smaato adspace id. Required for non adpod requests '11002234' string
adbreakId required Your Smaato adbreak id. Required for adpod (long-form video) requests '41002234' string
app optional Object containing mobile app parameters. See the App Object for details. app : { ifa: '56700000-9cf0-22bd-b23e-46b96e40003a'} object

App Object

Smaato supports using prebid within a mobile app’s webview.

Name Description Example Type
ifa String that contains the advertising identifier of the user (e.g. idfa or aaid). '56700000-9cf0-22bd-b23e-46b96e40003a' string
geo Object that contains the latitude (lat) and longitude (lon) of the user. { lat: 33.3, lon: -88.8 } object

Example Ad Units

Example Banner Ad Unit

var adUnit = {
    "code": "banner unit",
    "mediaTypes": {
        "banner": {
            "sizes": [320, 50]
        }
    },
    "bids": [{
        "bidder": "smaato",
        "params": {
            "publisherId": "1100012345",
            "adspaceId": "11002234"
        }
    }]
}

Example Video Ad Unit

var adUnit = {
    "code": "video unit",
    "mediaTypes": {
        "video": {
            "context": "instream",
            "playerSize": [640, 480],
            "mimes": ["video/mp4"],
            "minduration": 5,
            "maxduration": 30,
            "startdelay": 0,
            "linearity": 1,
            "protocols": [7],
            "skip": 1,
            "skipmin": 5,
            "api": [7],
            "ext": {"rewarded": 0}
        }
    },
    "bids": [{
        "bidder": "smaato",
        "params": {
            "publisherId": "1100012345",
            "adspaceId": "11002234"
        }
    }]
};

Example AdPod (long-form) Video Ad Unit

var adUnit = {
    "code": "adpod unit",
    "mediaTypes": {
        "video": {
            "context": "adpod",
            "playerSize": [640, 480],
            "adPodDurationSec": 300,
            "durationRangeSec": [15, 30],
            "requireExactDuration": false,
            "mimes": ["video/mp4"],
            "startdelay": 0,
            "linearity": 1,
            "protocols": [7],
            "skip": 1,
            "skipmin": 5,
            "api": [7],
        }
    },
    "bids": [{
        "bidder": "smaato",
        "params": {
            "publisherId": "1100042525",
            "adbreakId": "400000000"
        }
    }]
};

First Party Data

Publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

  • ortb2.site.keywords
  • ortb2.site.content
  • ortb2.user.keywords
  • ortb2.user.yob
  • ortb2.user.gender
  • ortb2.user.ext.eids

The IAB standard taxonomies are not supported.

Example first party data that’s available to all bidders and all adunits:

pbjs.setConfig({
    ortb2: {
        site: {
            keywords: "kw1,kw2", 
            content: {
                title: "title1",
                series: "series1"
                }
            }, 
        user: {
            keywords: "a,b", 
            gender: "M", 
            yob: 1984
        }
    }
});

Test Parameters

Following example includes sample imp object with publisherId and adSlot which can be used to test Smaato Adapter

"imp":[
      {
         "id":"1C86242D-9535-47D6-9576-7B1FE87F282C",
         "banner":{
            "format":[
               {
                  "w":300,
                  "h":50
               },
               {
                  "w":300,
                  "h":250
               }
            ]
         },
         "ext":{
            "smaato":{
               "publisherId":"100042525",
               "adspaceId":"130563103"
            }
         }
      }
   ]

Smart AdServer

Features

Bidder Code smartadserver Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_smartadserver hb_bidder_smartadser hb_adid_smartadserve
hb_size_smartadserve hb_source_smartadser hb_format_smartadser
hb_cache_host_smarta hb_cache_id_smartads hb_uuid_smartadserve
hb_cache_path_smarta hb_deal_smartadserve  

Registration

The Smart AdServer bidder adaptor requires setup and approval from the Smart AdServer Service team. Please reach out to your account manager for more information and start using it.

Bid params

Name Scope Description Example Type
networkId required for Prebid Server The network identifier you have been provided with. 1234 integer
siteId required for Prebid.js The placement site ID 1234 integer
pageId required The placement page ID 1234 integer
formatId required The placement format ID 1234 integer
domain optional The network domain (default see example) 'http://prg.smartadserver.com', 'https://prg.smartadserver.com' string
target optional The keyword targeting 'sport=tennis' string
bidfloor optional Bid floor for this placement in USD or in the currency specified by the currency parameter. (Default: 0.0) 0.42 float
appName optional Mobile application name 'Smart AdServer Preview' string
buId optional Mobile application bundle ID 'com.smartadserver.android.dashboard' string
ckId optional Unique Smart AdServer user ID 1234567890123456789 integer
video optional Parameter object for instream video. See video Object {} object
schain optional Supply Chain '1.0,1!exchange1.com,1234,1,bid-request-1,publisher,publisher.com' string

Note: The site, page and format identifiers have to all be provided or all empty.

Video Object

Name Scope Description Example Type
protocol optional Maximum open RTB video protocol supported 8 (VAST 4.0 wrapper) integer
startDelay optional Allowed values: 1 (generic pre-roll, default), 2 (generic mid-roll), 3 (generic post-roll) 1 integer

Supported Media Types (Prebid.js)

Type Support
banner Supported
video Supported
native Not currently supported

Supported Media Types (Prebid Server)

Type Support
banner Supported
video Supported
native Supported

Examples

Without site/page/format :

	"imp": [{
		"id": "some-impression-id",
		"banner": {
			"format": [{
				"w": 600,
				"h": 500
			}, {
				"w": 300,
				"h": 600
			}]
		},
		"ext": {
			"smartadserver": {
				"networkId": 73
			}
		}
	}]

With site/page/format :

	"imp": [{
		"id": "some-impression-id",
		"banner": {
			"format": [{
				"w": 600,
				"h": 500
			}, {
				"w": 300,
				"h": 600
			}]
		},
		"ext": {
			"smartadserver": {
                            "networkId": 73
                            "siteId": 1,
                            "pageId": 2,
                            "formatId": 3
			}
		}
	}]

SmartHub

Features

Bidder Code smarthub Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_smarthub hb_bidder_smarthub hb_adid_smarthub
hb_size_smarthub hb_source_smarthub hb_format_smarthub
hb_cache_host_smarth hb_cache_id_smarthub hb_uuid_smarthub
hb_cache_path_smarth hb_deal_smarthub  

Prebid.js Bid Params

Name Scope Description Example Type
partnerName required Unique partner name 'partnertest' string
seat required Seat value '9Q20EdGxzgWdfPYShScl' string
token required Token 'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW' string
iabCat optional Array of IAB content categories that describe the content producer ['IAB1-1', 'IAB3-1', 'IAB4-3'] Array(String)
minBidfloor optional Minimal CPM value 0.03 float
pos optional The position of the placement on the page, see Open RTB spec v2.5. 4 number

Prebid Server Bid Params

Name Scope Description Example Type
partnerName required Unique partner name 'partnertest' string
seat required Seat value '9Q20EdGxzgWdfPYShScl' string
token required Token 'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW' string

SmartRTB

Features

Bidder Code smartrtb Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_smartrtb hb_bidder_smartrtb hb_adid_smartrtb
hb_size_smartrtb hb_source_smartrtb hb_format_smartrtb
hb_cache_host_smartr hb_cache_id_smartrtb hb_uuid_smartrtb
hb_cache_path_smartr hb_deal_smartrtb  

Registration

Please contact us to create a new Smart RTB Marketplace account, and for any assistance in configuration. You may email info@smrtb.com for inquiries.

Prebid.js Bid Params

Name Scope Description Example Type
zoneId required   z_261b6c7e7d4d4985393b293cc903d1 string
forceBid optional Returns test bid true boolean

Prebid Server Bid Params

Name Scope Description Example Type
pub_id required Publisher ID assigned to you. 'siteA' string
zone_id optional Enables mapping for further settings and reporting in the Marketplace UI. 'z_261b6c7e7d4d4985393b293cc903d1' string
force_bid optional If zone ID is mapped, this may be set to always return fake sample bids (banner, video) true boolean

Test Prebid Server Request

This sample request is our global test placement and should always return a branded banner bid.

        {
        "id": "abc",
        "site": {
            "page": "prebid.org"
        },
        "imp": [{
                "id": "test",
                "banner": {
                        "format": [{
                                "w": 300,
                                "h": 250
                        }]
                },
                "ext": {
                        "smartrtb": {
			    "pub_id": "test",
			    "zone_id": "N4zTDq3PPEHBIODv7cXK",
			    "force_bid": true
                        }
                }
        }]
    }

SmartyAds

Features

Bidder Code smartyads Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support no
Multi Format Support will-bid-on-one ORTB Blocking Support 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_smartyads hb_bidder_smartyads hb_adid_smartyads
hb_size_smartyads hb_source_smartyads hb_format_smartyads
hb_cache_host_smarty hb_cache_id_smartyad hb_uuid_smartyads
hb_cache_path_smarty hb_deal_smartyads  

Note:

The Example Bidding adapter requires setup before beginning. Please contact us at sales@smartyads.com

Bid Params

Name Scope Description Example Type
placementId required (for prebid.js) placement Id '0' string
host required (for prebid-server) Region id 'ns1' string
sourceid required (for prebid-server) Partner id 'smartyads' string
accountid required (for prebid-server) Endpoint id 'hash' string
traffic optional (for prebid.js) Configures the mediaType that should be used. Values can be banner, native or video native string

Smile Wanted

Features

Bidder Code smilewanted Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_smilewanted hb_bidder_smilewante hb_adid_smilewanted
hb_size_smilewanted hb_source_smilewante hb_format_smilewante
hb_cache_host_smilew hb_cache_id_smilewan hb_uuid_smilewanted
hb_cache_path_smilew hb_deal_smilewanted  

Note

To use us as a bidder you must have an account and an active “zoneId” on our Smile Wanted platform.

Bid params

Name Scope Description Example Type
zoneId required The placement zone ID 'test.com_header_bidding_display_atf' string

Testing

You can add #sw_test_campaign to the end of any URL. This will have the effect of responding with a Smile Wanted creative with a high CPM, which means you’ll win every auction so you can see if the ad displays correctly. (Please note that impressions and revenues of this test ad will not be recorded and not be paid.)

User Sync

Add the following code to enable user sync. Smile Wanted strongly recommends enabling user syncing through iFrames. This functionality improves partners’ user match rates and increases the Smile Wanted bid rate and bid price. Be sure to call pbjs.setConfig() only once.

pbjs.setConfig({
    userSync: {
        iframeEnabled: true,
        filterSettings: {
            iframe: {
                bidders: '*',   // '*' means all bidders
                filter: 'include'
            }
        }
    }
});

Sonic Twist Media

Features

Bidder Code sonic_twist Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_sonic_twist hb_bidder_sonic_twis hb_adid_sonic_twist
hb_size_sonic_twist hb_source_sonic_twis hb_format_sonic_twis
hb_cache_host_sonic_ hb_cache_id_sonic_tw hb_uuid_sonic_twist
hb_cache_path_sonic_ hb_deal_sonic_twist  

Note:

The Sonic Twist Media Bidding adaptor requires setup and approval before beginning. Please reach out to publishers@sonictwist.media for more details

Bid Params

Name Scope Description Example Type
host required Our Host 'cpm.andbeyond.media' string
zoneId required Example RTB zone id '12345' string

Sonobi

Features

Bidder Code sonobi Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId, lotamePanoramaID USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_sonobi hb_bidder_sonobi hb_adid_sonobi
hb_size_sonobi hb_source_sonobi hb_format_sonobi
hb_cache_host_sonobi hb_cache_id_sonobi hb_uuid_sonobi
hb_cache_path_sonobi hb_deal_sonobi  

Note:

The Sonobi Bidder adapter requires setup and approval from your Sonobi Account Manager. If you require assistance implementing our adapter please don’t hesitate to contact us at apex.prebid@sonobi.com.

Bid Params

Name Scope Description Example Type
placement_id required* The placement ID '1a2b3c4d5e6f1a2b3c4d' string
ad_unit required* The adunit ID '/1234567/example/adUnit/code' string
floor optional Bid floor for this placement in USD 0.50 float
sizes optional Adunit sizes that will override global sizes [[300, 250], [300, 600]] Array<Array>
hfa optional Publisher Unique Identifier '123985' string
referrer optional Overrides the default value for the ref param in a bid request 'prebid.org' string
keywords optional Comma separated list of keywords about the site 'sports,news,food' string
bid_request_url optional String representing the url the Sonobi adapter should make to request bids 'https://iad-2-apex.go.sonobi.com/trinity.json' string

Configuration

You *must only include one ID field - either placement_id or ad_unit, not both. If you have questions on which parameter to use, please reach out to your Account Manager.

The ad_unit and placement_id are mutually exclusive but at least one is required. If you pass both, ad_unit takes precedence.

If you pass the optional sizes Array in your bid params it will override the global config sizes for the Sonobi Adapter only.

The hfa parameter requires your Sonobi Account Manager to enable this feature for you. Please contact them for further information.

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 Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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'
        }
      }]
    }

sspBC

Features

Bidder Code sspBC Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_sspBC hb_bidder_sspBC hb_adid_sspBC
hb_size_sspBC hb_source_sspBC hb_format_sspBC
hb_cache_host_sspBC hb_cache_id_sspBC hb_uuid_sspBC
hb_cache_path_sspBC hb_deal_sspBC  

Bid Params

Name Scope Description Example Type
id optional placement id '006' string
siteId optional site id '235911' string
publisherId optional publisher id '728' string
domain optional site domain 'somesite.com' string
page optional page url 'somesite.com/index.html' string
tmax optional tmax for server connection 400 integer

Streamkey

Features

Bidder Code streamkey Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_streamkey hb_bidder_streamkey hb_adid_streamkey
hb_size_streamkey hb_source_streamkey hb_format_streamkey
hb_cache_host_stream hb_cache_id_streamke hb_uuid_streamkey
hb_cache_path_stream hb_deal_streamkey  

Bid params

Name Scope Description Example Type
aid required The traffic source ID 232131 integer

Test Parameters

    var adUnits = [

      // Video instream adUnit
      {
        code: 'div-test-div',
        sizes: [[640, 480]],
        mediaTypes: {
          video: {
            context: 'instream'
          }
        },
        bids: [{
          bidder: 'streamkey',
          params: {
            aid: 331133
          }
        }]
      },

      // Video outstream adUnit
      {
        code: 'outstream-test-div',
        sizes: [[640, 480]],
        mediaTypes: {
          video: {
            context: 'outstream'
          }
        },
        bids: [{
          bidder: 'streamkey',
          params: {
            aid: 331133
          }
        }]
      },
    ];

StroeerCore

Features

Bidder Code stroeerCore Prebid.org Member no
Media Types display GDPR TCF Support yes
User IDs criteo, id5Id, netId, pubCommonId, sharedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support no First Party Data Support no
Multi Format Support will-bid-on-one ORTB Blocking Support 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_stroeerCore hb_bidder_stroeerCor hb_adid_stroeerCore
hb_size_stroeerCore hb_source_stroeerCor hb_format_stroeerCor
hb_cache_host_stroee hb_cache_id_stroeerC hb_uuid_stroeerCore
hb_cache_path_stroee hb_deal_stroeerCore  

Bid Params

Name Scope Description Example Type
sid required Slot ID '06b782cc-091b-4f53-9cd2-0291679aa1ac' string

Config Notes

  • Slot id (sid) is required. The adapter will ignore bid requests from prebid if sid is not provided. This must be in the decoded form. For example, “1234” as opposed to “MTM0ODA=”.
  • The server ignores dimensions that are not supported by the slot or by the platform (such as 987x123).

Ad unit configuration for publishers

const adUnits = [{ 
    code: 'div-gpt-ad-1460505748561-0',
    mediaTypes: {
        banner: {
            sizes: [[300, 250]],
        }
    },
    bids: [{
        bidder: 'stroeerCore',
        params: {
          sid: "06b782cc-091b-4f53-9cd2-0291679aa1ac"
        }    
    }]
}];

Synacor Media

Features

Bidder Code synacormedia Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs identityLink, verizonMediaId, pubCommonId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_synacormedia hb_bidder_synacormed hb_adid_synacormedia
hb_size_synacormedia hb_source_synacormed hb_format_synacormed
hb_cache_host_synaco hb_cache_id_synacorm hb_uuid_synacormedia
hb_cache_path_synaco hb_deal_synacormedia  

Note:

The Synacor Media bidder adapter requires setup and approval from Synacor. Please reach out to your account manager for more information and to start using it.

Configuration

Synacor Media requires that iframe is used for user syncing.

Example configuration:

pbjs.setConfig({
  userSync: {
    filterSettings: {
      iframe: {
        bidders: '*', // represents all bidders
        filter: 'include'
      }
    }
  }
});

DFP Video Creative

To use video, setup a VAST redirect creative within Google AdManager (DFP) with the following VAST tag URL:

https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_cache_id_synacorm%%&AUCTION_PRICE=%%PATTERN:hb_pb_synacormedia%%

Bid params

Name Scope Description Example Type
seatId required The seat ID from Synacor Media. This will be the same for all ad units. 'prebid' string
tagId required The placement or tag ID from Synacor Media. 'demo1' string
bidfloor optional The floor price for the request. 0.1 float
pos optional The position of the placement on the page, see Open RTB spec v2.5. 0 int
video optional Optional properties specific to video, see next table { } Object

Example Ad Unit

var adUnits = [{
    "code": "test-div",
    "mediaTypes": {
        "video": {
            "playerSize": [300, 250],
            "context": "instream",
            "minduration": 15,
            "maxduration": 30,
            "startdelay": 1,
            "linearity": 1
        }
    },
    "bids": [{
        "bidder": "synacormedia",
        "params": {
            "seatId": "prebid",
            "tagId": "demo1",
            "bidfloor": 0.20,
            "pos": 1
        }
    }]
}]

Video Parameters (see openrtb 2.5 spec)

Name Scope Description Default Type
minduration optional Minimum ad duration in seconds 2 int
maxduration optional Maximum ad duration in seconds 60 int
startdelay optional Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements. 0 int
placement optional Placement type for the impression. null int
linearity optional Indicates if the impression must be linear, nonlinear, etc. 1 int
mimes optional Content MIME types supported. ["video/mp4", "application/javascript"] Array(String)
protocols optional Array of supported video protocols. [1,2,3,4,5,6,7] Array(int)
api optional List of supported API frameworks for this impression. [1,2] Array(int)
playbackmethod optional Single element array with supported playback methods for this video impression. If multiple values are supplied, first element will be used. [1] Array(int)

tappx

Features

Bidder Code tappx Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_tappx hb_bidder_tappx hb_adid_tappx
hb_size_tappx hb_source_tappx hb_format_tappx
hb_cache_host_tappx hb_cache_id_tappx hb_uuid_tappx
hb_cache_path_tappx hb_deal_tappx  

Registration

Please contact tappx@tappx.com to get set up.

Bid Params

Name Scope Description Example Type
tappxkey required An ID which identifies the adunit ‘key1’ string
endpoint required Endpoint provided to publisher ‘endpoint1’ string
host required(pbjs) optional(pbserver) Tappx host ‘host1’ string
bidfloor optional Minimum bid for this impression expressed in CPM (USD) 1.2 number
mktag optional An ID which identifies a group of adunits ‘key1’ string
bcid optional Block list of CID [“1234”] array of strings
bcrid optional Block list of CRID [“1234”] array of strings

Test Parameters

Use the official test parameter specified in the oRTB standard (https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/OpenRTB%20v3.0%20FINAL.md#object_request)

Other notes

  • Parameters host is required in prebidjs and the old versions of prebid server. In case of doubt, always add the parameter.

TrafficGate

Features

Bidder Code trafficgate Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support no First Party Data Support no
Multi Format Support will-bid-on-any ORTB Blocking Support 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_trafficgate hb_bidder_trafficgat hb_adid_trafficgate
hb_size_trafficgate hb_source_trafficgat hb_format_trafficgat
hb_cache_host_traffi hb_cache_id_trafficg hb_uuid_trafficgate
hb_cache_path_traffi hb_deal_trafficgate  

Note:

The TrafficGate Bidding adapter requires setup before beginning. Please contact us at support@bidscube.com

Bid Params

Name Scope Description Example Type
placementId required Placement ID '12345' string
host required Host 'example' string

TripleLift

Features

Bidder Code triplelift Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs criteo, identityLink, unifiedId, pubCommonId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_triplelift hb_bidder_triplelift hb_adid_triplelift
hb_size_triplelift hb_source_triplelift hb_format_triplelift
hb_cache_host_triple hb_cache_id_tripleli hb_uuid_triplelift
hb_cache_path_triple hb_deal_triplelift  

Table of Contents

Overview

Publishers may integrate with Triplelift through our Prebid.js and/or Prebid Server adapters. See below for more information.

{% capture version2 %} The Triplelift Prebid Server bidding adapter and user sync endpoint require setup before beginning. Please contact us at prebid@triplelift.com. {% endcapture %} {% include alerts/alert_important.html content=version2 %}

Bid Params

Name Scope Description Example Type
inventoryCode required TripleLift inventory code for this ad unit (provided to you by your partner manager) 'pubname_top_banner' string
floor optional Bid floor 1.00 float

Video

Name Scope Description Example Type
inventoryCode required TripleLift inventory code for this ad unit (provided to you by your partner manager) 'pubname_instream_1' string
video required oRTB video object { mimes: ['video/mp4'], w: 640, h: 480 } object
video.context required Instream or Outstream (v7.9+ for all Outstream) instream string
video.w required oRTB video object width dimension 640 int
video.h required oRTB video object height dimension 480 int
video.placement optional Instream: 1; Outstream: 3, 4, 5. 3 int

Example Configuration

var adUnits = [
    {
        code: 'top-banner',
        mediaTypes: {
            banner: {
                sizes: [
                    [728, 90],
                    [970, 250]
                ]
            }
    },
    bids: [{
        bidder: 'triplelift',
        params: {
            inventoryCode: 'pubname_top_banner'
        }
    }]
}];

Video (Instream)

var videoAdUnit = {
    code: 'video1',
    mediaTypes: {
        video: {
            playerSize: [640, 480],
            context: 'instream',
            placement: 1,
            mimes: ['video/mp4']
        }
    },
    bids: [{
        bidder: 'triplelift',
        params: {
            inventoryCode: 'pubname_instream1',
            video: {
                w: 640,
                h: 480
            }
        }
    }]
};

Video (Outstream)

var videoAdUnit = {
    code: 'video1',
    mediaTypes: {
        video: {
            playerSize: [640, 480],
            context: 'outstream',
            placement: 3,
            mimes: ['video/mp4']
        }
    },
    bids: [{
        bidder: 'triplelift',
        params: {
            inventoryCode: 'pubname_outstream',
            video: {
                w: 640,
                h: 480
            }
        }
    }]
};

First Party Data

Publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

  • ortb2.site.*: Standard IAB OpenRTB 2.5 site fields
  • ortb2.user.*: Standard IAB OpenRTB 2.5 user fields

AdUnit-specific data is supported using AdUnit.ortb2Imp.ext.*

TripleLift Native

Features

Bidder Code triplelift_native Prebid.org Member yes
Media Types display, native GDPR TCF Support yes
User IDs criteo, identityLink, unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support check with bidder ORTB Blocking Support 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_triplelift_nat hb_bidder_triplelift hb_adid_triplelift_n
hb_size_triplelift_n hb_source_triplelift hb_format_triplelift
hb_cache_host_triple hb_cache_id_tripleli hb_uuid_triplelift_n
hb_cache_path_triple hb_deal_triplelift_n  

{% capture version2 %} The Triplelift Prebid Server bidding adapter and user sync endpoint require setup before beginning. Please contact us at prebid@triplelift.com. {% endcapture %} {% include alerts/alert_important.html content=version2 %}

This is a Prebid Server adapter for running component native only. For the standard Prebid JS Triplelift bid adapter, see the “Triplelift” bidder.

Table of Contents

Bid Params

Name Scope Description Example Type
inventoryCode required TripleLift inventory code for this ad unit (provided to you by your partner manager) ‘code1’ string
floor optional the bid floor, in usd 1.2 number

First Party Data

Triplelift supports standard IAB OpenRTB 2.5 First Party Data fields, including:

  • site.*
  • user.*

TrustX

Features

Bidder Code trustx Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs all USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support yes First Party Data Support yes
Multi Format Support will-bid-on-any ORTB Blocking Support 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_trustx hb_bidder_trustx hb_adid_trustx
hb_size_trustx hb_source_trustx hb_format_trustx
hb_cache_host_trustx hb_cache_id_trustx hb_uuid_trustx
hb_cache_path_trustx hb_deal_trustx  

Table of Contents

Bid Params

Name Scope Description Example Type
uid required Represents the TrustX bidder system Ad Slot ID associated with the respective div id from the site page. 42 integer
keywords optional A set of key-value pairs applied to all ad slots on the page. Values can be empty. keywords: { topic: ['stress', 'fear'] } object
bidFloor optional Floor of the impression opportunity. If present in the request overrides XML info. 0.8 float

Parameter keywords must have following format:

{
   "site":{
      "publisher1":[
         {
            "name":"SomeKeywordsBlockName",
            "segment1Name":[
               "segment2Value"
            ],
            "segment2Name":[
               "segment2Value1",
               "segment2Value2",
               ...
            ],
            ...
         }
      ],
      ...
   }
}

Bidder Config

You can allow writing in localStorage pbjs.setBidderConfig for the bidder trustx

pbjs.setBidderConfig({
    bidders: ["trustx"],
    config: {
        localStorageWriteAllowed: true
    }
})

If it will be “true” this allow TheMediaGrid Bid Adapter to write userId in first party localStorage

If you want to make alias on TrustX Bid Adapter, you must set forceBidderName in bidderConfig as "trustx".

pbjs.setBidderConfig({
    bidders: ["aliasName"],
    config: {
        forceBidderName: 'trustx'
    }
})

First Party Data

Publishers should use the ortb2 method of setting First Party Data.

Global site or user data using setConfig(), or Bidder-specific using setBidderConfig() supports following fields:

  • ortb2.user.data[]: Standard IAB segment taxonomy user data
  • ortb2.user.ext.device: Non standard arbitrary user device
  • ortb2.user.keywords: Standard IAB OpenRTB 2.5 user.keywords field. It will be included in ext.keywords.user.ortb2
  • ortb2.site.keywords: Standard IAB OpenRTB 2.5 site.keywords field. It will be included in ext.keywords.site.ortb2
  • ortb2.site.cat[]: Standard IAB OpenRTB 2.5 site.cat field. It will be sent as part of site.cat array
  • ortb2.site.pagecat[]: Standard IAB OpenRTB 2.5 site.pagecat field. It will be sent as part of site.cat array
  • ortb2.site.content.genre: Standard IAB OpenRTB 2.5 site.content.genre field

AdUnit-specific data using AdUnit.ortb2Imp supports following fields:

  • ortb2.imp[].ext.data.*
  • ortb2.imp[].instl

TrustX (standalone)

Features

Bidder Code trustx Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support yes
Multi Format Support will-bid-on-any ORTB Blocking Support 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_trustx hb_bidder_trustx hb_adid_trustx
hb_size_trustx hb_source_trustx hb_format_trustx
hb_cache_host_trustx hb_cache_id_trustx hb_uuid_trustx
hb_cache_path_trustx hb_deal_trustx  

Table of Contents

Bid Params

Name Scope Description Example Type
uid required Represents the TrustX bidder system Ad Slot ID associated with the respective div id from the site page. 42 integer
priceType optional (pbjs only) Can take the values gross or net, default value is net. Net represents the header bid price with the TrustX header bidder margin already extracted. Gross price does contain the TrustX bidder margin within. 'gross' string
keywords optional (pbjs only) A set of key-value pairs applied to all ad slots on the page. Values can be empty. keywords: { topic: ['stress', 'fear'] } object
useNewFormat optional (pbjs only) Indicates to use the new ad request format. true boolean

First Party Data

Publishers should use the ortb2 method of setting First Party Data.

Global site or user data using setConfig(), or Bidder-specific using setBidderConfig() supports following fields:

  • ortb2.user.data[]: Standard IAB segment taxonomy user data
  • ortb2.user.keywords: Standard IAB OpenRTB 2.5 user.keywords field. It will be included in ext.keywords.user.ortb2
  • ortb2.site.keywords: Standard IAB OpenRTB 2.5 site.keywords field. It will be included in ext.keywords.site.ortb2

AdUnit-specific data using AdUnit.ortb2Imp supports following fields:

  • ortb2.imp[].ext.data.*
  • ortb2.imp[].instl

Türk Telekom

Features

Bidder Code turktelekom Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_turktelekom hb_bidder_turkteleko hb_adid_turktelekom
hb_size_turktelekom hb_source_turkteleko hb_format_turkteleko
hb_cache_host_turkte hb_cache_id_turktele hb_uuid_turktelekom
hb_cache_path_turkte hb_deal_turktelekom  

Note:

The Türk Telekom bidding adapter requires setup and approval before implementation. Please reach out to ad-ops@turktelekom.com.tr for more details.

Bid Params

Name Scope Description Example Type
host required RTB host 'cpm.programattik.com' string
zoneId required Zone Id 30164 integer

ucfunnel

Features

Bidder Code ucfunnel Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs unifiedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_ucfunnel hb_bidder_ucfunnel hb_adid_ucfunnel
hb_size_ucfunnel hb_source_ucfunnel hb_format_ucfunnel
hb_cache_host_ucfunn hb_cache_id_ucfunnel hb_uuid_ucfunnel
hb_cache_path_ucfunn hb_deal_ucfunnel  

Prebid JS

Bid params

Name Scope Description Example Type
adid required The ad unit ID retrived from ucfunnel dashboard   string
var adUnits = [{
    code: 'div-gpt-ad-1460505748511-01',
    sizes: [
        [300, 250]
    ],
    bids: [{
        bidder: 'ucfunnel',
        params: {
            adid: '123456789'
        }
    }]
}]

Sizes set in the adUnit object will also apply to the ucfunnel bid requests.

Examples

Prebid server

Bid params

Name Scope Description Example Type
adunitid required ID for ad unit   string
partnerid required ID for partner   string

Unibots

Features

Bidder Code unibots Prebid.org Member no
Media Types display, video, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_unibots hb_bidder_unibots hb_adid_unibots
hb_size_unibots hb_source_unibots hb_format_unibots
hb_cache_host_unibot hb_cache_id_unibots hb_uuid_unibots
hb_cache_path_unibot hb_deal_unibots  

Note:

The Unibots bidding adapter requires setup and approval before implementation. Please reach out to saurabh@unibots.in for more details.

Bid Params

Name Scope Description Example Type
host required RTB host 'cpm.unibots.in' string
zoneId required Zone Id 30164 integer

UNICORN

Features

Bidder Code unicorn Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_unicorn hb_bidder_unicorn hb_adid_unicorn
hb_size_unicorn hb_source_unicorn hb_format_unicorn
hb_cache_host_unicor hb_cache_id_unicorn hb_uuid_unicorn
hb_cache_path_unicor hb_deal_unicorn  

bid params

Name Scope Description Example Type
placementId optional Your placement ID 'rectangle-ad-1' string
accountId required Account ID for charge request (provided by UNICORN) 12345 integer
publisherId optional Account specific publisher id. '67890' string
mediaId optional Publisher specific media id. 'example' string
bcat optional for Prebid.js Blocked IAB categories ['IAB-1', 'IAB-2'] [string]

publisherId as integer is also supported on Prebid.js

Unruly

Features

Bidder Code unruly Prebid.org Member no
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 Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_unruly hb_bidder_unruly hb_adid_unruly
hb_size_unruly hb_source_unruly hb_format_unruly
hb_cache_host_unruly hb_cache_id_unruly hb_uuid_unruly
hb_cache_path_unruly hb_deal_unruly  

Bid Params

Name Scope Description Example Type
siteId required The site ID from Unruly. This will be provided to you by your Unruly account manager. 123456 integer
featureOverrides optional This param is a generic object for configuring Unruly outstream demand. To run UNmissable, set ‘canRunUnmissable’ to true. "featureOverrides": {"canRunUnmissable": true} object

Valueimpression

Features

Bidder Code valueimpression Prebid.org Member no
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 Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support yes Prebid Server Adapter yes
Floors Support yes First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_valueimpressio hb_bidder_valueimpre hb_adid_valueimpress
hb_size_valueimpress hb_source_valueimpre hb_format_valueimpre
hb_cache_host_valuei hb_cache_id_valueimp hb_uuid_valueimpress
hb_cache_path_valuei hb_deal_valueimpress  

Description

Valueimpression is an aliased bidder of Apacdex bid adapter. Please refer to Apacdex documentation for bid parameters and implementation guide.

VerizonMedia

Features

Bidder Code verizonmedia Prebid.org Member yes
Media Types display GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_verizonmedia hb_bidder_verizonmed hb_adid_verizonmedia
hb_size_verizonmedia hb_source_verizonmed hb_format_verizonmed
hb_cache_host_verizo hb_cache_id_verizonm hb_uuid_verizonmedia
hb_cache_path_verizo hb_deal_verizonmedia  

Bid Params

Name Scope Description Example Type
dcn required Site ID provided by One Mobile ‘site1’ string
pos required Placement ID ‘placement1’ string

VideoByte

Features

Bidder Code videobyte Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_videobyte hb_bidder_videobyte hb_adid_videobyte
hb_size_videobyte hb_source_videobyte hb_format_videobyte
hb_cache_host_videob hb_cache_id_videobyt hb_uuid_videobyte
hb_cache_path_videob hb_deal_videobyte  

Note:

The VideoByte Prebid.js client adapter only supports video ads while our Prebid Server adapter supports both display and video.

See Videobyte Prebid Client Documentation for more details about Prebid Client integration.

See Videobyte Prebid Server Documentation for more details about Prebid Server integration.

Bid Params

Name Scope Description Example Type
pubId required Publisher ID 'vb12345' string
placementId optional Placement ID '1234567' string
nid optional Network ID '1234' string

Vidoomy

Features

Bidder Code vidoomy Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_vidoomy hb_bidder_vidoomy hb_adid_vidoomy
hb_size_vidoomy hb_source_vidoomy hb_format_vidoomy
hb_cache_host_vidoom hb_cache_id_vidoomy hb_uuid_vidoomy
hb_cache_path_vidoom hb_deal_vidoomy  

Note:

Vidoomy, for more info please contact support@vidoomy.com

Bid Params

Name Scope Description Example Type
id required id 123123 string
pid required pid '123123' string

Bid Params (Prebid Server)

Name Scope Description Example Type
zoneId required Zone Id “123123” string

Viewdeos Server

Features

Bidder Code viewdeos Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_viewdeos hb_bidder_viewdeos hb_adid_viewdeos
hb_size_viewdeos hb_source_viewdeos hb_format_viewdeos
hb_cache_host_viewde hb_cache_id_viewdeos hb_uuid_viewdeos
hb_cache_path_viewde hb_deal_viewdeos  

Bid params

Name Scope Description Example Type
aid required The source ID from member zone 350975 integer

Test Parameters

    var adUnits = [
      // Banner adUnit
      {
        code: 'div-test-div',
        mediaTypes: {
          banner: {
            sizes:[[300, 250]]
          }
        },
        bids: [{
          bidder: 'viewdeos',
          params: {
            aid: 672854
          }
        }]
      }
    ];

YOC VIS.X

Features

Bidder Code visx Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs id5Id, unifiedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_visx hb_bidder_visx hb_adid_visx
hb_size_visx hb_source_visx hb_format_visx
hb_cache_host_visx hb_cache_id_visx hb_uuid_visx
hb_cache_path_visx hb_deal_visx  

Note

To be able to use the full bandwidth of VIS.X high impact ad products, we strongly recommend disabling SafeFrames:

  • If you are using Google Ad Manager (GAM), make sure the “Serve in Safeframe” box in creative settings is unchecked,
  • If you are using AppNexus Seller Tag, make sure the enableSafeFrame parameter is set to False.

If you require SafeFrames to be activated, please reach out to your YOC account manager to obtain further details.

If a single bid request contains more than 20 impression objects, this request will be ignored.

The YOC VIS.X adapter requires setup and approval from your YOC account manager team, even for existing YOC publishers. Please reach out to your account manager to enable Prebid.js for your account.

Configuration: Currency

The YOC VIS.X adapter has the ability to work in different currencies. Currently, this adapter supports EUR, USD, GBP, PLN. Defaults to EUR. If your Ad Server uses EUR, you don’t need any additional currency settings. If you would like to trade with VIS.X in a currency different from EUR, you should implement some additional settings.

  1. Download and configure the Prebid.js Currency module.

http://prebid.org/dev-docs/modules/currency.html

  1. Setup the currency in Currency config.

a) If your Ad Server uses the currency from the list of VIS.X supported currencies (e.g. GBP), use the following settings:

pbjs.setConfig({
    currency: {
        adServerCurrency: 'GBP',
        bidderCurrencyDefault: {
            visx: 'GBP'
        }
    }
});

b) If your Ad Server uses an unsupported currency for VIS.X (e.g. JPY), use the following settings:

pbjs.setConfig({
    currency: {
        adServerCurrency: 'JPY',
        bidderCurrencyDefault: {
            visx: 'EUR'
        }
    }
});

Best practices:

  • Please make sure that the currency module is set up and configured in order to trade with YOC in a currency that is not supported by the YOC VIS.X bidder.
  • You should set EUR in bidderCurrencyDefault parameter if you use unsupported currencies for VIS.X.
  • Feel free to reach out to your contact at YOC if you need additional support setting up Prebid.js and the currency config.

Configuration: Video

The YOC VIS.X Prebid.js adapter responds with VAST XML (in the vastXml field) and expects client-side caching enabled. To enable it, use the following settings:

pbjs.setConfig({
        cache: {
            url: 'https://prebid.adnxs.com/pbc/v1/cache'
        }
});

Bid params

Name Scope Description Example Type
uid required The publisher’s Ad unit ID in VIS.X. '903536' string

Media type Banner object params

Name Scope Description Example Type
sizes required All sizes this ad unit can accept. [[300, 250], [300, 600]] array of integer arrays

Media type Video object params

Name Scope Description Example Type
context required The video context, only ‘instream’ is allowed. 'instream' string
playerSize required The size (width, height) of the video player on the page, in pixels. [640, 480] integer array
mimes optional Content MIME types supported. ['video/mp4', 'video/x-ms-wmv'] string array

Example of Banner Ad unit

var bannerAdUnit = {
    code: 'bannerAdUnit1',
    mediaTypes: {
        banner: {
            sizes: [[320, 480], [728, 90]]    // required
        }
    },
    bids: [{
        bidder: 'visx',
        params: {
            uid: '903536'                     // required
        }
    }]
};

Example of Video Ad unit

var videoAdUnit = {
    code: 'videoAdUnit1',
    mediaTypes: {
        video: {
            context: 'instream',              // required
            playerSize: [400, 300],           // required
            mimes: ['video/mp4']              // optional, required by Prebid Server
        }
    },
    bids: [{
        bidder: 'visx',
        params: {
            uid: '921068'                     // required
        }
    }]
};

VRTCAL Markets, Inc.

Features

Bidder Code vrtcal Prebid.org Member no
Media Types display, video GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support yes COPPA Support yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_vrtcal hb_bidder_vrtcal hb_adid_vrtcal
hb_size_vrtcal hb_source_vrtcal hb_format_vrtcal
hb_cache_host_vrtcal hb_cache_id_vrtcal hb_uuid_vrtcal
hb_cache_path_vrtcal hb_deal_vrtcal  

Bid Params

Name Scope Description Example Type
(none) optional no params required '' n/a

Yahoo SSP

Features

Bidder Code yahoossp 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 yes
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_yahoossp hb_bidder_yahoossp hb_adid_yahoossp
hb_size_yahoossp hb_source_yahoossp hb_format_yahoossp
hb_cache_host_yahoos hb_cache_id_yahoossp hb_uuid_yahoossp
hb_cache_path_yahoos hb_deal_yahoossp  

Important Notice (JS vs PBS)

There are differences between our Prebid.js & Prebid-Server Yahoo SSP adapters. The Prebid-server adapter currently does not support:

  1. Integration via the pubId method.

yahoossp Prebid.js Mandatory Bid Params

The ‘yahoossp’ bid adapter supports 2 alternate integration types:

  1. dcn & pos (Site/App & Position explicit targeting) - For legacy “aol”, “oneMobile” adapter partners/publishers.
  2. pubId (Publisher ID) - For New partners/publishers joining Yahoo SSP and legacy “oneVideo” partners/publishers migrating to the Yahoo SSP.

    yahoossp Prebid-Server Mandatory Bid Params

    Prebid-server adapter supports one integration method:

    • dcn & pos (Site/App & Position explicit targeting) - For legacy “aol”, “oneMobile” adapter partners/publishers.

      DCN & POS Integration Parameters (JS & PBS)

      For legacy “aol”, “oneMobile” adapter partners/publishers.

| Name | Scope | Description | Example | Type | |————|———-|————————|———|———-| | dcn | Required | Site ID provided by Yahoo SSP | ‘site1’ | string | | pos | Required | Placement ID provided by Yahoo SSP | ‘placement1’ | string |

PubId Integration Parameters (JS Only)

For New partners/publishers joining Yahoo SSP floors_supported: true and legacy “oneVideo” partners/publishers migrating to the Yahoo SSP.

Name Scope Description Example Type
pubId Required Your Publisher External ID provided by Yahoo SSP ‘DemoPublisher’ string
siteId Optional Ability to target a specific Site using an External ID provided by Yahoo SSP ‘1234567’ string
placementId Optional Ability to target a specific Placement using an External ID provided by Yahoo SSP ‘header’ string

Prebid.js Adapter Supported Features

For further setup details & examples please see https://github.com/prebid/Prebid.js/blob/master/modules/yahoosspBidAdapter.md

  • Media Types: Banner & Video
  • Outstream renderer
  • Multi-format adUnits
  • Schain module
  • Price floors module
  • Advertiser domains
  • End-2-End self-served testing mode
  • Outstream renderer/Player
  • User ID Modules - ConnectId and others
  • First Party Data (ortb2 & ortb2Imp)
  • Custom TTL (time to live)

Thanks you, Yahoo SSP

YeahMobi

Features

Bidder Code yeahmobi Prebid.org Member yes
Media Types display, native GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_yeahmobi hb_bidder_yeahmobi hb_adid_yeahmobi
hb_size_yeahmobi hb_source_yeahmobi hb_format_yeahmobi
hb_cache_host_yeahmo hb_cache_id_yeahmobi hb_uuid_yeahmobi
hb_cache_path_yeahmo hb_deal_yeahmobi  

Bid Params

Name Scope Description Example Type
pubId required Publisher ID ‘pub1’ string
zoneId required Zone Id ‘zone1’ string

Yieldlab

Features

Bidder Code yieldlab Prebid.org Member yes
Media Types display, video, native GDPR TCF Support yes
User IDs britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId USP/CCPA Support no
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_yieldlab hb_bidder_yieldlab hb_adid_yieldlab
hb_size_yieldlab hb_source_yieldlab hb_format_yieldlab
hb_cache_host_yieldl hb_cache_id_yieldlab hb_uuid_yieldlab
hb_cache_path_yieldl hb_deal_yieldlab  

Bid Params

Name Scope Description Example Type
adslotId required Yieldlab Adslot ID '12345' string
supplyId required Yieldlab Supply ID. Please reach out to your account management for more information. '12345' string
adSize optional Override the default prebid size '970x250' string
targeting optional Key-Value Targeting { 'key1': 'value1', 'key2': 'value2' } object
extId optional External Id 'abc' string
iabContent optional Object of content information, see IAB Content Object for details. It will override the content object passed in First Party Data { 'id': 'foo', 'title': 'bar' } object
customParams optional Custom parameters to append to the query string of the bidding endpoint. { 'param': 'value1', 'param2': 'value2' } object

IAB Content Object

Yieldlab supports passing the IAB content object in correspond to the OpenRTB Specifications. The following attributes are supported, and all of them are optional.

Name Scope Description Example Type
id optional Id uniquely identifying the content '12345' string
episode optional Episode number '42' string
title optional Content title 'some title' string
series optional Content series 'some series' string
season optional Content season 's1' string
artist optional Artist credited with the content 'John Doe' string
genre optional Genre that best describes the content 'some genre' string
isrc optional International Standard Recording Code conforming to ISO3901 'CC-XXX-YY-NNNNN' string
url optional URL of the content, for buy-side contextualization or review 'https://yieldlab.com' string
cat optional Array of IAB content categories that describe the content producer ['IAB1-1', 'IAB1-2'] Array<string>
context optional Type of content - 1: video, 2: game, 3: music, 4: application, 5: text, 6: other, 7: unknown '7' string
keywords optional Array of keywords describing the content ['k1', 'k2', 'k3'] Array<string>
live optional 0 = not live, 1 = content is live '0' string

Yieldmo

Features

Bidder Code yieldmo Prebid.org Member yes
Media Types display, video GDPR TCF Support yes
User IDs pubCommonId, unifiedId, criteo, sharedId USP/CCPA Support yes
Supply Chain Support yes COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_yieldmo hb_bidder_yieldmo hb_adid_yieldmo
hb_size_yieldmo hb_source_yieldmo hb_format_yieldmo
hb_cache_host_yieldm hb_cache_id_yieldmo hb_uuid_yieldmo
hb_cache_path_yieldm hb_deal_yieldmo  

Registration

Note: In order to use Yieldmo adapter please reach out to your Yieldmo account’s person or support@yieldmo.com for more information.


Bid Params

Name Scope Description Example Type
placementId required Yieldmo placement id '825209316101005155' string
bidFloor optional Bid Floor 0.1 float
lr_env optional Live Ramp ATS envelope e3b0c44298fc1c149a string

video parameters

The Yieldmo adapter supports in-stream video as of Prebid v4.18. Out-stream will be supported as of Prebid v4.35.0.

Name Scope Description Example Type
placement required Video placement type. In-Stream: 1; Out-stream types: In-Article - 3: In-Feed - 4; Interstitial - 5;

Currently we are not supporting 2 - in-banner.

See OpenRTB 2.5 specification, List 5.9 for more details
1 integer
maxduration required Maximum ad duration in seconds 20 integer
minduration optional Minimum ad duration in seconds 5 integer
pos optional Ad position on screen; see OpenRTB 2.5 specification, List 5.4 for more details 1 integer
startdelay required for in-stream Duration offset (in second) from the start of the content for showing the video ad before the start of the Video. Pre-roll: 0 (default); Mid-roll: >0; Default mid-roll: -1; Post-roll: -2;

For out-stream is’ always 0
5 integer
protocols required Supported video bid response protocols. VAST 1.0: 1; VAST 2.0: 2; VAST 3.0: 3; VAST 1.0 Wrapper: 4; VAST 2.0 Wrapper: 5; VAST 3.0 Wrapper: 6; [2, 3] Array<integer>
api required API frameworks supported. VPAID 1.0: 1; VPAID 2.0: 2; MRAID-1: 3; ORMMA: 4; MRAID-2: 5; MRAID-3: 6; [1, 2] Array<integer>
playbackmethod required Playback methods that may be in use; see OpenRTB 2.5 specification, List 5.10 for more details. Out-stream is only always 2 [2,6] Array<integer>
skippable optional If ‘true’, user can skip ad true boolean
skipafter optional Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable 5 integer
mimes required List of the content MIME types supported by the player ["video/mp4"] Array<string>

Following video parameters might be also defined in mediaTypes.video in order to simplify bidders configuration. If the same parameters was also defined in params.video it will be overriten by params.video. More details - https://docs.prebid.org/dev-docs/adunit-reference.html

In addition, Yieldmo adapter relies on parameters specified in the mediaTypes.video definition of the video ad-units, namely:

| Name | Scope | Description | Example | Type | |——————-|———-|——————————————————–|—————–|——————| | playerSize | required | Width and height of the player | [640, 480] | Array<integer> | | context | required | instream or outstream are only supported | instream | string |

Example of in-stream Video Ad-unit

var videoAdUnits = [{
  code: 'div-video-ad-1234567890',
  mediaTypes: {
    video: {
      playerSize: [640, 480],           // required
      context: 'instream',
      mimes: ['video/mp4'],             // required, array of strings
      placement: 1,                     // required, integer
      maxduration: 30,                  // required, integer
      minduration: 15,                  // optional, integer
      pos: 1,                           // optional, integer
      startdelay: 10,                   // required if placement == 1
      protocols: [2, 3],                // required, array of integers
      api: [2, 3],                      // required, array of integers
      playbackmethod: [2,6],            // required, array of integers
      skip: 1,                          // optional, boolean
      skipafter: 10                     // optional, integer
    }
  },
  bids: [{
    bidder: 'yieldmo',
    params: {
      placementId: '1524592390382976659',// required,
    }
  }]
}];

Example of out-stream Video Ad-unit

var videoAdUnit = [{
  code: 'div-video-ad-1234567890',
  mediaTypes: {
      video: {
          playerSize: [640, 480],        // required
          context: 'outstream',
          mimes: ['video/mp4'],          // required, array of strings
          placement: 3,                  // required, integer ( 3,4,5 )
          maxduration: 30,               // required, integer
          protocols: [2, 3],             // required, array of integers
          api: [2, 3],                   // required, array of integers
          playbackmethod: [1,2]          // required, array of integers
      }
  },
  bids: [{
    bidder: 'yieldmo',
    params: {
      placementId: '1524592390382976659',  // required
    }
  }]
}];

Prebid out-stream demo

YieldOne

Features

Bidder Code yieldone Prebid.org Member no
Media Types display, video GDPR TCF Support no
User IDs identityLink, imuid, AudienceOne ID, ID5 USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter yes
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support will-bid-on-any ORTB Blocking Support 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_yieldone hb_bidder_yieldone hb_adid_yieldone
hb_size_yieldone hb_source_yieldone hb_format_yieldone
hb_cache_host_yieldo hb_cache_id_yieldone hb_uuid_yieldone
hb_cache_path_yieldo hb_deal_yieldone  

Note:

THE YieldOne adapter requires setup and approval from the YieldOne team.
Please reach out to your account team or y1s@platform-one.co.jp for more information.

Bid Params

Name Scope Description Example Type
placementId required The placement ID "36891" string
playerSize optional Video Resolution Size
(This field is mandatory if mediaTypes.video.playerSize is [1, 1])
[640, 360] array of number
playerParams optional Video Player Params (see below) {} object
playerParams.wrapperWidth optional Video Player Width "320px" string
playerParams.wrapperHeight optional Video Player Height "180px" string

Multi-Format Ad Units

If you use Multi-Format Ad Units, “video” bid object should be placed before “banner” bid object.
And if Bid Params contains playerParams, it will request a “video” media type ad.
If it does not, it will request a “banner” media type ad.

AdUnit Format Example

AdUnit Format for Banner

var bannerAdUnits = [{
    code: "test-div-banner",
    mediaTypes: {
        banner: {
            sizes: [
                [300, 250],
                [1, 1]
            ]
        },
    },
    bids: [{
        bidder: "yieldone",
        params: {
            placementId: "36891" // required
        }
    }]
}]

AdUnit Format for Video

var videoAdUnits = [{
    code: "test-div-video",
    mediaTypes: {
        video: {
            playerSize: [640, 360],
            context: "outstream"
        }
    },
    bids: [{
        bidder: "yieldone",
        params: {
            placementId: "36892",       // required
            playerParams: {             // optional
                wrapperWidth: "320px",  // optional
                wrapperHeight: "180px"  // optional
            },
        }
    }]
}]

AdUnit Format for Multi Ads

var multiAdUnits = [{
    code: "test-div-multi",
    mediaTypes: {
        banner: {
            sizes: [
                [300, 250],
                [1, 1]
            ]
        },
        video: {
            playerSize: [640, 360],
            context: "outstream"
        }
    },
    bids: [{
        // * "video" bid object should be placed before "banner" bid object.
        // This bid will request a "video" media type ad.
        bidder: "yieldone",
        params: {
            placementId: "36892",       // required
            playerParams: {             // required
                wrapperWidth: "320px",  // optional
                wrapperHeight: "180px"  // optional
            },
        }
    },
    {
        // This bid will request a "banner" media type ad.
        bidder: "yieldone",
        params: {
            placementId: "36891"        // required
        }
    }]
}];

AdUnit Format for Video (mediaTypes.video.playerSize: [1,1])

var videoAdUnits = [{
    code: "test-div-video",
    mediaTypes: {
        video: {
            playerSize: [1, 1],
            context: "outstream"
        }
    },
    bids: [{
        bidder: "yieldone",
        params: {
            placementId: "36892",       // required
            playerSize: [640, 360],     // required
            playerParams: {             // optional
                wrapperWidth: "320px",  // optional
                wrapperHeight: "180px"  // optional
            },
        }
    }]
}]

AdUnit Format for Multi Ads (mediaTypes.video.playerSize: [1,1])

var multiAdUnits = [{
    code: "test-div-multi",
    mediaTypes: {
        banner: {
            sizes: [
                [300, 250],
                [1, 1]
            ]
        },
        video: {
            playerSize: [1, 1],
            context: "outstream"
        }
    },
    bids: [{
        // * "video" bid object should be placed before "banner" bid object.
        // This bid will request a "video" media type ad.
        bidder: "yieldone",
        params: {
            placementId: "36892",       // required
            playerSize: [640, 360],     // required
            playerParams: {             // required
                wrapperWidth: "320px",  // optional
                wrapperHeight: "180px"  // optional
            },
        }
    },
    {
        // This bid will request a "banner" media type ad.
        bidder: "yieldone",
        params: {
            placementId: "36891"        // required
        }
    }]
}];

ZeroClickFraud

Features

Bidder Code zeroclickfraud Prebid.org Member no
Media Types display GDPR TCF Support no
User IDs none USP/CCPA Support no
Supply Chain Support no COPPA Support no
Demand Chain Support no Safeframes OK check with bidder
Supports Deals yes Prebid.js Adapter no
Mobile App Support check with bidder Prebid Server Adapter yes
Floors Support check with bidder First Party Data Support check with bidder
Multi Format Support check with bidder ORTB Blocking Support 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_zeroclickfraud hb_bidder_zeroclickf hb_adid_zeroclickfra
hb_size_zeroclickfra hb_source_zeroclickf hb_format_zeroclickf
hb_cache_host_zerocl hb_cache_id_zeroclic hb_uuid_zeroclickfra
hb_cache_path_zerocl hb_deal_zeroclickfra  

Bid Params

Name Scope Description Example Type
sourceId required Website Source Id 111 integer
host required Network Host to request from ‘host1’ string