From f70708300d30f53a2eb2c214e552b63a71b9f976 Mon Sep 17 00:00:00 2001 From: Marcin Komorski Date: Wed, 1 Oct 2025 13:57:28 +0200 Subject: [PATCH 1/2] Adding onIntervention, browserIntervention --- dev-docs/bidder-adaptor.md | 16 ++++++++++++++++ dev-docs/publisher-api-reference/getEvents.md | 1 + 2 files changed, 17 insertions(+) diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md index 8aafc724bf..32ade966b6 100644 --- a/dev-docs/bidder-adaptor.md +++ b/dev-docs/bidder-adaptor.md @@ -737,6 +737,22 @@ Sample data received by this function: } ``` +### Registering on Intervention + +The onIntervention function will be called when the browser reports an intervention affecting a rendered creative (e.g., Chrome Heavy Ad Intervention or similar reporting APIs). + +#### Signature + +```javascript +function onIntervention({ bid, intervention }) { ... } +``` + +#### Parameters + +1. `bid` — the winning bid object for which the intervention was detected (same shape as in other render callbacks like `onAdRenderSucceeded`). +2. `intervention` — a browser-provided object describing the intervention. In Chromium-based browsers this typically originates from the [ReportingObserver] API with type: 'intervention' and includes a body describing the intervention details. + + ### Adding adapter aliases Use aliases if you want to reuse your adapter using other name for your partner/client, or just a shortcut name. diff --git a/dev-docs/publisher-api-reference/getEvents.md b/dev-docs/publisher-api-reference/getEvents.md index f3751a21f2..1dd6744d91 100644 --- a/dev-docs/publisher-api-reference/getEvents.md +++ b/dev-docs/publisher-api-reference/getEvents.md @@ -47,6 +47,7 @@ The available events are: | bidderError | A bidder responded with an error | Object with the XMLHttpRequest error and the bid request object `{ error, bidderRequest }` | | tcf2Enforcement | There was a TCF2 enforcement action taken | `{ storageBlocked: ['moduleA', 'moduleB'], biddersBlocked: ['moduleB'], analyticsBlocked: ['moduleC'] }` | | bidAccepted | A bid was accepted and is about to be added to auction | Bid response object | +| browserIntervention | The browser reported an intervention affecting a rendered creative (e.g., heavy-ad unload). | `{ bid, adId, intervention }` | The example below shows how these events can be used. From 17e760fded4197a2ef613bd8cf39c5dc5bd007f3 Mon Sep 17 00:00:00 2001 From: Marcin Komorski Date: Wed, 1 Oct 2025 14:03:10 +0200 Subject: [PATCH 2/2] lint --- dev-docs/bidder-adaptor.md | 1 - 1 file changed, 1 deletion(-) diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md index 32ade966b6..bd9194c521 100644 --- a/dev-docs/bidder-adaptor.md +++ b/dev-docs/bidder-adaptor.md @@ -752,7 +752,6 @@ function onIntervention({ bid, intervention }) { ... } 1. `bid` — the winning bid object for which the intervention was detected (same shape as in other render callbacks like `onAdRenderSucceeded`). 2. `intervention` — a browser-provided object describing the intervention. In Chromium-based browsers this typically originates from the [ReportingObserver] API with type: 'intervention' and includes a body describing the intervention details. - ### Adding adapter aliases Use aliases if you want to reuse your adapter using other name for your partner/client, or just a shortcut name.