PBS Digital Out of Home - initial docs (prebid#4969)

* initial control of DOOH

* dooh page

* linting updates

* linting update

_data/sidebar.yml

@@ -1338,6 +1338,14 @@
   sectionTitle:
   subgroup: 0
 
+- sbSecId: 5
+  title: 'PBS+Digital Out Of Home'
+  link: /prebid-server/use-cases/pbs-dooh.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 0
+
 - sbSecId: 5
   title: 'Hosting Your Own PBS'
   link: /prebid-server/hosting/pbs-hosting.html

prebid-server/overview/prebid-server-overview.md

@@ -8,21 +8,21 @@ sidebarType: 5
 # Prebid Server Overview
 {:.no_toc}
 
-Prebid Server is an open-source solution for server-to-server header bidding. It supports a number of key use cases: [mobile app](/prebid-server/use-cases/pbs-sdk.html), [AMP](/prebid-server/use-cases/pbs-amp.html), [server-side web with Prebid.js](/prebid-server/use-cases/pbs-pbjs.html), and server-side ad inclusion scenarios such as [long-form video](/prebid-server/use-cases/pbs-lfv.html) and audio.
+Prebid Server is an open-source solution for server-to-server header bidding. It supports a number of key use cases: [mobile app](/prebid-server/use-cases/pbs-sdk.html), [AMP](/prebid-server/use-cases/pbs-amp.html), [server-side web with Prebid.js](/prebid-server/use-cases/pbs-pbjs.html), and server-side ad inclusion scenarios such as [CTV](/prebid-server/use-cases/pbs-lfv.html), [Digital Out of Home](/prebid-server/use-cases/pbs-dooh.html) and audio.
 
 ![Prebid Server Architecture](/assets/images/flowcharts/prebid-server/pbs-basic-flow.png){:class="pb-xlg-img"}
 
 Prebid Server is a header bidding server with a growing list of features. At a high level, it works like this:
 
 1. Prebid Server validates and enhances incoming requests
-  - Resolves dynamic stored requests
-  - Enforces privacy regulations
+    1. Resolves dynamic 'stored requests', enriching data server-side
+    1. Enforces privacy regulations
 2. Next, it calls server-side bid adapters
-  - There are 140+ server-side bid adapters available
+    1. There are 180+ server-side bid adapters available
 3. After everyone's responded (or the timeout period has expired), it formulates an appropriate response
-  - Handles currency conversion
-  - Quantizes bids
-  - Caches VAST XML or creatives as needed
+    1. Currency conversion
+    1. Quantizes bids as needed for header bidding targeting
+    1. Caches VAST XML or creatives as needed
 
 It also has optional analytics support.
 
@@ -37,6 +37,7 @@ A high-level overview of Prebid Server, Prebid’s solution for header bidding i
 <div style="padding:56.25% 0 0 0;margin: 1rem 0;position:relative;"><iframe src="https://player.vimeo.com/video/822889941?h=71957861b5&amp;badge=0&amp;autopause=0&amp;player_id=0&amp;app_id=58479" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen style="position:absolute;top:0;left:0;width:100%;height:100%;" title="1.5_Intro-to-PBS_v6"></iframe></div><script src="https://player.vimeo.com/api/player.js"></script>
 
 Further Reading:
+
 - [Transcript of this video overview](/prebid-server/overview/prebid-server-overview-video.html)
 
 ## Where to Run Prebid Server

prebid-server/use-cases/pbs-dooh.md

@@ -0,0 +1,38 @@
+---
+layout: page_v2
+sidebarType: 5
+title: Prebid Server | Use Cases | Digital Out Of Home
+
+---
+
+# Use Case: Prebid Server | Digital Out Of Home
+
+Prebid Server (PBS) supports Digital Out Of Home (DOOH) advertising with this architecture:
+
+## Workflow
+
+Here's a workflow diagramming how this works.
+
+![Prebid Server DOOH](/assets/images/flowcharts/prebid-server/pbs-dooh-flow.png){:class="pb-xlg-img"}
+
+1. DOOH screen makes request for an ad either directly (1a) or through a Content Management System (1b)
+2. The DOOH ad server sends an OpenRTB request to PBS, specifying the screen requirements.
+3. PBS sends a request for bids to selected demand partners by relaying OpenRTB requests to them.
+4. Demand partners return a bid response to PBS. Bid creative assets may be stored in Prebid Cache.
+5. PBS returns the resulting bids to the DOOH ad server.
+6. The ad server retrieves the cached DOOH bid assets as necessary.
+7. The ad server returns the bid to the CMS or device.
+
+## OpenRTB and DOOH
+
+These are the fields in OpenRTB 2.6 that support the Digital Out Of Home use case:
+
+- `dooh` - an object containing many values such as the venue type, publisher, etc.
+- imp.qty - impression quantity
+- imp.dt - estimated impression timestamp
+
+Bidders generally expect these values to be present in the original Prebid Server request.
+
+## Further Reading
+
+- [DOOH in OpenRTB 2.6](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#objectdooh)