PubMatic Prebid.js Adapter Parameters

Document created by catherine.racette on Apr 5, 2018Last modified by Marcos.Male on Aug 20, 2018
Version 10Show Document
  • View in full screen mode

This documentation is also available at

Prebid Server Note: Before configuring the PubMatic adapter as S2S, you must reach out to the PubMatic team for approval and setup steps.

Prebid 1.0 Upgrade Note: If you are upgrading from a Prebid version prior to 1.0, please reach out to your PubMatic Customer Success Manager prior to your upgrade. Publisher accounts need new settings to function correctly with the PubMatic Prebid 1.0 adapter and your Customer Success Manager will ensure your account is setup correctly.

Bidder Code

  • pubmatic


"Send All Bids" Ad Server Keys

  • hb_pb_pubmatic
  • hb_adid_pubmatic
  • hb_size_pubmatic


"Default Deal ID" Ad Server Key

  • hb_deal_pubmatic


Bid Params

NameScopeSupported Client-SideSupported S2SDescriptionExample
publisherIdrequiredPublisher ID“32572”
adSlotrequiredAd Unit ID“38519891@300x250”
pmzoneidoptionalZone ID“zone1,zone2”
yoboptionalYear of Birth“1982”
kadpageurloptionalOverrides Page URL”
kadflooroptionalBid Floor“1.75”
dctroptionalUp to Prebid v0.34Deal Custom Targeting"company=pubmatic|place=pune,banglore"



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

    userSync: {
        iframeEnabled: true,
        enabledBidders: ['pubmatic'],
        syncDelay: 6000
Combine the above configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only the last call for a given attribute takes effect.

Video Specific Parameters 

The PubMatic client-side adapter supports video as of Prebid 1.16.0

video.mimesrequiredVideo MIME types['video/mp4','video/x-flv']
video.skippableoptionalIf ‘true’, user can skip adtrue
video.mindurationoptionalMinimum ad duration in seconds5
video.maxdurationoptionalMaximum ad duration in seconds30
video.startdelayoptionalStart delay in seconds for pre-roll, mid-roll, or post-roll ad placements. See OpenRTB 2.5 specification, List 5.12 for values0
video.playbackmethodoptionalDefines whether inventory is user-initiated or autoplay sound on/off
1 = Auto-play, sound on
2 = Auto-play, sound off
3 = Click-to-play
4 = mouse-over
video.apioptionalAPI frameworks supported
1 = VPAID 1.0
2 = VPAID 2.0
3 = MRAID-1
5 = MRAID-2
[1, 2]
video.protocolsoptionalSupported video bid response 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
[5, 6]
video.woptionalVideo player width in pixels640
video.hoptionalVideo play height in pixels480
video.battroptionalBlocked creative attributes, See OpenRTB 2.5 specification, List 5.3 for values[3, 9]
video.linearityoptionalIndicates if the impression is linear or nar
1 = Linear/In-Stream
2 = Non-Linear/Overlay.
video.placementoptionalVideo placement type. See OpenRTB 2.5 specification, List 5.9 for values1
video.maxbitrateoptionalMaximum bit rate in Kbps1400


Sample Video Ad Unit Bidder Configuration

   bidder: 'pubmatic',
    params: {
       publisherId: "156209",
       adSlot: "pubmatic_video1@640x480", // maps to imp.tagid in request
       video: {
          skippable: true,
          minduration: 1,
          maxduration: 30,
          mimes: ['video/mp4', 'video/webm', 'application/javascript', ' video/ogg'],
          startdelay: 0,
          playbackmethod: [1,3],
          protocols: [ 2, 3, 4, 5 ],
          w: 640,
          h: 480,
          linearity: 1

Configuration for video

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

    cache: {
        url: ''


⇧ Top