New debugging functionality with bid overrides

[snapwich]

Type of change

• Feature

Description of change

This feature adds the ability to override bid responses as they come in or to filter bidders for debugging purposes. The debugging features, when enabled, will stay active for the duration of your session (until you close active tab) or until they are disabled with pbjs.setConfig.

Filtering bidders:

pbjs.setConfig({
  debugging: {
    enabled: true,
    bidders: ['appnexus', 'rubicon']
  }
});

Overwriting bid responses for all bidders:

pbjs.setConfig({
  debugging: {
    enabled: true,
    bids: [{
      cpm: 1.5
    }]
  }
});

Overwriting bid responses for a specific bidder and adUnit code (can use separately)

pbjs.setConfig({
  debugging: {
    enabled: true,
    bids: [{
      bidder: 'rubicon',
      adUnitCode: '/19968336/header-bid-tag-0',
      cpm: 1.5
    }]
  }
});

Disabling debugging

pbjs.setConfig({
  debugging: {
    enabled: false
  }
});

Other information

Original description: https://gist.github.com/bretg/4880f9977a2e49e8a194b701b2e95b67

Using pbjs.setConfig and sessionStorage rather than url strings as encoding JSON for use in URLs is a cumbersome process.

[idettman]

LGTO

[bretg]

Need a section in http://prebid.org/dev-docs/toubleshooting-tips.html with an example of how to use this. I assume that the pbjs.setconfig() calls are meant to be called from the console, right? Not practical in the page.

[snapwich]

@bretg that's right, you would use pbjs.setConfig from the console to enable/disable your debugging session (which can stick around across page-loads until you disable)

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[mkendall07]

Putting the hook here has the disadvantage of not actually suppressing the network call for the bidder. I think it's ok given that it's probably more complex to turn off the bidder completely. We probably just want to point that out it's not a great option to "disable a bidder".

[mkendall07]

could you change this to window.sessionStorage ?

[mkendall07]

LGTM. Nice feature! one small comment.