From 7283375bfc8ba41181acbb6dd4ac4f340c7573f6 Mon Sep 17 00:00:00 2001
From: Piotr Jaworski <109736938+piotrj-rtbh@users.noreply.github.com>
Date: Fri, 12 May 2023 22:02:25 +0200
Subject: [PATCH] RTB House Bid Adapter: docs update - `bcat` & `badv` ORTB
 params support (#4522)

* RTBHouse Bid Adapter: adds channel as optional param, updates bidder flags

* RTBHouse Bid Adapter: fixed table descriptions

* RTBHouse Bid Adapter: minor textual changes on bidder docs

* ortb_blocking_supported and description section

* ortb_blocking_supported and description section (#1)

* ortb_blocking_supported and description section

* rephrasing

* ORTB blocking examples update

* Javascript type for examples added

* typo fix

* code fix

* Prebid Server setup by host companies

---------

Co-authored-by: Leandro Otani <leandro.otani@rtbhouse.com>
Co-authored-by: rtbh-lotani <83652735+rtbh-lotani@users.noreply.github.com>
---
 dev-docs/bidders/rtbhouse.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/dev-docs/bidders/rtbhouse.md b/dev-docs/bidders/rtbhouse.md
index 3feec1ce33..60b4ca65bf 100644
--- a/dev-docs/bidders/rtbhouse.md
+++ b/dev-docs/bidders/rtbhouse.md
@@ -13,6 +13,7 @@ media_types: banner, native
 schain_supported: true
 userIds: id5Id, identityLink, pubProvidedId
 pbs_app_supported: true
+ortb_blocking_supported: partial
 sidebarType: 1
 ---
 
@@ -27,6 +28,36 @@ sidebarType: 1
 | `bidfloor`    | optional | Minimal CPM value   | `0.01`        | `float`  |
 | `channel`     | optional | Inventory channel identifier, limited to 50 characters  | `Partner 1 - News`        | `string`  |
 
+#### ORTB Blocking
+RTB House supports blocking advertisers in `badv` and categories in `bcat` parameters.
+The blocked advertisers/categories list has no length limitation, but response timeout is more likely to occur as the number of entries grow.
+Blocked advertisers list (`badv`) is an array of domains as strings.
+Blocked categories list (`bcat`) is an array of IAB categories as strings.
+
+For example:
+##### Globally defined ORTB Blocking:
+```javascript
+pbjs.setConfig({
+  ortb2: {
+    badv: ["domain1.com", "domain2.com"],
+    bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
+  }
+)};
+```
+##### ORTB Blocking specific only to rtbhouse bidder:
+```javascript
+pbjs.setBidderConfig({
+  bidders: ['rtbhouse'],
+  config:{
+    ortb2: {
+      badv: ["domain1.com", "domain2.com"],
+      bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
+    }
+  }
+});
+```
+### Setting up the Prebid Server Adapter
+If you’re a Prebid Server host company looking to enable the RTB House server-side adapter, you'll need to contact prebid@rtbhouse.com. They will guide you through the process. Do not use the default bidder config file as it will require custom partner code to be entered. It will be provided by RTB House.
 
 ### Please note: