Skip to content

Commit 7cfaa48

Browse files
author
Adrian Dzida
committed
Merge remote-tracking branch 'fork/video-docs' into video-docs
2 parents 05e1ef2 + 88e9207 commit 7cfaa48

39 files changed

Lines changed: 1222 additions & 174 deletions

.github/workflows/ci.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,15 @@ jobs:
1515
name: run markdownlint
1616
runs-on: ubuntu-latest
1717
steps:
18-
- uses: actions/checkout@v4
18+
- uses: actions/checkout@v6
1919
with:
2020
fetch-depth: 0
21-
- uses: tj-actions/changed-files@v46
21+
- uses: tj-actions/changed-files@v47
2222
id: changed-files
2323
with:
2424
files: '**/*.md'
2525
separator: ","
26-
- uses: DavidAnson/markdownlint-cli2-action@v16
26+
- uses: DavidAnson/markdownlint-cli2-action@v22
2727
if: steps.changed-files.outputs.any_changed == 'true'
2828
with:
2929
globs: "${{ steps.changed-files.outputs.all_changed_files }},!_includes"

agents/salesagent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ sidebarType: 10
1010
The Prebid Sales Agent is a server that exposes advertising inventory to AI agents via the Model Context Protocol (MCP) and Agent-to-Agent (A2A) protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle.
1111

1212
<div class="alert alert-info" role="alert">
13-
For the full source code and latest updates, visit the <a href="https://github.com/prebid/salesagent">prebid/salesagent repository</a>.
13+
Please see our Prebid Salesagent <a href="https://main.d1tyvbf1at6iao.amplifyapp.com">testing dashboard</a> for feature and schema testing coverage or visit the <a href="https://github.com/prebid/salesagent">salesagent repository</a>.
1414
</div>
1515

1616
## Key Features

