Standard Adapter Trafficking Instructions

Resources

• To run prebid, Publishers should:
  • Upload the custom prebid.js file downloaded from underdog.media to their site or server so it’s accessible to all pages using prebid. This file runs the auctions.
  • Setup prebid configurations on pages. These configurations specify the ad slots using prebid, bidders, ad sizes, etc.
  • Traffic the prebid code snippet as the creative in Google Ad Mangager (GAM). The setup in GAM includes targeting the creative by typically $0.01 price granularity increments. (Tutorial:  https://docs.prebid.org/adops/step-by-step.html)

• To monetize EU and CA traffic, include these prebid modules in your prebid file from prebid.org or https://www.underdog.media/, every time an updated prebid file is built:

  • Consent Management - GDPR
  • Consent Management - US Privacy

• We recommend that you set your prebid.js timeout to at least 1,000ms - we have found this to be an optimal time balancing time out, win rate, and latency.
  
  
• Our adapter supports the following sizes: 728x90, 300x250, 160x600, 300x600 and 320x50.
  
  
• Add Underdog Media as a bidder in your prebid.js configuration:

{

               bidder: 'underdogmedia',

               params: {

               siteId: 'XXXXX' // TAG_NAME

               }

}

*Replace XXXXX and TAG_NAME with the corresponding values:

Example:   12345 and UDM_PB_examplesite.com

• The same Site ID is used for all sizes, and the same Site ID / Ad Size may be placed multiple times on the same page but by default will report combined together as one Ad Size.  Your prebid configuration specifies which size(s) and how many of each to request bids for, and we request bids for the specified size(s) / amount(s) and return ads as available.  If separate reporting by placement is desired, SubIDs can be implemented, view the article "Header Bidding Custom Variable Tracking" for instructions on setting those up.
  
  
• We request the same number of bids regardless of how many of the same size are included on the page, so there wouldn’t be any difference in request activity or speed/latency for more/less placements of the same size.
  
  
• In reporting, Qualified Impressions = Won Impressions.  A qualified rate of 1% means that we won an ad for the equivalent of 1% of Requests; we may have won multiple impressions on a particular page request.
  
  
• Current versions of Prebid no longer support the calling of external bidders.  Our custom adapter, which is not available through the standard Prebid download, accesses additional quality demand integrations via our external library in a secondary auction.  For most publishers, our win rate and monetization increase significantly.
  
  
• Bids for the standard adapter are GROSS.
  
  
• Our adapter file will require updating if a site’s prebid.js file is rebuilt/updated using the tool at prebid.org or others like it.
  
  
• Review this useful resources from prebid.org to assist with GAM set-up and troubleshooting:
  https://docs.prebid.org/prebid/prebidjs.html
  https://docs.prebid.org/overview/intro.htmlprebid.org/adops.html
  https://docs.prebid.org/dev-docs/getting-started.html
  https://docs.prebid.org/troubleshooting/troubleshooting-guide.html

If you have questions or are unable to follow these steps, please let us know.