From 741d5ad14f864febd72ffd6061df5608faa41ec6 Mon Sep 17 00:00:00 2001 From: erani-n Date: Thu, 30 Jul 2026 02:23:25 +0300 Subject: [PATCH 1/3] Geoedge RTD Provider: document outstream video monitoring --- dev-docs/modules/geoedgeRtdProvider.md | 33 ++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/dev-docs/modules/geoedgeRtdProvider.md b/dev-docs/modules/geoedgeRtdProvider.md index 6f734d926c..a64593e80a 100644 --- a/dev-docs/modules/geoedgeRtdProvider.md +++ b/dev-docs/modules/geoedgeRtdProvider.md @@ -66,6 +66,39 @@ Parameters details: |params.key | String | Customer key |Required, contact Geoedge to get your key | |params.bidders | Object | Bidders to monitor |Optional, list of bidder to include / exclude from monitoring. Omitting this will monitor bids from all bidders. | |params.wap |Boolean |Wrap after preload |Optional, defaults to `false`. Set to `true` if you want to monitor only after the module has preloaded the monitoring client. | +|params.outstream |Boolean |Monitor outstream video |Optional, defaults to `false`. Set to `true` to extend monitoring to outstream video bids. See [Outstream video](#outstream-video) below. | + +## Outstream video + +Video creatives are VAST rather than HTML, so they cannot be wrapped the way display creatives are. +With `outstream: true` the module instead wraps the bid's own `renderer.render` and asks the +monitoring client whether the creative may run: + +```javascript +pbjs.setConfig({ + realTimeData: { + dataProviders: [{ + name: 'geoedge', + params: { + key: '123123', + outstream: true + } + }] + } +}); +``` + +Behavior worth knowing before enabling it: + +* **Render timing.** The monitoring client is preloaded when the module initializes, so by the time a + bid renders it has normally already answered and rendering proceeds immediately. Only a render that + happens before the client is ready waits for the answer, and that wait is capped by a short + deadline. +* **It fails open.** If the client does not load within that deadline, or loads without a verdict for + the bid, the creative renders unmonitored. An ad is never lost because monitoring was unavailable. +* **It only affects bids Prebid renders through the bid's renderer.** Bids carrying a `safeRenderer`, + and bids whose VAST reaches a player straight from targeting or Prebid Cache, are left untouched. +* **Display monitoring is unchanged.** A bid handled by the outstream path is not also HTML-wrapped. ## Example From a77546961a1de097bdbc7025277001679df52b78 Mon Sep 17 00:00:00 2001 From: erani-n Date: Thu, 30 Jul 2026 02:36:57 +0300 Subject: [PATCH 2/3] Pad table cells to satisfy MD060 --- dev-docs/modules/geoedgeRtdProvider.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/dev-docs/modules/geoedgeRtdProvider.md b/dev-docs/modules/geoedgeRtdProvider.md index a64593e80a..2ddc37f943 100644 --- a/dev-docs/modules/geoedgeRtdProvider.md +++ b/dev-docs/modules/geoedgeRtdProvider.md @@ -59,14 +59,14 @@ pbjs.setConfig({ Parameters details: {: .table .table-bordered .table-striped } -|Name |Type |Description |Notes | -| :------------ | :------------ | :------------ |:------------ | -|name | String | Real time data module name |Required, always 'geoedge' | -|params | Object | | | -|params.key | String | Customer key |Required, contact Geoedge to get your key | -|params.bidders | Object | Bidders to monitor |Optional, list of bidder to include / exclude from monitoring. Omitting this will monitor bids from all bidders. | -|params.wap |Boolean |Wrap after preload |Optional, defaults to `false`. Set to `true` if you want to monitor only after the module has preloaded the monitoring client. | -|params.outstream |Boolean |Monitor outstream video |Optional, defaults to `false`. Set to `true` to extend monitoring to outstream video bids. See [Outstream video](#outstream-video) below. | +| Name | Type | Description | Notes | +| :------------ | :------------ | :------------ | :------------ | +| name | String | Real time data module name | Required, always 'geoedge' | +| params | Object | | | +| params.key | String | Customer key | Required, contact Geoedge to get your key | +| params.bidders | Object | Bidders to monitor | Optional, list of bidder to include / exclude from monitoring. Omitting this will monitor bids from all bidders. | +| params.wap | Boolean | Wrap after preload | Optional, defaults to `false`. Set to `true` if you want to monitor only after the module has preloaded the monitoring client. | +| params.outstream | Boolean | Monitor outstream video | Optional, defaults to `false`. Set to `true` to extend monitoring to outstream video bids. See [Outstream video](#outstream-video) below. | ## Outstream video From ee20d6a4d7d7df44449141630fade1a9ffad755a Mon Sep 17 00:00:00 2001 From: erani-n Date: Sun, 2 Aug 2026 14:48:40 +0300 Subject: [PATCH 3/3] Match the client-load naming from Prebid.js#15262 --- dev-docs/modules/geoedgeRtdProvider.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/dev-docs/modules/geoedgeRtdProvider.md b/dev-docs/modules/geoedgeRtdProvider.md index 2ddc37f943..742dc7fe11 100644 --- a/dev-docs/modules/geoedgeRtdProvider.md +++ b/dev-docs/modules/geoedgeRtdProvider.md @@ -65,7 +65,7 @@ Parameters details: | params | Object | | | | params.key | String | Customer key | Required, contact Geoedge to get your key | | params.bidders | Object | Bidders to monitor | Optional, list of bidder to include / exclude from monitoring. Omitting this will monitor bids from all bidders. | -| params.wap | Boolean | Wrap after preload | Optional, defaults to `false`. Set to `true` if you want to monitor only after the module has preloaded the monitoring client. | +| params.wap | Boolean | Wrap after client load | Optional, defaults to `false`. Set to `true` if you want to monitor only after the module has loaded the monitoring client. | | params.outstream | Boolean | Monitor outstream video | Optional, defaults to `false`. Set to `true` to extend monitoring to outstream video bids. See [Outstream video](#outstream-video) below. | ## Outstream video @@ -90,7 +90,7 @@ pbjs.setConfig({ Behavior worth knowing before enabling it: -* **Render timing.** The monitoring client is preloaded when the module initializes, so by the time a +* **Render timing.** The monitoring client is loaded when the module initializes, so by the time a bid renders it has normally already answered and rendering proceeds immediately. Only a render that happens before the client is ready waits for the answer, and that wait is capped by a short deadline.