From a3c725a1383d107395ca84434ae4c8273c3fa5b1 Mon Sep 17 00:00:00 2001
From: mickannese <mickannese@gmail.com>
Date: Tue, 3 Oct 2023 12:24:32 -0700
Subject: [PATCH] Qortex RealTime Data Module Documentation (#4892)

* Update Qortex.md

Host parameter domain change

* Update dev-docs/faq.md indention

* tested locally for output and placement

* update per review

* resolve lint

---------

Co-authored-by: rrochwick <rob@catapultx.com>
Co-authored-by: Mick <mick@Shiloh.local>
---
 dev-docs/modules/qortexRtdProvider.md | 73 +++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 dev-docs/modules/qortexRtdProvider.md

diff --git a/dev-docs/modules/qortexRtdProvider.md b/dev-docs/modules/qortexRtdProvider.md
new file mode 100644
index 0000000000..189d492345
--- /dev/null
+++ b/dev-docs/modules/qortexRtdProvider.md
@@ -0,0 +1,73 @@
+---
+layout: page_v2
+title: Qortex Realtime Data Module
+display_name: Qortex RTD Module
+description: Appends contextual segments to the bidding object based on the content of a page
+page_type: module
+module_type: rtd
+module_code : qortexRtdProvider
+enable_download : true
+vendor_specific: true
+sidebarType : 1
+---
+
+# Qortex Real-time Data Submodule
+
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The Qortex RTD module appends contextual segments to the bidding object based on the content of a page using the Qortex API.
+
+Upon load, the Qortex context API will analyze the bidder page (video, text, image, etc.) and will return a [Content object](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf#page=26). The module will then merge that object into the appropriate bidders' `ortb2.site.content`, which can be used by prebid adapters that use `site.content` data.
+
+## Build
+
+```SH
+gulp build --modules="rtdModule,qortexRtdProvider,qortexBidAdapter,..."  
+```
+
+> `rtdModule` is a required module to use Qortex RTD module.
+
+## Configuration
+
+Please refer to [Prebid Documentation](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-realTimeData) on RTD module configuration for details on required and optional parameters of `realTimeData`
+
+When configuring Qortex as a data provider, refer to the template below to add the necessary information to ensure the proper connection is made.  
+
+### RTD Module Setup
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        auctionDelay: 1000,
+        dataProviders: [{
+            name: 'qortex',
+            waitForIt: true,
+            params: {
+                groupId: 'ABC123', //required
+                bidders: ['qortex', 'adapter2'], //optional (see below)
+                tagConfig: { // optional, please reach out to your account manager for configuration reccommendation
+                    videoContainer: 'string',
+                    htmlContainer: 'string',
+                    attachToTop: 'string',
+                    esm6Mod: 'string',
+                    continuousLoad: 'string'
+                }
+            }
+        }]
+    }
+});
+```
+
+### Paramter Details
+
+{: .table .table-bordered .table-striped }
+| Name             |Type           | Description                                                         |Required | Notes  |
+| :--------------- | :------------ | :------------------------------------------------------------------ |:---------|:------------ |
+| `groupId`  | String | The Qortex groupId linked to the publisher | Yes | Your account manager can provide this information for you if needed, it is required for any type integration and access to Qortex services |
+| `bidders`  | Array of Strings | this is a list containing the bidder code of the prebid adapters you would like this module to impact | No | If this parameter is included, `ortb2.site.content` will be updated *only* for adapters in this array. If this parameter is omitted, the RTD module will default to updating  `ortb2.site.content` on *all* bid adapters being used on the page|
+| `tagConfig` | Object | The config settings that could be used to initialize the Qortex integration on your page | No | A preconfigured object for this step will be provided to you by the Qortex team. The RTD module will only carry out this process if a valid tagConfig is provided.