From 0a4aff8994462fb85faf24b8572cf7352da11455 Mon Sep 17 00:00:00 2001 From: Godefroi Roussel Date: Tue, 8 Apr 2025 12:51:47 +0200 Subject: [PATCH] Adagio Prebid Server Adapter: Add section Bid Params for Prebid Server and update adagio's metadata --- dev-docs/bidders/adagio.md | 48 +++++++++++++++++++++++++++----------- 1 file changed, 35 insertions(+), 13 deletions(-) diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md index 5d2d04404e..a9b607ceb3 100644 --- a/dev-docs/bidders/adagio.md +++ b/dev-docs/bidders/adagio.md @@ -2,10 +2,13 @@ layout: bidder title: Adagio description: Prebid Adagio Bidder Adaptor +pbs: true +pbs_app_supported: true pbjs: true biddercode: adagio media_types: banner, native, video userIds: all +multiformat_supported: will-bid-on-any floors_supported: true tcfeu_supported: true dsa_supported: true @@ -16,6 +19,10 @@ schain_supported: true gvl_id: 617 prebid_member: true fpd_supported: false +safeframes_ok: true +dchain_supported: false +deals_supported: false +ortb_blocking_supported: false sidebarType: 1 --- @@ -23,7 +30,7 @@ sidebarType: 1 The Adagio bidder adapter requires setup and approval from the Adagio team. Please reach out to [contact@adagio.io](mailto:contact@adagio.io) for more information. -### Configuration +### Configuration for Prebid.js #### User Sync @@ -58,11 +65,12 @@ pbjs.bidderSettings = { } ``` -### Bid Params +#### Bid Params for Prebid.js **Important**: Adagio needs to collect attention data about the ads displayed on a page and must listen to some specifics ad-server events. Please refer to the [Adagio user guide](https://adagioio.notion.site/Adagio-Account-Setup-Guide-fbcd940649224cdfa10393d2f008792e) for details. {: .table .table-bordered .table-striped } + | Name | Scope | Description | Example | Type | | ----------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- | | `organizationId` | required | Id of the Organization. Handed out by Adagio. | `'1010'` | `string` | @@ -73,18 +81,12 @@ pbjs.bidderSettings = { | `category`* | recommended | Category of the content displayed in the page.
- max length: 30
- max distinctives values: 50 | `'sport'` | `string` | | `video` | optional | OpenRTB 2.5 video options object. All options will override ones defined in mediaTypes video.
Mandatory:
- api (your video player must at least support the value 2)
Highly recommended:
- playbackmethod
Not supported:
`protocol`, `companionad`, `companiontype`, `ext` options| `{api: [2], playbackmethod: [6], skip: 1, startdelay: 0}` | `object` | | `native` | optional | Partial OpenRTB Native 1.2 request object. Supported fields are:
- context
- plcmttype | `{context: 1, plcmttype: 2}` | `object` | -| `splitKeyword` | optional | Keyword that can later be used in a split rule targeting to trigger the rule (especially for Direct Seats AB testing) | `'splitrule-one'` | `string` | -| `dataLayer` | optional | A set of arbitrary key-value pairs. This can be used to configure mappings. The keys and values must be strings. | `{placement: 'my-placement', siteid: 'my-siteid'}` | `object` | - -*These parameters will have its accentuated characters converted to their non-accentuated version: `é` => `e` +| `splitKeyword` | optional | Keyword that can later be used in a split rule targeting to trigger the rule (especially for Direct Seats AB testing) | `'splitrule-one'` | `string` | +| `dataLayer` | optional | A set of arbitrary key-value pairs. This can be used to configure mappings. The keys and values must be strings. | `{placement: 'my-placement', siteid: 'my-siteid'}` | `object` | -### Native Custom assets +*These parameters will have their accentuated characters converted to their non-accentuated version: `é` => `e` -| Name | description | -| ------------ | ---------------------------- | -| `adagio_bvw` | Url to handle Measure beacon | - -### First Party Data +#### First Party Data Adagio will use FPD data as fallback for the params below: @@ -93,6 +95,26 @@ Adagio will use FPD data as fallback for the params below: If the FPD value is an array, the 1st value of this array will be used. -### Video outstream +#### Video outstream The AdagioBidAdapter includes a default video player powered by [Blue Billywig](https://www.bluebillywig.com). This default player is used when no renderer is configured for the adUnit. + +### Configuration for Prebid Server + +{: .alert.alert-warning :} +Adagio Prebid Server adapter is currently **available for apps**. Website support is coming soon. Activation requires setup and approval before beginning. Please reach out to your account manager or for more details. + +Adagio supports different regions for the Prebid Server. Please deploy the prebid config in each of your datacenters with the appropriate regional subdomain. + +#### Bid Params for Prebid Server + +{: .table .table-bordered .table-striped } + +| Name | Scope | Description | Example | Type | +|-------------------|--------------------|-------------|---------|------| +| `organizationId` | required | Id of the Organization. Handed out by Adagio. | `'1010'` | `string` | +| `placement`* | required | Refers to the placement of an adunit in a page.
Must not contain any information about the type of device.
- max length: 30
- max distinctives values: 10 | `'ban_atf'` | `string` | +| `pagetype`* | highly recommended | Describes what kind of content will be present in the page.
- max length: 30
- max distinctives values: 50 | `'article'` | `string` | +| `category`* | recommended | Category of the content displayed in the page.
- max length: 30
- max distinctives values: 50 | `'sport'` | `string` | + +*These parameters will have their accentuated characters converted to their non-accentuated version: `é` => `e`