Skip to content

Update reference docs with the changes made in V10 #6506

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
robin-crazygames wants to merge 11 commits into
base: master
Choose a base branch
from
Open

Update reference docs with the changes made in V10 #6506

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
5cd3368
Update pb10-notes.md: refer to correct method
robin-crazygames Mar 26, 2026
451990f
dfp has been renamed to gam
robin-crazygames Mar 26, 2026
7d6f2f2
Made distinction between methods returnning an array and methods retu…
robin-crazygames Mar 26, 2026
4680598
Clarified return type
robin-crazygames Mar 26, 2026
6ba9d95
Clarified return type
robin-crazygames Mar 26, 2026
f327ec8
Documented null return type
robin-crazygames Mar 26, 2026
11d3777
Merge branch 'master' into patch-10
robin-crazygames Apr 3, 2026
76be8f0
Lint error: add missing space to the left/right of table pipe
robin-crazygames Apr 3, 2026
de13528
Lint error: table should be surrounded by blank lines
robin-crazygames Apr 3, 2026
a2231eb
Lint error: add missing space to table pipe
robin-crazygames Apr 3, 2026
65da7f2
Lint error: heading levels should only increment by one level at a time
robin-crazygames Apr 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions dev-docs/pb10-notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,11 +19,12 @@ This document describes the changes included for Prebid.js version 10.0.
1. A large number of obsolete modules have been removed. Many modules have changed name. See below for the list.
2. The legacy method of native targeting keys, `sendTargetingKeys`, has been removed.
3. `pbadslot` has been removed from the preAuction module. Use `ortb2Imp.ext.gpid` instead.
4. The API methods `getBidResponses` and `getNoBidsForAdUnitCode` now return arrays of bids.
5. TypeScript support has landed and Node.js 20+ is required to build.
6. Using Prebid as an NPM dependency no longer requires using Babel or Prebid's Babel settings.
7. `targetingControls.allBidsCustomTargeting` now defaults to `false`, this prevents custom targeting values from being set for non-winning bids.
8. Storage use disclosures can now be enforced and catalogued
4. The API methods `getBidResponsesForAdUnitCode` and `getNoBidsForAdUnitCode` now return arrays of bids.
5. The API methods `getBidResponses` and `getNoBids` now return an object with an array of bids for each ad unit.
6. TypeScript support has landed and Node.js 20+ is required to build.
7. Using Prebid as an NPM dependency no longer requires using Babel or Prebid's Babel settings.
8. `targetingControls.allBidsCustomTargeting` now defaults to `false`, this prevents custom targeting values from being set for non-winning bids.
9. Storage use disclosures can now be enforced and catalogued

## Removed Modules

Expand All @@ -32,7 +33,7 @@ The following modules have been removed from Prebid.js as part of the 10.0 relea
{: .table .table-bordered .table-striped }

| Module | Replacement |
|:-----------------------------|:-------------------------|
| :----------------------------- | :------------------------- |
| dfpAdServerVideo | gamAdServerVideo |
| dfpAdPod | gamAdPod |
| telariaBidAdapter | |
Expand Down
14 changes: 7 additions & 7 deletions ...rence/adServers.dfp.buildAdpodVideoUrl.md → ...rence/adServers.gam.buildAdpodVideoUrl.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
---
layout: api_prebidjs
Copy link
Copy Markdown
Contributor Author

@robin-crazygames robin-crazygames Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since the adServers.dfp.xxx is still present in V10 and higher, an alternative would be to have 2 versions of the file.

  • The old dfp file, with a warning at the top
  • The new file

For now, I went for the least amount of work approach and only kept the .gam. version in the docs

title: pbjs.adServers.dfp.buildAdpodVideoUrl(options) <span style="color:red" markdown="1">[Alpha]</span>
description: adServers.dfp.buildAdpodVideoUrl API
title: pbjs.adServers.gam.buildAdpodVideoUrl(options) <span style="color:red" markdown="1">[Alpha]</span>
description: adServers.gam.buildAdpodVideoUrl API
sidebarType: 1
---


{: .alert.alert-info :}
The GAM implementation of this function requires including the `dfpAdServerVideo` module in your Prebid.js build.
The GAM implementation of this function requires including the `gamAdServerVideo` module in your Prebid.js build.

This method combines publisher-provided parameters with Prebid.js targeting parameters to build a GAM video ad tag URL that can be used by a video player.

#### Argument Reference
## Argument Reference
Copy link
Copy Markdown
Contributor Author

