Prebid integrations use the Sovrn bid adapter. Full adapter documentation is available on the Sovrn Prebid adapter page on GitHub.
Before You Begin (Prebid Server Only)
Before going live with a Prebid Server integration, you must provide Sovrn with your Prebid Server URL to ensure it has been whitelisted in Sovrn's system. Without this step, bid requests from your server will not be accepted. Reach out to your Sovrn Solutions Engineer or Sovrn Support to get your URL whitelisted.
This step is not required for Prebid Client (Prebid.js) integrations.
Bid Parameters
Required
-
publisherid – the unique numerical identifier for your Sovrn publisher account, also known as your Sovrn Seller ID, listed in your ads.txt/app-ads.txt entry. You can find your Seller ID in the Sovrn Platform under Advertising > Ads.txt at platform.sovrn.com/advertising/ads-txt.
-
tagid - the unique numerical identifier for a Sovrn ad tag. You can create ad tags in the Sovrn Platform under Advertising > Ad Tags at platform.sovrn.com/advertising/ad-tags.
While tagid is required, Sovrn does not currently report on tag ID in the platform, so there’s no need to do a full tag mapping for reporting purposes. Sovrn recommends sending a single tagid for now.
Optional
-
bidfloor — the minimum acceptable bid in CPM (USD). Sovrn recommends leaving this unset, as Sovrn’s flooring model uses buying behavior and publisher signals to drive CPMs. If you have your own flooring model, Sovrn can support it.
-
adunitcode — a string identifier for the ad unit.
Configuration
A basic Prebid configuration with Sovrn looks like this:
var adUnit = {
code: 'div-ad-unit',
mediaTypes: { banner: { sizes: [[300, 250]] } },
bids: [{
bidder: 'sovrn',
params: {
tagid: '315045'
}
}]
}
Note: All bid params (tagid, bidfloor) are lowercase. Do not reuse the same tagid more than once within a single request.
Improve Fill Rate and CPM
To help improve fill rate and CPM for the auction, add the Sovrn beacon call to the <head> of your web page:
<script src="//ap.lijit.com/www/sovrn_beacon_standalone/sovrn_standalone_beacon.js?iid=12345678" id="sBeacon"></script>
Your Sovrn Solutions Engineer or Sovrn Support Team member will provide your iid — it’s unique to your Sovrn account. Replace 12345678 in the example above with your own iid.
Questions? Concerns? Our team would be more than happy to help. Reach out to our Support Team here.