Prebid

pbjs.addAdUnits([
  {
    code: 'div-gpt-ad-300x250',          // Must match the GPT ad slot div ID on the page
    mediaTypes: {
      banner: {
        sizes: [[300, 250], [300, 600]]   // All sizes the slot accepts — more sizes = more demand
      }
    },
    bids: [
      {
        bidder: 'appnexus',
        params: { placementId: 12345678 }  // Find in AppNexus console under Placements
      },
      {
        bidder: 'rubicon',
        params: {
          accountId: 9001,
          siteId: 283,
          zoneId: 1234                             // All three are required for Rubicon
        }
      },
      {
        bidder: 'ix',                              // Index Exchange — requires explicit size param
        params: {
          siteId: '47777',
          size: [300, 250]                // IX does not infer size from mediaTypes
        }
      },
      {
        bidder: 'pubmatic',
        params: {
          publisherId: '158355',
          adSlot: 'homepage-mrec@300x250'          // PubMatic slot name includes size annotation
        }
      }
    ]
  },

  {
    code: 'div-gpt-ad-video',
    mediaTypes: {
      video: {
        context: 'instream',                       // 'instream' = inside video player; 'outstream' = injected player
        playerSize: [[640, 480]],
        mimes: ['video/mp4'],
        protocols: [1, 2, 3, 4, 5, 6],
        playbackmethod: [2],                       // 2 = auto-play with sound on
        skip: 1,
        skipafter: 5                               // User can skip after 5 seconds
      }
    },
    bids: [
      {
        bidder: 'appnexus',
        params: {
          placementId: 98765432,
          video: {
            skippable: true,
            playback_method: ['auto_play_sound_on']
          }
        }
      }
    ]
  }
]);

pbjs.setConfig({

  bidderTimeout: 1500,                 // ms — adapters not responding by this time are dropped
                                              // Under 800ms = high timeout rate; over 2000ms = slow page

  enableSendAllBids: false,            // false = only winning bid key-values sent to GAM (cleaner)
                                              // true = all bidder key-values sent (hb_pb_appnexus, hb_pb_rubicon...)

  priceGranularity: {
    buckets: [
      { max: 5,   increment: 0.05 },       // $0–$5 in 5-cent steps (100 buckets)
      { max: 20,  increment: 0.10 },       // $5–$20 in 10-cent steps (150 buckets)
      { max: 100, increment: 0.50 }        // $20–$100 in 50-cent steps (160 buckets)
    ]
    // Custom granularity prevents revenue leakage from bucket rounding.
    // A $2.49 bid with 'medium' granularity rounds to $2.40 — 9 cent/CPM loss at scale.
  },

  userSync: {
    syncEnabled: true,
    filterSettings: {
      iframe: {
        bidders: ['appnexus', 'rubicon', 'pubmatic'],
        filter: 'include'                    // Whitelist these adapters for iframe syncs
      },
      image: {
        bidders: '*',                        // Allow all adapters to fire image pixel syncs
        filter: 'include'
      }
    },
    syncsPerBidder: 5,                      // Max sync calls per adapter per page load
    syncDelay: 3000                          // ms after auction before syncs fire — prevents latency impact
  },

  currency: {
    adServerCurrency: 'USD',                // Normalize all bid prices to this for GAM key-value targeting
    granularityMultiplier: 1
  },

  schain: {                                           // Supply chain — required by many DSPs
    validation: 'strict',
    config: {
      ver: '1.0',
      complete: 1,
      nodes: [{ asi: 'your-exchange.com', sid: 'pub-456', hp: 1 }]
    }
  },

  debug: false                               // Set to true in dev — verbose auction log in console

});

pbjs.que.push(function () {
  pbjs.setConfig({ bidderTimeout: 1500 });
  pbjs.addAdUnits(adUnits);

  pbjs.requestBids({
    timeout: 1500,
    bidsBackHandler: function (bids) {
      // Called when all bids are in OR timeout fires — whichever is first
      pbjs.setTargetingForGPTAsync();    // Writes hb_pb, hb_bidder, hb_adid to GPT slot targeting
      googletag.pubads().refresh();     // Fires GAM ad request with Prebid key-values attached
    }
  });
});

// === Browser console debugging commands ===
// pbjs.getBidResponses()                   → all bids per ad unit (including status)
// pbjs.getHighestCpmBids()                 → winning bid per unit
// pbjs.getBidResponsesForAdUnitCode('X')   → bids for a specific div ID
// pbjs.getAdserverTargeting()              → key-values set on GPT slots