diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md index 2e9c9916eb..ff9a98e92e 100644 --- a/dev-docs/publisher-api-reference/setConfig.md +++ b/dev-docs/publisher-api-reference/setConfig.md @@ -1290,6 +1290,7 @@ The `auctionOptions` object controls aspects related to auctions. | `secondaryBidders` | Optional | Array of Strings | Specifies bidders that the Prebid auction will no longer wait for before determining the auction has completed. This may be helpful if you find there are a number of low performing and/or high timeout bidders in your page's rotation. | | `suppressStaleRender` | Optional | Boolean | When true, prevents `banner` bids from being rendered more than once. It should only be enabled after auto-refreshing is implemented correctly. Default is false. | | `suppressExpiredRender` | Optional | Boolean | When true, prevent bids from being rendered if TTL is reached. Default is false. +| `legacyRender` | Optional | Boolean | When true, use legacy rendering logic (see [note](#legacyRender))). Default is false. | #### Examples {: .no_toc} @@ -1348,6 +1349,22 @@ PBJS performs the following actions when expired rendering is detected. Expired winning bids will continue to be rendered unless `suppressExpiredRender` is set to true. Events including `STALE_RENDER` and `BID_WON` are unaffected by this option. + + +#### More on Legacy Rendering + +Since Prebid 10.12, [`renderAd`](/dev-docs/publisher-api-reference/renderAd.html) wraps creatives in an additional iframe. This can cause problems for some creatives +that try to reach the top window and do not expect to find the extra iframe. You may set `legacyRender: true` to revert +to pre-10.12 rendering logic: + +```javascript +pbjs.setConfig({ + auctionOptions: { + legacyRender: true + } +}); +``` + ### maxNestedIframes diff --git a/dev-docs/publisher-api-reference/yield.md b/dev-docs/publisher-api-reference/yield.md new file mode 100644 index 0000000000..169a50ef6c --- /dev/null +++ b/dev-docs/publisher-api-reference/yield.md @@ -0,0 +1,16 @@ +--- +layout: api_prebidjs +title: pbjs.yield +description: yield setting +sidebarType: 1 +--- + +Since version 10, [pbjs.processQueue](/dev-docs/publisher-api-reference/processQueue.html) yields the main browser thread after executing each command in the queue, to improve UX (and some related metrics such as [interaction to next paint](https://web.dev/articles/inp)). + +You can disable yielding by setting `pbjs.yield` to `false`: + +```javascript +pbjs.yield = false; + +pbjs.que.push(/* ... */) +```