Skip to content

Commit

Permalink
dsaControl module docs (prebid#5202)
Browse files Browse the repository at this point in the history
  • Loading branch information
dgirardi authored Mar 29, 2024
1 parent d62a6d7 commit c8ed5f6
Showing 1 changed file with 54 additions and 0 deletions.
54 changes: 54 additions & 0 deletions dev-docs/modules/dsaControl.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
layout: page_v2
title: DSA Control Module
display_name: DSA Control Module
description: Digital Services Act bid validation
page_type: module
module_code : dsaControl
enable_download : true
sidebarType : 1
---

# DSA Control Module
{:.no_toc}

* TOC
{:toc}

## Overview

The ORTB [DSA extension](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/dsa_transparency.md) provides a method for publishers to request DSA transparency information, and for buyers to attach it to their bids.
This module adds validation for DSA information, discarding bids that do not match what was requested.

## Usage

With this module installed, validations are enabled by requesting DSA transparency information. For example:

```javascript
pbjs.setConfig({
ortb2: {
regs: {
ext: {
dsa: {
dsarequired: 2,
pubrender: 0
// ...
}
}
}
}
})
```

This module will then enforce that:

* all bids include DSA information, if required (`dsarequired` is either `2` or `3`);
* all bids that provide DSA information use a compatible rendering method:
* if the request indicates that the publisher can't render (`pubrender` is `0`), then the advertiser must (`adrender` cannot be `0`);
* if it indicates that the publisher will render (`pubrender` is `2`), then the advertiser must not (`adrender` cannot be `1`).

Bids that fail the checks above are rejected with a console warning and removed from the auction.

## Further Reading

* [DSA Transparency](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/dsa_transparency.md)

0 comments on commit c8ed5f6

Please sign in to comment.