From f1324534fef5b2f872819cd2d76481c7f436aa7d Mon Sep 17 00:00:00 2001 From: Jean-Baptiste Pettit Date: Tue, 25 Apr 2023 11:02:57 +0200 Subject: [PATCH 1/4] greenbids RTD provider --- dev-docs/modules/greenbidsRtdProvider.md | 71 ++++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 dev-docs/modules/greenbidsRtdProvider.md diff --git a/dev-docs/modules/greenbidsRtdProvider.md b/dev-docs/modules/greenbidsRtdProvider.md new file mode 100644 index 0000000000..2edef70f49 --- /dev/null +++ b/dev-docs/modules/greenbidsRtdProvider.md @@ -0,0 +1,71 @@ +--- +layout: page_v2 +title: Greenbids Realtime Module +display_name: Greenbids Realtime Module +description: The Greenbids RTD adapter allows to dynamically filter calls to SSP to reduce outgoing call to the programmatics chain, reducing ad serving carbon impact +page_type: module +module_type: rtd +module_code : greenbidsRtdProvider +enable_download : true +vendor_specific: true +sidebarType : 1 +--- + +# Greenbids Realtime Module +{:.no_toc} + +* TOC +{:toc} + +## Overview + +The Greenbids RTD adapter allows to dynamically filter calls to SSP to reduce outgoing call to the programmatics chain, reducing ad serving carbon impact + +## Configuration + +This module is configured as part of the `realTimeData.dataProviders` object. + +{: .table .table-bordered .table-striped } +| Name | Scope | Description | Example | Type | +|------------|----------|----------------------------------------|---------------|----------| +| `name ` | required | Real time data module name | `'greenbidsRtdProvider'` | `string` | +| `waitForIt ` | required (mandatory true value) | Tells prebid auction to wait for the result of this module | `'true'` | `boolean` | +| `params` | required | | | `Object` | +| `params.pbuid` | required | The client site id provided by Greenbids. | `'TEST_FROM_GREENBIDS'` | `string` | +| `params.timeout` | optional (default 200) | Maximum amount of milliseconds allowed for module to finish working (has to be <= to the realTimeData.auctionDelay property) | `200` | `number` | + +#### Example + +```javascript +const greenbidsDataProvider = { + name: 'greenbidsRtdProvider', + waitForIt: true, + params: { + pbuid: 'TEST_FROM_GREENBIDS', + timeout: 200 + } + }; +pbjs.setConfig({ + realTimeData: { + auctionDelay: 200, + dataProviders: [ greenbidsDataProvider ] + } + }); +``` + +## Integration +To install the module, follow these instructions: + +#### Step 1: Contact Greenbids to get a pbuid and account + +#### Step 2: Integrate the Greenbids Analytics Adapter (see prebid Analytics modules) + +#### Step 3: Prepare the base Prebid file + +- Option 1: Use Prebid [Download](/download.html) page to build the prebid package. Ensure that you do check *Greenbids Realtime Module* module + +- Option 2: From the command line, run `gulp build --modules=greenbidsRtdProvider,...` + +#### Step 4: Set configuration + +Enable Greenbids Real Time Module using `pbjs.setConfig`. Example is provided in Configuration section. \ No newline at end of file From ffe348bfb030f5432aafe9644a5c7639026eae1a Mon Sep 17 00:00:00 2001 From: Jean-Baptiste Pettit Date: Thu, 27 Apr 2023 17:44:04 +0200 Subject: [PATCH 2/4] update doc --- dev-docs/modules/greenbidsRtdProvider.md | 1 + 1 file changed, 1 insertion(+) diff --git a/dev-docs/modules/greenbidsRtdProvider.md b/dev-docs/modules/greenbidsRtdProvider.md index 2edef70f49..66f1dca46a 100644 --- a/dev-docs/modules/greenbidsRtdProvider.md +++ b/dev-docs/modules/greenbidsRtdProvider.md @@ -32,6 +32,7 @@ This module is configured as part of the `realTimeData.dataProviders` object. | `waitForIt ` | required (mandatory true value) | Tells prebid auction to wait for the result of this module | `'true'` | `boolean` | | `params` | required | | | `Object` | | `params.pbuid` | required | The client site id provided by Greenbids. | `'TEST_FROM_GREENBIDS'` | `string` | +| `params.targetTPR` | optional (default 0.95) | Target True positive rate for the throttling model | `0.99` | `[0-1]` | | `params.timeout` | optional (default 200) | Maximum amount of milliseconds allowed for module to finish working (has to be <= to the realTimeData.auctionDelay property) | `200` | `number` | #### Example From 19ab1afe1507af08b8648eac4cd46d49be0c574d Mon Sep 17 00:00:00 2001 From: Jean-Baptiste Date: Fri, 28 Apr 2023 11:30:11 +0200 Subject: [PATCH 3/4] code formatting Co-authored-by: Muki Seiler --- dev-docs/modules/greenbidsRtdProvider.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/dev-docs/modules/greenbidsRtdProvider.md b/dev-docs/modules/greenbidsRtdProvider.md index 66f1dca46a..a1c8b299ee 100644 --- a/dev-docs/modules/greenbidsRtdProvider.md +++ b/dev-docs/modules/greenbidsRtdProvider.md @@ -39,13 +39,13 @@ This module is configured as part of the `realTimeData.dataProviders` object. ```javascript const greenbidsDataProvider = { - name: 'greenbidsRtdProvider', - waitForIt: true, - params: { - pbuid: 'TEST_FROM_GREENBIDS', - timeout: 200 - } - }; + name: 'greenbidsRtdProvider', + waitForIt: true, + params: { + pbuid: 'TEST_FROM_GREENBIDS', + timeout: 200 + } +}; pbjs.setConfig({ realTimeData: { auctionDelay: 200, From 27df32387699f2da5b570720f2d6f799f3122791 Mon Sep 17 00:00:00 2001 From: Jean-Baptiste Date: Fri, 28 Apr 2023 11:30:28 +0200 Subject: [PATCH 4/4] Code formatting Co-authored-by: Muki Seiler --- dev-docs/modules/greenbidsRtdProvider.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/dev-docs/modules/greenbidsRtdProvider.md b/dev-docs/modules/greenbidsRtdProvider.md index a1c8b299ee..a30eb51016 100644 --- a/dev-docs/modules/greenbidsRtdProvider.md +++ b/dev-docs/modules/greenbidsRtdProvider.md @@ -47,11 +47,11 @@ const greenbidsDataProvider = { } }; pbjs.setConfig({ - realTimeData: { - auctionDelay: 200, - dataProviders: [ greenbidsDataProvider ] - } - }); + realTimeData: { + auctionDelay: 200, + dataProviders: [greenbidsDataProvider] + } +}); ``` ## Integration