Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions dev-docs/modules/bidResponseFilter.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ Fields that can be configured:
- `cat` - Banned categories ids
- `adv` - Banned advertiser domains
- `attr` - Banned attributes
- `mediaTypes` - Banned bids of mediaTypes not present on adUnit

### Field configuration object

Expand All @@ -46,7 +47,46 @@ Fields that can be configured:
attr: {
enforce: false,
blockUnknown: false
},
mediaTypes: {
enforce: true,
blockUnknown: true
}
}
});
```

### Media types configuration

The new `mediaTypes` parameter allows you to block bids whose mediaType does not match any of the media types declared at the ad unit level.

### Disabling In-Banner video

To block bids containing In-Banner Video creatives [IAB Creative Attributes 6 and 7, as defined in the AdCOM 1.0 specification](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list_creativeattributes), configure the Bid Response Filter module to reject these responses.

Restrict the ad unit to banner only and declare disallowed creative attributes (battr) directly in the ad unit definition:

```javascript
const adUnit = {
code: 'banner-adunit',
mediaTypes: {
banner: {
battr: [6, 7] // Block In-Banner Video creative attributes
}
},
bids: [ /* bidder configs */ ]
};
```

Enable both the attr and mediaTypes filters in the bidResponseFilter configuration:

```javascript
pbjs.setConfig({
bidResponseFilter: {
attr: { enforce: true },
mediaTypes: {
banner: { enforce: true }
}
}
});
```