From 55d9a87afefccde112d9fdf08f5c1a40a4bc3e0c Mon Sep 17 00:00:00 2001
From: PavloMalashnyak <99171840+PavloMalashnyak@users.noreply.github.com>
Date: Thu, 7 Mar 2024 11:56:21 +0200
Subject: [PATCH] Blockthrough Bid Adapter: initial release (#5050)

* Add documentation for BT Bidder Adapter (#1)

* PE-87: add documentation for BT Bidder Adapter

* PE-87: update bid params, add info email

* PE-87: add config section

* PE-87: change pbs value to true

* Fix lint error

* BP-55: Implement Prebid Adapter - Update docs (#2)

* BP-55: Implement Prebid Adapter - clarify bidderConfig params (#3)

* BP-55: add clarification for config variables

* BP-55: remove ab value from doc
---
 dev-docs/bidders/blockthrough.md | 94 ++++++++++++++++++++++++++++++++
 1 file changed, 94 insertions(+)
 create mode 100644 dev-docs/bidders/blockthrough.md

diff --git a/dev-docs/bidders/blockthrough.md b/dev-docs/bidders/blockthrough.md
new file mode 100644
index 0000000000..fbb9f4e845
--- /dev/null
+++ b/dev-docs/bidders/blockthrough.md
@@ -0,0 +1,94 @@
+---
+layout: bidder
+title: Blockthrough
+description: Prebid BT Bidder Adapter
+biddercode: blockthrough
+gvl_id: 815
+usp_supported: true
+coppa_supported: false
+gpp_sids: usp
+schain_supported: true
+dchain_supported: false
+userId: pubProvidedId, id5Id, criteo, sharedId, identityLink, unifiedId, userId
+media_types: banner
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: true
+multiformat_supported: will-not-bid
+ortb_blocking_supported: false
+sidebarType: 1
+---
+
+### Note
+
+The BT Bid Adapter makes requests to the BT Server which supports OpenRTB.
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The BT adapter requires setup and approval from the Blockthrough team. Please reach out to [marketing@blockthrough.com](mailto:marketing@blockthrough.com) for more information.
+
+### Prebid JS
+
+#### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| -------- | -------- | --------------------------- | ------- | --------- |
+| `bidderCode` | required | Bidder configuration. Could configure several bidders this way. | `bidderA: {publisherId: 55555}` | `object` |
+
+#### Bid Config
+
+Make sure to set required orgID, websiteID values received after approval using `pbjs.setBidderConfig`.
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| ----------- | -------- | ---------------------------------- | ------------------ | --------- |
+| `orgID` | required | A unique ID for your organization provided by the Blockthrough team. | `4829301576428910` | `string` |
+| `websiteID` | required | A unique ID for your site provided by the Blockthrough team. | `5654012389765432` | `string` |
+
+#### Example
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ['blockthrough'],
+  config: {
+    ortb2: {
+      site: {
+        ext: {
+          blockthrough: {
+            orgID: '4829301576428910',
+            websiteID: '5654012389765432',
+          },
+        },
+      },
+    },
+  },
+});
+```
+
+#### AdUnits configuration example
+
+```javascript
+var adUnits = [
+  {
+    code: 'banner-div-1',
+    mediaTypes: {
+      banner: {
+        sizes: [[728, 90]],
+      },
+    },
+    bids: [
+      {
+        bidder: 'blockthrough',
+        params: {
+          bidderA: {
+            publisherId: 55555,
+          },
+          bidderB: {
+            zoneId: 12,
+          },
+        },
+      },
+    ],
+  },
+];
+```