diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md index 8aafc724bf..bd9194c521 100644 --- a/dev-docs/bidder-adaptor.md +++ b/dev-docs/bidder-adaptor.md @@ -737,6 +737,21 @@ 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.