@robin-crazygames robin-crazygames Apr 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't like this, but I had to do it in a few places to satisfy the linter.
Otherwise, I bumped into https://github.com/DavidAnson/markdownlint/blob/main/doc/md001.md .

Note that there are a bunch more files that would violate this rule


##### The `options` object
### The `options` object

{: .table .table-bordered .table-striped }
| Field | Type | Description |
Expand All @@ -23,7 +23,7 @@ This method combines publisher-provided parameters with Prebid.js targeting para

{% include alerts/alert_important.html content="For long form Prebid.js will add key-value strings for multiple bids. This prevents retrieving the description url from bid." %}

#### Example
## Example

```JavaScript
pbjs.que.push(function(){
Expand All @@ -42,7 +42,7 @@ pbjs.que.push(function(){

pbjs.requestBids({
bidsBackHandler: function(bids) {
pbjs.adServers.dfp. buildAdpodVideoUrl({
pbjs.adServers.gam. buildAdpodVideoUrl({
codes: ['sample-code'],
params: {
iu: '/123456/testing/prebid.org/adunit1',
Expand Down
18 changes: 9 additions & 9 deletions ...-reference/adServers.dfp.buildVideoUrl.md → ...-reference/adServers.gam.buildVideoUrl.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
---
layout: api_prebidjs
title: pbjs.adServers.dfp.buildVideoUrl(options)
description: adServers.dfp.buildVideoUrl API
title: pbjs.adServers.gam.buildVideoUrl(options)
description: adServers.gam.buildVideoUrl API
sidebarType: 1
---


{: .alert.alert-info :}
The Google Ad Manager implementation of this function requires including the `dfpAdServerVideo` module in your Prebid.js build.
The Google Ad Manager implementation of this function requires including the `gamAdServerVideo` module in your Prebid.js build.

This method combines publisher-provided parameters with Prebid.js targeting parameters to build a Google Ad Manager video ad tag URL that can be used by a video player.

#### Argument Reference
## Argument Reference

##### The `options` object
### The `options` object

{: .table .table-bordered .table-striped }
| Field | Type | Description |
Expand All @@ -26,7 +26,7 @@ This method combines publisher-provided parameters with Prebid.js targeting para
{: .alert.alert-warning :}
One or both of options.params and options.url is required. In other words, you may pass in one, the other, or both, but not neither.

##### The `options.params` object
### The `options.params` object

{: .table .table-bordered .table-striped }
| Field | Type | Description | Example |
Expand All @@ -37,7 +37,7 @@ One or both of options.params and options.url is required. In other words, you m

For more information on any of these params, see [the Google Ad Manager video tag documentation](https://support.google.com/admanager/answer/1068325).

#### Examples
## Examples

There are several different ways to build up your video URL, as shown in the examples below:

Expand All @@ -46,7 +46,7 @@ Using `options.params` only:
```javascript
pbjs.requestBids({
bidsBackHandler: function(bids) {
var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
var videoUrl = pbjs.adServers.gam.buildVideoUrl({
adUnit: videoAdUnit,
params: {
iu: '/19968336/prebid_cache_video_adunit',
Expand All @@ -72,7 +72,7 @@ var adserverTag = 'https://pubads.g.doubleclick.net/gampad/ads?'
+ '&env=vp&output=xml_vast2&unviewed_position_start=1&hl=en&url=https://www.example.com'
+ '&cust_params=section%3Dblog%26anotherKey%3DanotherValue';

var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
var videoUrl = pbjs.adServers.gam.buildVideoUrl({
adUnit: videoAdUnit,
url: adserverTag
});
Expand Down
23 changes: 5 additions & 18 deletions dev-docs/publisher-api-reference/getBidResponses.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This function returns the bid responses at the given moment.

**Kind**: static method of `pbjs`.

**Returns**: `object` - map | object that contains the bidResponses.
**Returns**: `object` - map | object that contains for each ad unit the array of bid responses. For backwards compatibility, the arrays expose the array also under the `.bids` property.
Copy link
Copy Markdown
Contributor Author

@robin-crazygames robin-crazygames Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure if we want to keep the "For backwards compatibility, ..." sentence in here.

I added it because otherwise people might inspect what they get from this method, and discover that it is not in sync with the docs / wonder why there is an additional .bids property present on the array.


**Returned Object Params**:

Expand All @@ -36,7 +36,6 @@ This function returns the bid responses at the given moment.
| `adserverTargeting` | Object | Contains all the adserver targeting parameters | `{ "hb_bidder": "appnexus", "hb_adid": "7a53a9d3" }` |
| `native` | Object | Contains native key value pairs. | `{ "title": "", "body": "" }` |
| `status` | String | Status of the bid. Possible values: targetingSet, rendered | `"targetingSet"` |
| `statusMessage` | String | The bid's status message | "Bid returned empty or error response" or "Bid available" |
| `ttl` | Integer | How long (in seconds) this bid is considered valid. See this [FAQ entry]({{site.github.url}}/dev-docs/faq.html#does-prebidjs-cache-bids) for more info. | `300` |

<div class="panel-group" id="accordion" role="tablist" aria-multiselectable="true">
Expand All @@ -54,13 +53,11 @@ This function returns the bid responses at the given moment.

```json
{
"/9968336/header-bid-tag-0": {
"bids": [
"/9968336/header-bid-tag-0": [
Copy link
Copy Markdown
Contributor Author

@robin-crazygames robin-crazygames Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't really saw a way to include the .bids property that we have for backwards compatibility here while keeping things readable.
So I just went for the array.

{
"bidderCode": "appnexus",
"width": 300,
"height": 250,
"statusMessage": "Bid available",
"adId": "7a53a9d3",
"creative_id": 29681110,
"cpm": 0.5,
Expand All @@ -81,7 +78,6 @@ This function returns the bid responses at the given moment.
"bidderCode": "pubmatic",
"width": "300",
"height": "250",
"statusMessage": "Bid available",
"adId": "1139e34e14",
"adSlot": "39620189@300x250",
"cpm": 1,
Expand All @@ -105,7 +101,6 @@ This function returns the bid responses at the given moment.
"bidderCode": "rubicon",
"width": "300",
"height": "250",
"statusMessage": "Bid available",
"adId": "130d3b0d9b",
"cpm": 0.795995,
"ad": "<scri...pt>",
Expand All @@ -124,15 +119,12 @@ This function returns the bid responses at the given moment.
"hb_pb": "0.50"
}
}
]
},
"/9968336/header-bid-tag1": {
"bids": [
],
"/9968336/header-bid-tag1": [
{
"bidderCode": "casale",
"width": 0,
"height": 0,
"statusMessage": "Bid returned empty or error response",
"adId": "108c0ba49d",
"requestTimestamp": 1444844944130,
"responseTimestamp": 1444844944223,
Expand All @@ -145,7 +137,6 @@ This function returns the bid responses at the given moment.
"bidderCode": "openx",
"width": "728",
"height": "90",
"statusMessage": "Bid available",
"adId": "14d7f9208f",
"ad_id": "537161420",
"cpm": 1.717,
Expand All @@ -164,7 +155,6 @@ This function returns the bid responses at the given moment.
}
}
]
}
}
```

Expand All @@ -188,8 +178,7 @@ This function returns the bid responses at the given moment.

```json
{
"div-banner-outstream-native" : {
"bids" : [
"div-banner-outstream-native" : [
{
"pbMg" : "10.00",
"pbLg" : "5.00",
Expand Down Expand Up @@ -250,12 +239,10 @@ This function returns the bid responses at the given moment.
"ttl" : 300,
"status" : "targetingSet",
"height" : 0,
"statusMessage" : "Bid available",
"cpm" : 10,
"currency" : "USD"
}
]
}
}
```

Expand Down
3 changes: 2 additions & 1 deletion dev-docs/publisher-api-reference/getBidResponsesForAdUnitCode.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,10 @@ Returns bidResponses for the specified adUnitCode. See full documentation at [pb

**Kind**: static method of `pbjs`

**Returns**: `Object` - bidResponse object
**Returns**: `Array` - an array of bid responses. For backwards compatibility, the array exposes the array also under the `.bids` property.

{: .table .table-bordered .table-striped }

| Param | Scope | Type | Description |
| --- | --- | --- | --- |
| adUnitCode | Required | `String` | adUnitCode |
1 change: 1 addition & 0 deletions dev-docs/publisher-api-reference/getHighestUnusedBidResponseForAdUnitCode.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,6 @@ sidebarType: 1
---

Use this method to retrieve the highest unused bid for the specified adUnit. Unused means not it's not rendered.
Returns `null` when no suitable bid exists.

This differs from [`getHighestCpmBids()`](/dev-docs/publisher-api-reference/getHighestCpmBids.html) in that getHighestCpmBids only considers bids for auctions that have completed (and are also unused), this function considers bids for ongoing auctions as well.
Loading