dev-docs/adunit-reference.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,7 @@ See the table below for the list of properties on the ad unit. For example ad un
4343
| `video` | Optional | Object | Used to link an Ad Unit to the [Video Module][videoModule]. For allowed params see the [adUnit.video reference](#adunitvideo). |
4444
| `deferBilling` | Optional | Boolean | Used by a publisher to flag adUnits as being separately billable. This allows for a publisher to trigger billing manually for winning bids. See [pbjs.triggerBilling](/dev-docs/publisher-api-reference/triggerBilling.html) and [onBidBillable](/dev-docs/bidder-adaptor.html#registering-on-bid-billable) for more info. |
4545
| `bidLimit` | Optional | Number | Used by a publisher to set a bid limit for this ad unit |
46+
| `element` | Optional | HTMLElement | A DOM element corresponding to this ad unit, used for viewability measurements. Defaults to `document.getElementById(code)` |
4647

4748
<a name="adUnit.bids"></a>
4849

dev-docs/analytics/automatad.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ tcfeu_supported: false
77
usp_supported: false
88
coppa_supported: false
99
prebid_member: false
10-
enable_download: false
10+
enable_download: true
1111
---
1212

1313
#### Instructions for usage

dev-docs/analytics/intentiq.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ No registration for this module is required.
3535
| options.browserBlackList | Optional | String | This is the name of a browser that can be added to a blacklist.| `"chrome"`|
3636
| options.domainName | Optional | String | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages.| `"currentDomain.com"`|
3737
| options. additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
38-
| options. additionalParams[0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
39-
| options. additionalParams[0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
40-
| options. additionalParams[0].destination | Required | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
38+
| options. additionalParams[0].parameterName | Optional | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
39+
| options. additionalParams[0].parameterValue | Optional | String / Number | Value to assign to the parameter. | `123` |
40+
| options. additionalParams[0].destination | Optional | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
4141

4242
#### Example Configuration
4343

@@ -95,12 +95,12 @@ pos: 0 // The following values are defined in the ORTB 2.5 spec
9595
```
9696

9797
{: .table .table-bordered .table-striped }
98-
| Field | Data Type | Description | Example | Mandatory |
98+
| Field | Data Type | Description | Example | Mandatory |
9999
|--------------------|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|-----------|
100100
| biddingPlatformId | Integer | Specify the platform in which this ad impression was rendered – 1 – Prebid, 2 – Amazon, 3 – Google, 4 – Open RTB (including your local Prebid server) | 1 | Yes |
101101
| partnerAuctionId | String | Use this when you are running multiple auction solutions across your assets and have a unified identifier for auctions | 3d44542d-xx-4662-xxxx-4xxxx3d8e | No |
102102
| bidderCode | String | Specifies the name of the bidder that won the auction as reported by Prebid and all other bidding platforms | newAppnexus | Yes |
103-
| prebidAuctionId | String | Specifies the identifier of the Prebid auction. Leave empty or undefined if Prebid is not the bidding platform | | |
103+
| prebidAuctionId | String | Specifies the identifier of the Prebid auction. Leave empty or undefined if Prebid is not the bidding platform | 3513ce01-de02-490b-9d87-bfc137697f82 | No |
104104
| cpm | Decimal | Cost per mille of the impression as received from the demand-side auction (without modifications or reductions) | 5.62 | Yes |
105105
| currency | String | Currency of the auction | USD | Yes |
106106
| originalCpm | Decimal | Leave empty or undefined if Prebid is not the bidding platform | 5.5 | No |
@@ -114,5 +114,5 @@ pos: 0 // The following values are defined in the ORTB 2.5 spec
114114
To report the auction win, call the function as follows:
115115

116116
```js
117-
window.intentIqAnalyticsAdapter_[partner_id].reportExternalWin(reportData)
117+
window.intentIqAnalyticsAdapter_[partner_id].reportExternalWin(reportData);
118118
```

dev-docs/bidders/aceex.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,32 @@
11
---
22
layout: bidder
33
title: Aceex
4-
description: Prebid Aceex Bidder Adaptor
4+
description: Prebid Aceex Bidder Adapter
55
biddercode: aceex
6+
gvl_id: 1387
67
tcfeu_supported: false
78
usp_supported: true
89
coppa_supported: true
910
schain_supported: true
10-
userId: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
1111
media_types: banner, video, native
1212
safeframes_ok: true
13-
deals_supported: true
14-
pbjs: false
13+
deals_supported: false
14+
pbjs: true
1515
pbs: true
16+
multiformat_supported: will-bid-on-one
1617
sidebarType: 1
1718
---
1819

1920
### Note
2021

21-
The Example Bidding adapter requires setup before beginning. Please contact us at <tech@aceex.com>
22+
The Example Bidding adapter requires setup before beginning. Please contact us at <tech@aceex.io>
2223

23-
### Bid Params
24+
### Aceex Bid Params
2425

2526
{: .table .table-bordered .table-striped }
2627
| Name | Scope | Description | Example | Type |
2728
|---------------|----------|-----------------------|-----------|-----------|
28-
| `accountid` | required | Endpoint id | `'hash'` | `string` |
29+
| `bidfloor` | required | General bids floor price | `0.2` | `number` |
30+
| `internalKey` | required | Internal hash of publisher | `'1nn3p089Fs87m21'` | `string` |
31+
| `publisherId` | required | Publisher ID | `'2308'` | `string` |
32+
| `trafficType` | required | Configures the mediaType that should be used. Values can be `'banner'`, `'native'` or `'video'` | `'banner'` | `string`|

dev-docs/bidders/adastra.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
layout: bidder
3+
title: Adastra Tech
4+
description: Adastra Tech Bidder Adapter
5+
biddercode: adastra
6+
aliasCode : smarthub
7+
usp_supported: true
8+
coppa_supported: true
9+
schain_supported: true
10+
dchain_supported: true
11+
media_types: banner, video, native
12+
safeframes_ok: true
13+
deals_supported: true
14+
floors_supported: true
15+
fpd_supported: false
16+
pbjs: true
17+
pbs: true
18+
pbs_app_supported: true
19+
multiformat_supported: will-bid-on-any
20+
---
21+
22+
### Prebid.js Bid Params
23+
24+
{: .table .table-bordered .table-striped }
25+
| Name | Scope | Description | Example | Type |
26+
|---------------|----------|---------------------------------|-------------------------------------|-----------|
27+
| `seat` | required | Seat value | `'9Q20EdGxzgWdfPYShScl'` | `string` |
28+
| `token` | required | Token | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |
29+
| `iabCat` | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
30+
| `minBidfloor` | optional | Minimal CPM value | `0.03` | `float` |
31+
| `pos` | optional | The position of the placement on the page, see Open RTB spec v2.5. | `4` | `number` |
32+
33+
### Prebid Server Bid Params
34+
35+
{: .table .table-bordered .table-striped }
36+
| Name | Scope | Description | Example | Type |
37+
|---------------|----------|---------------------|--------------------------------------|----------|
38+
| `seat` | required | Seat value | `'9Q20EdGxzgWdfPYShScl'` | `string` |
39+
| `token` | required | Token | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
layout: bidder
3+
title: Alliance Gravity
4+
description: Prebid Alliance Gravity Bidder Adapter
5+
biddercode: alliance_gravity
6+
tcfeu_supported: true
7+
gvl_id: 501
8+
schain_supported: true
9+
userId: all
10+
media_types: banner, video, audio, native
11+
safeframes_ok: true
12+
deals_supported: true
13+
floors_supported: true
14+
fpd_supported: false
15+
pbjs: true
16+
pbs: false
17+
pbs_app_supported: true
18+
prebid_member: false
19+
multiformat_supported: will-bid-on-one
20+
ortb_blocking_supported: true
21+
privacy_sandbox: no
22+
---
23+
24+
### Bid Params
25+
26+
{: .table .table-bordered .table-striped }
27+
| Name | Scope | Description | Example | Type |
28+
|---------------|----------|-------------------|-----------|----------|
29+
| `srid` | required | Stored Request ID | `'1234'` | `string` |

dev-docs/bidders/beop.md

Lines changed: 41 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ layout: bidder
33
title: BeOp
44
description: BeOp Bidder Adaptor
55
pbjs: true
6-
pbs: false
6+
pbs: true
77
media_types: banner
88
biddercode: beop
99
tcfeu_supported: true
@@ -21,7 +21,7 @@ safeframes_ok: false
2121
deals_supported: false
2222
fpd_supported: true
2323
prebid_member: false
24-
multiformat_supported: will-bid-on-one
24+
multiformat_supported: will-bid-on-any
2525
ortb_blocking_supported: false
2626
privacy_sandbox: no
2727
---
@@ -30,7 +30,9 @@ privacy_sandbox: no
3030

3131
The BeOp bidder adapter requires an `accountId` or `networkId`, which you can retrieve from your BeOp platform dashboard (as a publisher, reseller, or media group). To activate BeOp demand on your account, please contact your account manager or reach out to <publishers@beop.io>.
3232

33-
### Bid Params
33+
BeOp is available in both **Prebid.js** (client-side) and **Prebid Server** (server-side). You can use BeOp via Prebid Server when Prebid.js calls a Prebid Server host, or in server-to-server OpenRTB setups.
34+
35+
### Bid Params (Prebid.js)
3436

3537
{: .table .table-bordered .table-striped }
3638
| Name | Scope | Description | Example | Type |
@@ -40,6 +42,20 @@ The BeOp bidder adapter requires an `accountId` or `networkId`, which you can re
4042
| `currency` | optional | Preferred bidding currency (defaults to `'EUR'`) | `'EUR'` or `'USD'` | `string` |
4143
| `keywords` | optional | Contextual keywords string or array to help target your campaign | `'cars, racing'` or `['cars', 'racing']` | `string/array` |
4244

45+
### Prebid Server
46+
47+
The BeOp Prebid Server adapter supports the same account models as the Prebid.js adapter. Use either **publisher mode** (`pid`) or **network mode** (`nid` + `ntpnid`).
48+
{: .table .table-bordered .table-striped }
49+
| Name | Scope | Description | Example | Type |
50+
|------|--------|-------------|---------|------|
51+
| `pid` | required (publisher) | BeOp publisher ID (same as `accountId` in Prebid.js) | `'5a8af500c9e77c00017e4cad'` | `string` |
52+
| `nid` | required (network) | BeOp network ID (same as `networkId` in Prebid.js). Use together with `ntpnid`. | `'5a8af500c9e77c00017e4cad'` | `string` |
53+
| `ntpnid` | required (network) | Network partner ID (same as `networkPartnerId` in Prebid.js). Use together with `nid`. | `'MY-WEBSITE-123'` | `string` |
54+
55+
Either provide `pid` **or** the pair `nid` + `ntpnid`.
56+
57+
If you host Prebid Server and need to enable the BeOp adapter, add BeOp to your bidders configuration. For endpoint or setup questions, contact <supply>.
58+
4359
### User Syncs
4460

4561
BeOp supports iframe and pixel-based user syncs using the `getUserSyncs` method.
@@ -60,7 +76,7 @@ BeOp supports iframe and pixel-based user syncs using the `getUserSyncs` method.
6076

6177
### Cookie Usage
6278

63-
BeOp sets a first-party cookie `beopid` for frequency capping and user session purposes. This ID is anonymized and used to improve campaign performance, capping logic, and personalization within publisher domains.
79+
BeOp sets a first-party cookie `caudid` (Collective Audience user ID) for frequency capping and user session purposes. The value is a 24-character hex string (ObjectID-style). This ID is anonymized and used to improve campaign performance, capping logic, and personalization within publisher domains.
6480

6581
### First-Party Data Support
6682

@@ -75,6 +91,8 @@ Thanks to BeOp’s unique interactive formats, publishers benefit not only from
7591

7692
### Test Parameters
7793

94+
**Prebid.js**
95+
7896
```js
7997
var adUnits = [
8098
{
@@ -100,3 +118,22 @@ var adUnits = [
100118
},
101119
];
102120
```
121+
122+
**Prebid Server** -
123+
124+
```json
125+
"properties": {
126+
"pid": {
127+
"type": "string",
128+
"description": "BeOp publisher ID"
129+
},
130+
"nid": {
131+
"type": "string",
132+
"description": "BeOp Network ID"
133+
},
134+
"ntpnid": {
135+
"type": "string",
136+
"description": "Network partner ID"
137+
}
138+
},
139+
```

dev-docs/bidders/blasto.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ layout: bidder
33
title: Blasto
44
description: Prebid Blasto Bidder Adaptor
55
biddercode: blasto
6-
tcfeu_supported: false
6+
tcfeu_supported: true
77
usp_supported: true
88
coppa_supported: true
99
schain_supported: true
@@ -17,10 +17,12 @@ sidebarType: 1
1717
floors_supported: true
1818
prebid_member: false
1919
fpd_supported: false
20-
gvl_id: none
20+
gvl_id: 1381
2121
multiformat_supported: will-bid-on-one
2222
ortb_blocking_supported: true
2323
userIds: all
24+
gpp_supported: true
25+
endpoint_compression: false
2426
---
2527

2628
### Note

0 commit comments

Comments
 (0)