Skip to content

Prebid JS

Go to prebid js download page, select Bidder Adapters OperaAds and User ID Module Unified ID,SharedID*,*PubCommon ID*, then click Get Prebid.js

Change Log

  1. Init version, integrated in prebid.js v5.6
  2. Non-USD currency support, integrated in prebid.js v5.12
  3. User sync support, integrated in prebid.js v5.20

Supported Creative Types

  1. Display Ads(Banner)

  2. Native Ads

  3. Video Ads

    • Instream

    • Outstream

Bid Parameters

NameScopeTypeDescriptionExample
placementIdrequiredStringThe Placement Id provided by Opera Ads.s5340077725248
endpointIdrequiredStringThe Endpoint Id provided by Opera Ads.ep3425464070464
publisherIdrequiredStringThe Publisher Id provided by Opera Ads.pub3054952966336
currencyoptionalString or String[]Currency.USD
bcatoptionalString or String[]The bcat value.IAB9-31

Bid Video Parameters

Set these parameters to bid.mediaTypes.video.

NameScopeTypeDescriptionExample
contextoptionalStringinstream or outstream.instream
mimesoptionalString[]Content MIME types supported.['video/mp4']
playerSizeoptionalNumber[] or Number[][]Video player size in device independent pixels[[640, 480]]
protocolsoptionalNumber[]Array of supported video protocls.[1, 2, 3, 4, 5, 6, 7, 8]
startdelayoptionalNumberIndicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.0
skipoptionalNumberIndicates if the player will allow the video to be skipped, where 0 = no, 1 = yes.1
playbackmethodoptionalNumber[]Playback methods that may be in use.[2]
deliveryoptionalNumber[]Supported delivery methods.[1]
apioptionalNumber[]List of supported API frameworks for this impression.[1, 2, 5]

Bid Native Parameters

Set these parameters to bid.nativeParams or bid.mediaTypes.native.

NameScopeTypeDescriptionExample
titleoptionalObjectConfig for native asset title.{required: true, len: 25}
imageoptionalObjectConfig for native asset image.{required: true, sizes: [[300, 250]], aspect_ratios: [{min_width: 300, min_height: 250, ratio_width: 1, ratio_height: 1}]}
iconoptionalObjectConfig for native asset icon.{required: true, sizes: [[60, 60]], aspect_ratios: [{min_width: 60, min_height: 60, ratio_width: 1, ratio_height: 1}]}}
sponsoredByoptionalObjectConfig for native asset sponsoredBy.{required: true, len: 20}
bodyoptionalObjectConfig for native asset body.{required: true, len: 200}
ctaoptionalObjectConfig for native asset cta.{required: true, len: 20}

Example Parameters

javascript
var adUnits = [
  {
    code: "banner-ad-div",
    mediaTypes: {
      banner: {
        sizes: [[300, 250]],
      },
    },
    bids: [
      {
        bidder: "operaads",
        params: {
          placementId: "s5732651204928",
          endpointId: "ep5732673449728",
          publisherId: "pub5732583002624",
        },
      },
    ],
  },
];

Video Ads

javascript
var adUnits = [
  {
    code: "video-ad-div",
    mediaTypes: {
      video: {
        context: "instream",
        playerSize: [640, 480],
        mimes: ["video/mp4"],
        protocols: [1, 2, 3, 4, 5, 6, 7, 8],
        playbackmethod: [2],
        skip: 1,
      },
    },
    bids: [
      {
        bidder: "operaads",
        params: {
          placementId: "s5732651204928",
          endpointId: "ep5732673449728",
          publisherId: "pub5732583002624",
        },
      },
    ],
  },
];

For video ads, enable prebid cache.

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

Native Ads

javascript
var adUnits = [
  {
    code: "native-ad-div",
    mediaTypes: {
      native: {
        title: { required: true, len: 75 },
        image: { required: true, sizes: [[300, 250]] },
        body: { len: 200 },
        sponsoredBy: { len: 20 },
      },
    },
    bids: [
      {
        bidder: "operaads",
        params: {
          placementId: "s5732651204928",
          endpointId: "ep5732673449728",
          publisherId: "pub5732583002624",
        },
      },
    ],
  },
];

Make sure the bidfloorprice is set to zero, then the example paramters above will get test ads returned.

User Ids

Opera Ads Bid Adapter uses sharedId, pubcid or tdid, please config at least one.

javascript
pbjs.setConfig({
  ...,
  userSync: {
    userIds: [{
      name: 'sharedId',
      storage: {
        name: '_sharedID', // name of the 1st party cookie
        type: 'cookie',
        expires: 30
      }
    }]
  }
});