DSA Control Module

Overview

The ORTB DSA extension 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:

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

Parameters

Name Type Description Required Default
dsarequired Integer Indicates if DSA transparency information must be included (0 = not required, 2 = required but advertiser may render, 3 = required and advertiser must render) yes n/a
pubrender Integer Signals publisher rendering capabilities (0 = cannot render, 2 = will render) yes n/a

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