From 074576022b72ccc0806b437c7d533c3ee0c38c55 Mon Sep 17 00:00:00 2001 From: Shiloh Annese Date: Fri, 1 Nov 2024 07:42:25 -0700 Subject: [PATCH] Qortex RTD Provider: update documentation (#5671) * Update Qortex.md Host parameter domain change * Update dev-docs/faq.md indention * update documents for RTD module * add text * resolve missing md table pipe * format * spelling --------- Co-authored-by: rrochwick Co-authored-by: mickannese Co-authored-by: rrochwick <65189775+rrochwick@users.noreply.github.com> --- dev-docs/modules/qortexRtdProvider.md | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/dev-docs/modules/qortexRtdProvider.md b/dev-docs/modules/qortexRtdProvider.md index 189d492345..5d2edf5e58 100644 --- a/dev-docs/modules/qortexRtdProvider.md +++ b/dev-docs/modules/qortexRtdProvider.md @@ -22,12 +22,12 @@ sidebarType : 1 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. +Upon load, if the `Qortex Group Id` and module parameters provided during configuration is active, the Qortex context API will attempt to generate and return a [Content object](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf#page=26) using indexed data from provided page content. 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,..." +gulp build --modules="rtdModule,qortexRtdProvider,..." ``` > `rtdModule` is a required module to use Qortex RTD module. @@ -50,24 +50,20 @@ pbjs.setConfig({ 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' - } + enableBidEnrichment: true, //optional (see below) + tagConfig: { } // optional, please reach out to your account manager for configuration reccommendation } }] } }); ``` -### Paramter Details +### Parameter 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. +|`enableBidEnrichment`| Bool | Indicate whether to opt-in to the features of the RTD module that use our API to enrich bids with first party data for contextuality | No | Enabling this feature will allow this module to interact with the Qortex AI contextuality server for indexing and analysis. Please use caution when adding this module to pages that may contain personal user data or proprietary information. By default, the adapter will disable these features if this is marked `null` or omitted from the configuration parameters.| +|`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. If this parameter is not present, the Qortex integration can still be configured and loaded manually on your page outside of prebid. The RTD module will continue to initialize and operate as normal.|