From a1a5482ed70826910d8f782f1fe6fee01b655377 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 17 Dec 2025 12:45:40 +0100
Subject: [PATCH 01/24] feat: add live display and access examples of Neuwo API
 data to example page

---
 .../gpt/neuwoRtdProvider_example.html         | 75 ++++++++++++++++++-
 1 file changed, 73 insertions(+), 2 deletions(-)

diff --git a/integrationExamples/gpt/neuwoRtdProvider_example.html b/integrationExamples/gpt/neuwoRtdProvider_example.html
index 3d6fef98995..02fb0715884 100644
--- a/integrationExamples/gpt/neuwoRtdProvider_example.html
+++ b/integrationExamples/gpt/neuwoRtdProvider_example.html
@@ -286,14 +286,85 @@ <h3>Div-2</h3>
 
     <div>
         <h2>Neuwo Data in Bid Request</h2>
-        <p>The retrieved data from Neuwo API is injected into the bid request as OpenRTB (ORTB2)`site.content.data` and
-            `user.data`. Full bid request can be inspected in Developer Tools Console under
+        <p>The retrieved data from Neuwo API is injected into the bid request as OpenRTB (ORTB2)
+            <code>site.content.data</code> and
+            <code>user.data</code>. Full bid request can be inspected in Developer Tools Console under
             <code>INFO: NeuwoRTDModule injectIabCategories: post-injection bidsConfig</code>
         </p>
+        <h3>Neuwo Site Content Data</h3>
+        <pre id="neuwo-site-data" style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data.</pre>
+        <h3>Neuwo User Data</h3>
+        <pre id="neuwo-user-data" style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data.</pre>
+    </div>
+
+    <div>
+        <h2>Accessing Neuwo Data in JavaScript</h2>
+        <p>Listen to the <code>bidRequested</code> event to access the enriched ORTB2 data:</p>
+        <pre style="background: #f4f4f4; padding: 10px; overflow-x: auto;">
+pbjs.onEvent('bidRequested', function(bidRequest) {
+    const ortb2 = bidRequest.ortb2;
+    const neuwoSiteData = ortb2?.site?.content?.data?.find(d => d.name === 'www.neuwo.ai');
+    const neuwoUserData = ortb2?.user?.data?.find(d => d.name === 'www.neuwo.ai');
+    console.log('Neuwo data:', { siteContent: neuwoSiteData, user: neuwoUserData });
+});
+        </pre>
+        <p>After clicking "Update", the Neuwo data is stored in the global <code>neuwoData</code> variable. Open
+            Developer Tools Console to see the logged data.</p>
+        <p>For more information about accessing data retrieved from Neuwo API, see <a href="../../modules/neuwoRtdProvider.md">modules/neuwoRtdProvider.md</a>.</p>
     </div>
 
 </body>
 
+<script type="text/javascript">
+    // =====================================================
+    // How to access the Neuwo analysis results outside of Prebid.js
+    // =====================================================
+    var neuwoData = null; // Global variable to store Neuwo data for later use
+
+    pbjs.que.push(function() {
+        pbjs.onEvent('bidRequested', function(bidRequest) {
+            console.log('=== Neuwo Data Access: bidRequested Event ===');
+
+            // The ortb2 data is available directly on the bidRequest
+            if (bidRequest && bidRequest.ortb2) {
+                const ortb2 = bidRequest.ortb2;
+                console.log('Full ORTB2 from bidRequest:', ortb2);
+
+                // Extract Neuwo-specific data (from www.neuwo.ai provider)
+                const siteContentData = ortb2?.site?.content?.data;
+                const userData = ortb2?.user?.data;
+
+                // Filter to get only Neuwo data
+                const neuwoSiteData = siteContentData?.find(d => d.name === 'www.neuwo.ai');
+                const neuwoUserData = userData?.find(d => d.name === 'www.neuwo.ai');
+
+                // Store in global variable for later use
+                neuwoData = {
+                    siteContent: neuwoSiteData,
+                    user: neuwoUserData
+                };
+                console.log('Neuwo data stored in global "neuwoData" variable:', neuwoData);
+
+                // Update display elements on the page
+                const siteDataEl = document.getElementById('neuwo-site-data');
+                const userDataEl = document.getElementById('neuwo-user-data');
+                if (siteDataEl) {
+                    siteDataEl.textContent = neuwoSiteData
+                        ? JSON.stringify(neuwoSiteData, null, 2)
+                        : 'No Neuwo site content data found in response.';
+                }
+                if (userDataEl) {
+                    userDataEl.textContent = neuwoUserData
+                        ? JSON.stringify(neuwoUserData, null, 2)
+                        : 'No Neuwo user data found in response.';
+                }
+            } else {
+                console.warn('No ortb2 data found in bidRequest. This may indicate the RTD module has not enriched the bid request yet.');
+            }
+        });
+    });
+</script>
+
 <script type="text/javascript">
     const helper = document.getElementById('help');
     if (helper) helper.style.display = location.href !== 'http://localhost:9999/integrationExamples/gpt/neuwoRtdProvider_example.html' ? 'block' : 'none';

From 729eb5d155d6306181a2c2cbee8ca902aadc68b2 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 17 Dec 2025 12:45:52 +0100
Subject: [PATCH 02/24] feat: add Prebid.js event timing tests to Neuwo RTD
 example page

---
 .../gpt/neuwoRtdProvider_example.html         | 174 ++++++++++++++++--
 1 file changed, 158 insertions(+), 16 deletions(-)

diff --git a/integrationExamples/gpt/neuwoRtdProvider_example.html b/integrationExamples/gpt/neuwoRtdProvider_example.html
index 02fb0715884..a609240191f 100644
--- a/integrationExamples/gpt/neuwoRtdProvider_example.html
+++ b/integrationExamples/gpt/neuwoRtdProvider_example.html
@@ -310,16 +310,21 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
         </pre>
         <p>After clicking "Update", the Neuwo data is stored in the global <code>neuwoData</code> variable. Open
             Developer Tools Console to see the logged data.</p>
-        <p>For more information about accessing data retrieved from Neuwo API, see <a href="../../modules/neuwoRtdProvider.md">modules/neuwoRtdProvider.md</a>.</p>
+        <p><strong>Note:</strong> Event timing tests for multiple Prebid.js events (auctionInit, bidRequested, beforeBidderHttp, bidResponse, auctionEnd) are available in the page source code but are commented out. To enable them, uncomment the timing test section in the JavaScript code.</p>
+    </div>
+
+    <div>
+        <p>For more information about Neuwo RTD Module configuration and  accessing data retrieved from Neuwo API, see <a href="../../modules/neuwoRtdProvider.md">modules/neuwoRtdProvider.md</a>.</p>
     </div>
 
 </body>
 
 <script type="text/javascript">
     // =====================================================
-    // How to access the Neuwo analysis results outside of Prebid.js
+    // Accessing Neuwo analysis results outside of Prebid.js
+    // Basic example using "bidRequested" event, which occurs early in the auction lifecycle and provides easy access to enriched data
     // =====================================================
-    var neuwoData = null; // Global variable to store Neuwo data for later use
+    let neuwoData = null; // Global variable to store Neuwo data for later use
 
     pbjs.que.push(function() {
         pbjs.onEvent('bidRequested', function(bidRequest) {
@@ -345,24 +350,161 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
                 };
                 console.log('Neuwo data stored in global "neuwoData" variable:', neuwoData);
 
-                // Update display elements on the page
-                const siteDataEl = document.getElementById('neuwo-site-data');
-                const userDataEl = document.getElementById('neuwo-user-data');
-                if (siteDataEl) {
-                    siteDataEl.textContent = neuwoSiteData
-                        ? JSON.stringify(neuwoSiteData, null, 2)
-                        : 'No Neuwo site content data found in response.';
-                }
-                if (userDataEl) {
-                    userDataEl.textContent = neuwoUserData
-                        ? JSON.stringify(neuwoUserData, null, 2)
-                        : 'No Neuwo user data found in response.';
-                }
+                updateDisplayElements(neuwoSiteData, neuwoUserData)
             } else {
                 console.warn('No ortb2 data found in bidRequest. This may indicate the RTD module has not enriched the bid request yet.');
             }
         });
     });
+
+    // Helper to update display elements
+    function updateDisplayElements(neuwoSiteData, neuwoUserData) {
+        const siteDataEl = document.getElementById('neuwo-site-data');
+        const userDataEl = document.getElementById('neuwo-user-data');
+        if (siteDataEl) {
+            siteDataEl.textContent = neuwoSiteData
+                ? JSON.stringify(neuwoSiteData, null, 2)
+                : 'No Neuwo site content data found in response.';
+        }
+        if (userDataEl) {
+            userDataEl.textContent = neuwoUserData
+                ? JSON.stringify(neuwoUserData, null, 2)
+                : 'No Neuwo user data found in response.';
+        }
+    }
+
+    /*
+    // =====================================================
+    // Examples and timing test of selected Prebid.js events
+    // =====================================================
+    let startTime = null;
+    let eventOrder = 0;
+
+    // Reset timing on Update button click
+    window.addEventListener('DOMContentLoaded', function() {
+        const updateButton = document.querySelector('button[onClick="onSettingsUpdate()"]');
+        if (updateButton) {
+            updateButton.addEventListener('click', function() {
+                eventOrder = 0;
+                startTime = performance.now();
+                console.log('=== Timing test reset - awaiting first event after Update click ===');
+            });
+        }
+    });
+
+    // Helper function to extract and log Neuwo data
+    function extractNeuwoData(ortb2, eventName) {
+        const siteContentData = ortb2?.site?.content?.data;
+        const userData = ortb2?.user?.data;
+        const neuwoSiteData = siteContentData?.find(d => d.name === 'www.neuwo.ai');
+        const neuwoUserData = userData?.find(d => d.name === 'www.neuwo.ai');
+
+        const hasData = !!(neuwoSiteData || neuwoUserData);
+        const status = hasData ? 'HAS DATA' : 'NO DATA';
+
+        console.log(`[${eventName}] Status: ${status}`);
+        if (hasData) {
+            console.log(`[${eventName}] Neuwo Site Data:`, neuwoSiteData);
+            console.log(`[${eventName}] Neuwo User Data:`, neuwoUserData);
+        }
+
+        return { neuwoSiteData, neuwoUserData, hasData };
+    }
+
+    pbjs.que.push(function () {
+
+        // =====================================================
+        // EVENT 1: auctionInit
+        // =====================================================
+        pbjs.onEvent('auctionInit', function (auctionData) {
+            eventOrder++;
+            const time = (performance.now() - startTime).toFixed(2);
+            console.log(`\n=== [${eventOrder}] auctionInit (${time}ms) ===`);
+            console.log('auctionData keys:', Object.keys(auctionData));
+            console.log('bidderRequests count:', auctionData.bidderRequests?.length || 0);
+
+            if (auctionData.bidderRequests && auctionData.bidderRequests.length > 0) {
+                const ortb2 = auctionData.bidderRequests[0].ortb2;
+                const result = extractNeuwoData(ortb2, 'auctionInit');
+            } else {
+                console.log('[auctionInit] NO bidderRequests available');
+            }
+        });
+
+        // =====================================================
+        // EVENT 2: bidRequested (fires per bidder)
+        // =====================================================
+        pbjs.onEvent('bidRequested', function (bidderRequest) {
+            eventOrder++;
+            const time = (performance.now() - startTime).toFixed(2);
+            console.log(`\n=== [${eventOrder}] bidRequested (${time}ms) - Bidder: ${bidderRequest.bidderCode} ===`);
+
+            const ortb2 = bidderRequest.ortb2;
+            extractNeuwoData(ortb2, 'bidRequested');
+        });
+
+        // =====================================================
+        // EVENT 3: beforeBidderHttp
+        // =====================================================
+        pbjs.onEvent('beforeBidderHttp', function (bidRequests) {
+            eventOrder++;
+            const time = (performance.now() - startTime).toFixed(2);
+            console.log(`\n=== [${eventOrder}] beforeBidderHttp (${time}ms) ===`);
+            console.log('bidRequests is array:', Array.isArray(bidRequests));
+            console.log('bidRequests count:', bidRequests?.length || 0);
+
+            if (Array.isArray(bidRequests) && bidRequests.length > 0) {
+                const ortb2 = bidRequests[0].ortb2;
+                extractNeuwoData(ortb2, 'beforeBidderHttp');
+            } else if (bidRequests && !Array.isArray(bidRequests)) {
+                // Maybe it's a single object?
+                const ortb2 = bidRequests.ortb2;
+                extractNeuwoData(ortb2, 'beforeBidderHttp');
+            } else {
+                console.log('[beforeBidderHttp] NO bidRequests available');
+            }
+        });
+
+        // =====================================================
+        // EVENT 4: bidResponse
+        // =====================================================
+        pbjs.onEvent('bidResponse', function (bidResponse) {
+            eventOrder++;
+            const time = (performance.now() - startTime).toFixed(2);
+            console.log(`\n=== [${eventOrder}] bidResponse (${time}ms) ===`);
+            console.log('bidResponse keys:', Object.keys(bidResponse));
+
+            // Check if ortb2 is directly on bidResponse
+            if (bidResponse.ortb2) {
+                extractNeuwoData(bidResponse.ortb2, 'bidResponse');
+            } else {
+                console.log('[bidResponse] No direct ortb2 on bidResponse object');
+            }
+        });
+
+        // =====================================================
+        // EVENT 5: auctionEnd
+        // =====================================================
+        pbjs.onEvent('auctionEnd', function (auctionData) {
+            eventOrder++;
+            const time = (performance.now() - startTime).toFixed(2);
+            console.log(`\n=== [${eventOrder}] auctionEnd (${time}ms) ===`);
+            console.log('bidderRequests count:', auctionData.bidderRequests?.length || 0);
+
+            if (auctionData.bidderRequests && auctionData.bidderRequests.length > 0) {
+                const ortb2 = auctionData.bidderRequests[0].ortb2;
+                extractNeuwoData(ortb2, 'auctionEnd');
+            } else {
+                console.log('[auctionEnd] NO bidderRequests available');
+            }
+
+            // Print summary
+            console.log('\n========================================');
+            console.log('EVENT TESTING COMPLETE');
+            console.log('========================================');
+        });
+    });
+    */
 </script>
 
 <script type="text/javascript">

From a6088178845d15431badbedbcc91d497c9ad86f2 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 17 Dec 2025 13:08:34 +0100
Subject: [PATCH 03/24] style: standardize code style in Neuwo RTD example

- Convert single quotes to double quotes for consistency
- Format code with Prettier
---
 .../gpt/neuwoRtdProvider_example.html         | 253 +++++++++---------
 1 file changed, 132 insertions(+), 121 deletions(-)

diff --git a/integrationExamples/gpt/neuwoRtdProvider_example.html b/integrationExamples/gpt/neuwoRtdProvider_example.html
index a609240191f..71aa2dd26eb 100644
--- a/integrationExamples/gpt/neuwoRtdProvider_example.html
+++ b/integrationExamples/gpt/neuwoRtdProvider_example.html
@@ -26,28 +26,28 @@
 
         var adUnits = [
             {
-                code: '/19968336/header-bid-tag-1',
+                code: "/19968336/header-bid-tag-1",
                 mediaTypes: {
                     banner: {
                         sizes: div_1_sizes
                     }
                 },
                 bids: [{
-                    bidder: 'appnexus',
+                    bidder: "appnexus",
                     params: {
                         placementId: 13144370
                     }
                 }]
             },
             {
-                code: '/19968336/header-bid-tag-1',
+                code: "/19968336/header-bid-tag-1",
                 mediaTypes: {
                     banner: {
                         sizes: div_2_sizes
                     }
                 },
                 bids: [{
-                    bidder: 'appnexus',
+                    bidder: "appnexus",
                     params: {
                         placementId: 13144370
                     }
@@ -86,12 +86,12 @@
         // Custom Timeout logic in onSettingsUpdate()
 
         googletag.cmd.push(function () {
-            googletag.defineSlot('/19968336/header-bid-tag-1', div_1_sizes, 'div-1').addService(googletag.pubads());
+            googletag.defineSlot("/19968336/header-bid-tag-1", div_1_sizes, "div-1").addService(googletag.pubads());
             googletag.pubads().enableSingleRequest();
             googletag.enableServices();
         });
         googletag.cmd.push(function () {
-            googletag.defineSlot('/19968336/header-bid-tag-1', div_2_sizes, 'div-2').addService(googletag.pubads());
+            googletag.defineSlot("/19968336/header-bid-tag-1", div_2_sizes, "div-2").addService(googletag.pubads());
             googletag.pubads().enableSingleRequest();
             googletag.enableServices();
         });
@@ -99,45 +99,45 @@
 
         // 3. User Triggered Setup (RTD Module)
         function onSettingsUpdate() {
-            const inputNeuwoApiToken = document.getElementById('neuwo-api-token');
-            const neuwoApiToken = inputNeuwoApiToken ? inputNeuwoApiToken.value : '';
+            const inputNeuwoApiToken = document.getElementById("neuwo-api-token");
+            const neuwoApiToken = inputNeuwoApiToken ? inputNeuwoApiToken.value : "";
             if (!neuwoApiToken) {
-                alert('Please enter your token for Neuwo AI API to the field');
+                alert("Please enter your token for Neuwo AI API to the field");
                 if (inputNeuwoApiToken) inputNeuwoApiToken.focus();
                 return;
             }
 
-            const inputNeuwoApiUrl = document.getElementById('neuwo-api-url');
-            const neuwoApiUrl = inputNeuwoApiUrl ? inputNeuwoApiUrl.value : '';
+            const inputNeuwoApiUrl = document.getElementById("neuwo-api-url");
+            const neuwoApiUrl = inputNeuwoApiUrl ? inputNeuwoApiUrl.value : "";
             if (!neuwoApiUrl) {
-                alert('Please enter Neuwo AI API url to the field');
+                alert("Please enter Neuwo AI API url to the field");
                 if (inputNeuwoApiUrl) inputNeuwoApiUrl.focus();
                 return;
             }
 
-            const inputWebsiteToAnalyseUrl = document.getElementById('website-to-analyse-url');
+            const inputWebsiteToAnalyseUrl = document.getElementById("website-to-analyse-url");
             const websiteToAnalyseUrl = inputWebsiteToAnalyseUrl ? inputWebsiteToAnalyseUrl.value : undefined;
 
-            const inputIabContentTaxonomyVersion = document.getElementById('iab-content-taxonomy-version');
+            const inputIabContentTaxonomyVersion = document.getElementById("iab-content-taxonomy-version");
             const iabContentTaxonomyVersion = inputIabContentTaxonomyVersion ? inputIabContentTaxonomyVersion.value : undefined;
 
             // Cache Option
-            const inputEnableCache = document.getElementById('enable-cache');
+            const inputEnableCache = document.getElementById("enable-cache");
             const enableCache = inputEnableCache ? inputEnableCache.checked : undefined;
 
             // URL Stripping Options
-            const inputStripAllQueryParams = document.getElementById('strip-all-query-params');
+            const inputStripAllQueryParams = document.getElementById("strip-all-query-params");
             const stripAllQueryParams = inputStripAllQueryParams ? inputStripAllQueryParams.checked : undefined;
 
-            const inputStripQueryParamsForDomains = document.getElementById('strip-query-params-for-domains');
-            const stripQueryParamsForDomainsValue = inputStripQueryParamsForDomains ? inputStripQueryParamsForDomains.value.trim() : '';
-            const stripQueryParamsForDomains = stripQueryParamsForDomainsValue ? stripQueryParamsForDomainsValue.split(',').map(d => d.trim()).filter(d => d) : undefined;
+            const inputStripQueryParamsForDomains = document.getElementById("strip-query-params-for-domains");
+            const stripQueryParamsForDomainsValue = inputStripQueryParamsForDomains ? inputStripQueryParamsForDomains.value.trim() : "";
+            const stripQueryParamsForDomains = stripQueryParamsForDomainsValue ? stripQueryParamsForDomainsValue.split(",").map(d => d.trim()).filter(d => d) : undefined;
 
-            const inputStripQueryParams = document.getElementById('strip-query-params');
-            const stripQueryParamsValue = inputStripQueryParams ? inputStripQueryParams.value.trim() : '';
-            const stripQueryParams = stripQueryParamsValue ? stripQueryParamsValue.split(',').map(p => p.trim()).filter(p => p) : undefined;
+            const inputStripQueryParams = document.getElementById("strip-query-params");
+            const stripQueryParamsValue = inputStripQueryParams ? inputStripQueryParams.value.trim() : "";
+            const stripQueryParams = stripQueryParamsValue ? stripQueryParamsValue.split(",").map(p => p.trim()).filter(p => p) : undefined;
 
-            const inputStripFragments = document.getElementById('strip-fragments');
+            const inputStripFragments = document.getElementById("strip-fragments");
             const stripFragments = inputStripFragments ? inputStripFragments.checked : undefined;
 
             pbjs.que.push(function () {
@@ -185,7 +185,7 @@
     <h1>Basic Prebid.js Example using Neuwo Rtd Provider</h1>
 
     <div id="help" style="padding: 1em; border: 2px solid gray; background-color: #ed4f4f; white-space: pre-line;">
-        Looks like you're not following the testing environment setup, try accessing
+        Looks like you"re not following the testing environment setup, try accessing
         <a href="http://localhost:9999/integrationExamples/gpt/neuwoRtdProvider_example.html">
             http://localhost:9999/integrationExamples/gpt/neuwoRtdProvider_example.html
         </a>
@@ -215,12 +215,14 @@ <h2>Neuwo Rtd Provider Configuration</h2>
             <input type="text" placeholder="Neuwo API Token" id="neuwo-api-token" style="width: 400px;" />
         </div>
         <div style="margin-bottom: 10px;">
-            <input type="text" placeholder="URL for website to analyse" id="website-to-analyse-url" style="width: 400px;" />
+            <input type="text" placeholder="URL for website to analyse" id="website-to-analyse-url"
+                style="width: 400px;" />
         </div>
 
         <h3>IAB Content Taxonomy Options</h3>
         <div style="margin-bottom: 10px;">
-            <input type="text" placeholder="IAB Content Taxonomy Version (default 3.0)" id="iab-content-taxonomy-version" style="width: 400px;" />
+            <input type="text" placeholder="IAB Content Taxonomy Version (default 3.0)"
+                id="iab-content-taxonomy-version" style="width: 400px;" />
         </div>
 
         <h3>Cache Options</h3>
@@ -239,10 +241,13 @@ <h3>URL Cleaning Options</h3>
             </label>
         </div>
         <div style="margin-bottom: 5px;">
-            <input type="text" placeholder="Strip query params for domains (comma-separated, e.g., example.com, test.com)" id="strip-query-params-for-domains" style="width: 400px;" />
+            <input type="text"
+                placeholder="Strip query params for domains (comma-separated, e.g., example.com, test.com)"
+                id="strip-query-params-for-domains" style="width: 400px;" />
         </div>
         <div style="margin-bottom: 5px;">
-            <input type="text" placeholder="Strip specific query params (comma-separated, e.g., utm_source, fbclid)" id="strip-query-params" style="width: 400px;" />
+            <input type="text" placeholder="Strip specific query params (comma-separated, e.g., utm_source, fbclid)"
+                id="strip-query-params" style="width: 400px;" />
         </div>
         <div style="margin-bottom: 10px;">
             <label>
@@ -259,10 +264,10 @@ <h2>Ad Examples</h2>
 
         <div>
             <h3>Div-1</h3>
-            <div id='div-1'>
-                <script type='text/javascript'>
+            <div id="div-1">
+                <script type="text/javascript">
                     googletag.cmd.push(function () {
-                        googletag.display('div-1');
+                        googletag.display("div-1");
                     });
                 </script>
                 Ad spot div-1: This content will be replaced by prebid.js and/or related components once you click
@@ -272,10 +277,10 @@ <h3>Div-1</h3>
 
         <div>
             <h3>Div-2</h3>
-            <div id='div-2'>
-                <script type='text/javascript'>
+            <div id="div-2">
+                <script type="text/javascript">
                     googletag.cmd.push(function () {
-                        googletag.display('div-2');
+                        googletag.display("div-2");
                     });
                 </script>
                 Ad spot div-2: This content will be replaced by prebid.js and/or related components once you click
@@ -292,29 +297,34 @@ <h2>Neuwo Data in Bid Request</h2>
             <code>INFO: NeuwoRTDModule injectIabCategories: post-injection bidsConfig</code>
         </p>
         <h3>Neuwo Site Content Data</h3>
-        <pre id="neuwo-site-data" style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data.</pre>
+        <pre id="neuwo-site-data"
+            style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data.</pre>
         <h3>Neuwo User Data</h3>
-        <pre id="neuwo-user-data" style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data.</pre>
+        <pre id="neuwo-user-data"
+            style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data.</pre>
     </div>
 
     <div>
         <h2>Accessing Neuwo Data in JavaScript</h2>
         <p>Listen to the <code>bidRequested</code> event to access the enriched ORTB2 data:</p>
         <pre style="background: #f4f4f4; padding: 10px; overflow-x: auto;">
-pbjs.onEvent('bidRequested', function(bidRequest) {
+pbjs.onEvent("bidRequested", function(bidRequest) {
     const ortb2 = bidRequest.ortb2;
-    const neuwoSiteData = ortb2?.site?.content?.data?.find(d => d.name === 'www.neuwo.ai');
-    const neuwoUserData = ortb2?.user?.data?.find(d => d.name === 'www.neuwo.ai');
-    console.log('Neuwo data:', { siteContent: neuwoSiteData, user: neuwoUserData });
+    const neuwoSiteData = ortb2?.site?.content?.data?.find(d => d.name === "www.neuwo.ai");
+    const neuwoUserData = ortb2?.user?.data?.find(d => d.name === "www.neuwo.ai");
+    console.log("Neuwo data:", { siteContent: neuwoSiteData, user: neuwoUserData });
 });
         </pre>
         <p>After clicking "Update", the Neuwo data is stored in the global <code>neuwoData</code> variable. Open
             Developer Tools Console to see the logged data.</p>
-        <p><strong>Note:</strong> Event timing tests for multiple Prebid.js events (auctionInit, bidRequested, beforeBidderHttp, bidResponse, auctionEnd) are available in the page source code but are commented out. To enable them, uncomment the timing test section in the JavaScript code.</p>
+        <p><strong>Note:</strong> Event timing tests for multiple Prebid.js events (auctionInit, bidRequested,
+            beforeBidderHttp, bidResponse, auctionEnd) are available in the page source code but are commented out. To
+            enable them, uncomment the timing test section in the JavaScript code.</p>
     </div>
 
     <div>
-        <p>For more information about Neuwo RTD Module configuration and  accessing data retrieved from Neuwo API, see <a href="../../modules/neuwoRtdProvider.md">modules/neuwoRtdProvider.md</a>.</p>
+        <p>For more information about Neuwo RTD Module configuration and accessing data retrieved from Neuwo API, see <a
+                href="../../modules/neuwoRtdProvider.md">modules/neuwoRtdProvider.md</a>.</p>
     </div>
 
 </body>
@@ -326,50 +336,50 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
     // =====================================================
     let neuwoData = null; // Global variable to store Neuwo data for later use
 
-    pbjs.que.push(function() {
-        pbjs.onEvent('bidRequested', function(bidRequest) {
-            console.log('=== Neuwo Data Access: bidRequested Event ===');
+    pbjs.que.push(function () {
+        pbjs.onEvent("bidRequested", function (bidRequest) {
+            console.log("=== Neuwo Data Access: bidRequested Event ===");
 
             // The ortb2 data is available directly on the bidRequest
             if (bidRequest && bidRequest.ortb2) {
                 const ortb2 = bidRequest.ortb2;
-                console.log('Full ORTB2 from bidRequest:', ortb2);
+                console.log("Full ORTB2 from bidRequest:", ortb2);
 
                 // Extract Neuwo-specific data (from www.neuwo.ai provider)
                 const siteContentData = ortb2?.site?.content?.data;
                 const userData = ortb2?.user?.data;
 
                 // Filter to get only Neuwo data
-                const neuwoSiteData = siteContentData?.find(d => d.name === 'www.neuwo.ai');
-                const neuwoUserData = userData?.find(d => d.name === 'www.neuwo.ai');
+                const neuwoSiteData = siteContentData?.find(d => d.name === "www.neuwo.ai");
+                const neuwoUserData = userData?.find(d => d.name === "www.neuwo.ai");
 
                 // Store in global variable for later use
                 neuwoData = {
                     siteContent: neuwoSiteData,
                     user: neuwoUserData
                 };
-                console.log('Neuwo data stored in global "neuwoData" variable:', neuwoData);
+                console.log("Neuwo data stored in global \"neuwoData\" variable:", neuwoData);
 
                 updateDisplayElements(neuwoSiteData, neuwoUserData)
             } else {
-                console.warn('No ortb2 data found in bidRequest. This may indicate the RTD module has not enriched the bid request yet.');
+                console.warn("No ortb2 data found in bidRequest. This may indicate the RTD module has not enriched the bid request yet.");
             }
         });
     });
 
     // Helper to update display elements
     function updateDisplayElements(neuwoSiteData, neuwoUserData) {
-        const siteDataEl = document.getElementById('neuwo-site-data');
-        const userDataEl = document.getElementById('neuwo-user-data');
+        const siteDataEl = document.getElementById("neuwo-site-data");
+        const userDataEl = document.getElementById("neuwo-user-data");
         if (siteDataEl) {
             siteDataEl.textContent = neuwoSiteData
                 ? JSON.stringify(neuwoSiteData, null, 2)
-                : 'No Neuwo site content data found in response.';
+                : "No Neuwo site content data found in response.";
         }
         if (userDataEl) {
             userDataEl.textContent = neuwoUserData
                 ? JSON.stringify(neuwoUserData, null, 2)
-                : 'No Neuwo user data found in response.';
+                : "No Neuwo user data found in response.";
         }
     }
 
@@ -381,13 +391,13 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
     let eventOrder = 0;
 
     // Reset timing on Update button click
-    window.addEventListener('DOMContentLoaded', function() {
-        const updateButton = document.querySelector('button[onClick="onSettingsUpdate()"]');
+    window.addEventListener("DOMContentLoaded", function () {
+        const updateButton = document.querySelector("button[onClick=\"onSettingsUpdate()\"]");
         if (updateButton) {
-            updateButton.addEventListener('click', function() {
+            updateButton.addEventListener("click", function () {
                 eventOrder = 0;
                 startTime = performance.now();
-                console.log('=== Timing test reset - awaiting first event after Update click ===');
+                console.log("=== Timing test reset - awaiting first event after Update click ===");
             });
         }
     });
@@ -396,11 +406,11 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
     function extractNeuwoData(ortb2, eventName) {
         const siteContentData = ortb2?.site?.content?.data;
         const userData = ortb2?.user?.data;
-        const neuwoSiteData = siteContentData?.find(d => d.name === 'www.neuwo.ai');
-        const neuwoUserData = userData?.find(d => d.name === 'www.neuwo.ai');
+        const neuwoSiteData = siteContentData?.find(d => d.name === "www.neuwo.ai");
+        const neuwoUserData = userData?.find(d => d.name === "www.neuwo.ai");
 
         const hasData = !!(neuwoSiteData || neuwoUserData);
-        const status = hasData ? 'HAS DATA' : 'NO DATA';
+        const status = hasData ? "HAS DATA" : "NO DATA";
 
         console.log(`[${eventName}] Status: ${status}`);
         if (hasData) {
@@ -416,165 +426,166 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
         // =====================================================
         // EVENT 1: auctionInit
         // =====================================================
-        pbjs.onEvent('auctionInit', function (auctionData) {
+        pbjs.onEvent("auctionInit", function (auctionData) {
             eventOrder++;
             const time = (performance.now() - startTime).toFixed(2);
             console.log(`\n=== [${eventOrder}] auctionInit (${time}ms) ===`);
-            console.log('auctionData keys:', Object.keys(auctionData));
-            console.log('bidderRequests count:', auctionData.bidderRequests?.length || 0);
+            console.log("auctionData keys:", Object.keys(auctionData));
+            console.log("bidderRequests count:", auctionData.bidderRequests?.length || 0);
 
             if (auctionData.bidderRequests && auctionData.bidderRequests.length > 0) {
                 const ortb2 = auctionData.bidderRequests[0].ortb2;
-                const result = extractNeuwoData(ortb2, 'auctionInit');
+                const result = extractNeuwoData(ortb2, "auctionInit");
             } else {
-                console.log('[auctionInit] NO bidderRequests available');
+                console.log("[auctionInit] NO bidderRequests available");
             }
         });
 
         // =====================================================
         // EVENT 2: bidRequested (fires per bidder)
         // =====================================================
-        pbjs.onEvent('bidRequested', function (bidderRequest) {
+        pbjs.onEvent("bidRequested", function (bidderRequest) {
             eventOrder++;
             const time = (performance.now() - startTime).toFixed(2);
             console.log(`\n=== [${eventOrder}] bidRequested (${time}ms) - Bidder: ${bidderRequest.bidderCode} ===`);
 
             const ortb2 = bidderRequest.ortb2;
-            extractNeuwoData(ortb2, 'bidRequested');
+            extractNeuwoData(ortb2, "bidRequested");
         });
 
         // =====================================================
         // EVENT 3: beforeBidderHttp
         // =====================================================
-        pbjs.onEvent('beforeBidderHttp', function (bidRequests) {
+        pbjs.onEvent("beforeBidderHttp", function (bidRequests) {
             eventOrder++;
             const time = (performance.now() - startTime).toFixed(2);
             console.log(`\n=== [${eventOrder}] beforeBidderHttp (${time}ms) ===`);
-            console.log('bidRequests is array:', Array.isArray(bidRequests));
-            console.log('bidRequests count:', bidRequests?.length || 0);
+            console.log("bidRequests is array:", Array.isArray(bidRequests));
+            console.log("bidRequests count:", bidRequests?.length || 0);
 
             if (Array.isArray(bidRequests) && bidRequests.length > 0) {
                 const ortb2 = bidRequests[0].ortb2;
-                extractNeuwoData(ortb2, 'beforeBidderHttp');
+                extractNeuwoData(ortb2, "beforeBidderHttp");
             } else if (bidRequests && !Array.isArray(bidRequests)) {
-                // Maybe it's a single object?
+                // Maybe it"s a single object?
                 const ortb2 = bidRequests.ortb2;
-                extractNeuwoData(ortb2, 'beforeBidderHttp');
+                extractNeuwoData(ortb2, "beforeBidderHttp");
             } else {
-                console.log('[beforeBidderHttp] NO bidRequests available');
+                console.log("[beforeBidderHttp] NO bidRequests available");
             }
         });
 
         // =====================================================
         // EVENT 4: bidResponse
         // =====================================================
-        pbjs.onEvent('bidResponse', function (bidResponse) {
+        pbjs.onEvent("bidResponse", function (bidResponse) {
             eventOrder++;
             const time = (performance.now() - startTime).toFixed(2);
             console.log(`\n=== [${eventOrder}] bidResponse (${time}ms) ===`);
-            console.log('bidResponse keys:', Object.keys(bidResponse));
+            console.log("bidResponse keys:", Object.keys(bidResponse));
 
             // Check if ortb2 is directly on bidResponse
             if (bidResponse.ortb2) {
-                extractNeuwoData(bidResponse.ortb2, 'bidResponse');
+                extractNeuwoData(bidResponse.ortb2, "bidResponse");
             } else {
-                console.log('[bidResponse] No direct ortb2 on bidResponse object');
+                console.log("[bidResponse] No direct ortb2 on bidResponse object");
             }
         });
 
         // =====================================================
         // EVENT 5: auctionEnd
         // =====================================================
-        pbjs.onEvent('auctionEnd', function (auctionData) {
+        pbjs.onEvent("auctionEnd", function (auctionData) {
             eventOrder++;
             const time = (performance.now() - startTime).toFixed(2);
             console.log(`\n=== [${eventOrder}] auctionEnd (${time}ms) ===`);
-            console.log('bidderRequests count:', auctionData.bidderRequests?.length || 0);
+            console.log("bidderRequests count:", auctionData.bidderRequests?.length || 0);
 
             if (auctionData.bidderRequests && auctionData.bidderRequests.length > 0) {
                 const ortb2 = auctionData.bidderRequests[0].ortb2;
-                extractNeuwoData(ortb2, 'auctionEnd');
+                extractNeuwoData(ortb2, "auctionEnd");
             } else {
-                console.log('[auctionEnd] NO bidderRequests available');
+                console.log("[auctionEnd] NO bidderRequests available");
             }
 
             // Print summary
-            console.log('\n========================================');
-            console.log('EVENT TESTING COMPLETE');
-            console.log('========================================');
+            console.log("\n========================================");
+            console.log("EVENT TESTING COMPLETE");
+            console.log("========================================");
         });
     });
     */
+
 </script>
 
 <script type="text/javascript">
-    const helper = document.getElementById('help');
-    if (helper) helper.style.display = location.href !== 'http://localhost:9999/integrationExamples/gpt/neuwoRtdProvider_example.html' ? 'block' : 'none';
+    const helper = document.getElementById("help");
+    if (helper) helper.style.display = location.href !== "http://localhost:9999/integrationExamples/gpt/neuwoRtdProvider_example.html" ? "block" : "none";
 </script>
 
 <script type="text/javascript">
     // LocalStorage persistence for form values
     function saveConfigToLocalStorage() {
         const config = {
-            neuwoApiToken: document.getElementById('neuwo-api-token')?.value || '',
-            neuwoApiUrl: document.getElementById('neuwo-api-url')?.value || '',
-            websiteToAnalyseUrl: document.getElementById('website-to-analyse-url')?.value || '',
-            iabContentTaxonomyVersion: document.getElementById('iab-content-taxonomy-version')?.value || '',
-            enableCache: document.getElementById('enable-cache')?.checked !== false,
-            stripAllQueryParams: document.getElementById('strip-all-query-params')?.checked || false,
-            stripQueryParamsForDomains: document.getElementById('strip-query-params-for-domains')?.value || '',
-            stripQueryParams: document.getElementById('strip-query-params')?.value || '',
-            stripFragments: document.getElementById('strip-fragments')?.checked || false
+            neuwoApiToken: document.getElementById("neuwo-api-token")?.value || "",
+            neuwoApiUrl: document.getElementById("neuwo-api-url")?.value || "",
+            websiteToAnalyseUrl: document.getElementById("website-to-analyse-url")?.value || "",
+            iabContentTaxonomyVersion: document.getElementById("iab-content-taxonomy-version")?.value || "",
+            enableCache: document.getElementById("enable-cache")?.checked !== false,
+            stripAllQueryParams: document.getElementById("strip-all-query-params")?.checked || false,
+            stripQueryParamsForDomains: document.getElementById("strip-query-params-for-domains")?.value || "",
+            stripQueryParams: document.getElementById("strip-query-params")?.value || "",
+            stripFragments: document.getElementById("strip-fragments")?.checked || false
         };
-        localStorage.setItem('neuwoRtdConfig', JSON.stringify(config));
+        localStorage.setItem("neuwoRtdConfig", JSON.stringify(config));
     }
 
     function loadConfigFromLocalStorage() {
-        const savedConfig = localStorage.getItem('neuwoRtdConfig');
+        const savedConfig = localStorage.getItem("neuwoRtdConfig");
         if (!savedConfig) return;
 
         try {
             const config = JSON.parse(savedConfig);
 
             // Restore text inputs
-            if (config.neuwoApiToken) document.getElementById('neuwo-api-token').value = config.neuwoApiToken;
-            if (config.neuwoApiUrl) document.getElementById('neuwo-api-url').value = config.neuwoApiUrl;
-            if (config.websiteToAnalyseUrl) document.getElementById('website-to-analyse-url').value = config.websiteToAnalyseUrl;
-            if (config.iabContentTaxonomyVersion) document.getElementById('iab-content-taxonomy-version').value = config.iabContentTaxonomyVersion;
-            if (config.stripQueryParamsForDomains) document.getElementById('strip-query-params-for-domains').value = config.stripQueryParamsForDomains;
-            if (config.stripQueryParams) document.getElementById('strip-query-params').value = config.stripQueryParams;
+            if (config.neuwoApiToken) document.getElementById("neuwo-api-token").value = config.neuwoApiToken;
+            if (config.neuwoApiUrl) document.getElementById("neuwo-api-url").value = config.neuwoApiUrl;
+            if (config.websiteToAnalyseUrl) document.getElementById("website-to-analyse-url").value = config.websiteToAnalyseUrl;
+            if (config.iabContentTaxonomyVersion) document.getElementById("iab-content-taxonomy-version").value = config.iabContentTaxonomyVersion;
+            if (config.stripQueryParamsForDomains) document.getElementById("strip-query-params-for-domains").value = config.stripQueryParamsForDomains;
+            if (config.stripQueryParams) document.getElementById("strip-query-params").value = config.stripQueryParams;
 
             // Restore checkboxes
-            document.getElementById('enable-cache').checked = config.enableCache !== false;
-            document.getElementById('strip-all-query-params').checked = config.stripAllQueryParams;
-            document.getElementById('strip-fragments').checked = config.stripFragments;
+            document.getElementById("enable-cache").checked = config.enableCache !== false;
+            document.getElementById("strip-all-query-params").checked = config.stripAllQueryParams;
+            document.getElementById("strip-fragments").checked = config.stripFragments;
         } catch (e) {
-            console.error('Error loading saved config:', e);
+            console.error("Error loading saved config:", e);
         }
     }
 
     // Attach event listeners to save on input change
     function attachInputListeners() {
         const inputIds = [
-            'neuwo-api-token',
-            'neuwo-api-url',
-            'website-to-analyse-url',
-            'iab-content-taxonomy-version',
-            'strip-query-params-for-domains',
-            'strip-query-params'
+            "neuwo-api-token",
+            "neuwo-api-url",
+            "website-to-analyse-url",
+            "iab-content-taxonomy-version",
+            "strip-query-params-for-domains",
+            "strip-query-params"
         ];
 
         const checkboxIds = [
-            'enable-cache',
-            'strip-all-query-params',
-            'strip-fragments'
+            "enable-cache",
+            "strip-all-query-params",
+            "strip-fragments"
         ];
 
         // Save on text input change
         inputIds.forEach(id => {
             const element = document.getElementById(id);
             if (element) {
-                element.addEventListener('input', saveConfigToLocalStorage);
+                element.addEventListener("input", saveConfigToLocalStorage);
             }
         });
 
@@ -582,13 +593,13 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
         checkboxIds.forEach(id => {
             const element = document.getElementById(id);
             if (element) {
-                element.addEventListener('change', saveConfigToLocalStorage);
+                element.addEventListener("change", saveConfigToLocalStorage);
             }
         });
     }
 
     // Load config on page load
-    window.addEventListener('DOMContentLoaded', function() {
+    window.addEventListener("DOMContentLoaded", function () {
         loadConfigFromLocalStorage();
         attachInputListeners();
     });

From 5be6d16997206ae918c23130e1d8ff2436417fd2 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 17 Dec 2025 14:13:46 +0100
Subject: [PATCH 04/24] docs: add guide for accessing Neuwo RTD data outside
 Prebid.js

---
 modules/neuwoRtdProvider.md | 45 +++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index 804130be1e6..8698f049655 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -147,6 +147,51 @@ pbjs.setConfig({
 });
 ```
 
+## Accessing Neuwo Data Outside Prebid.js
+
+The Neuwo RTD module enriches bid requests with contextual data that can be accessed in application code for analytics, targeting, integration with Google Ad Manager as [Publisher Provided Signals (PPS)](https://support.google.com/admanager/answer/15287325) or other purposes. The enriched data is available through Prebid.js events.
+
+### Example of Using the `bidRequested` Event
+
+Listen to the `bidRequested` event to access the enriched ORTB2 data. This event fires early in the auction lifecycle and provides direct access to the Neuwo data:
+
+```javascript
+pbjs.que.push(function() {
+  pbjs.onEvent('bidRequested', function(bidRequest) {
+    // The ortb2 data is available directly on the bidRequest
+    const ortb2 = bidRequest.ortb2;
+
+    // Extract Neuwo-specific data (from www.neuwo.ai provider)
+    const neuwoSiteData = ortb2?.site?.content?.data?.find(d => d.name === 'www.neuwo.ai');
+    const neuwoUserData = ortb2?.user?.data?.find(d => d.name === 'www.neuwo.ai');
+
+    // Use the data in the application
+    console.log('Neuwo Site Content:', neuwoSiteData);
+    console.log('Neuwo User Data:', neuwoUserData);
+
+    // Example: Store in a global variable for later use
+    window.neuwoData = {
+      siteContent: neuwoSiteData,
+      user: neuwoUserData
+    };
+  });
+});
+```
+
+### Other Prebid.js Events
+
+The Neuwo data is also available in other Prebid.js events:
+
+| Order | Event              | Fires Once Per | Data Location                        |
+| :---- | :----------------- | :------------- | :----------------------------------- |
+| 1     | `auctionInit`      | Auction        | `auctionData.bidderRequests[].ortb2` |
+| 2     | `bidRequested`     | Bidder         | `bidRequest.ortb2`                   |
+| 3     | `beforeBidderHttp` | Bidder         | `bidRequests[].ortb2`                |
+| 4     | `bidResponse`      | Bidder         | `bidResponse.ortb2`                  |
+| 5     | `auctionEnd`       | Auction        | `auctionData.bidderRequests[].ortb2` |
+
+For more information on Prebid.js events, see the [Prebid.js Event API documentation](https://docs.prebid.org/dev-docs/publisher-api-reference/getEvents.html).
+
 ## Local Development
 
 Install the exact versions of packages specified in the lockfile:

From 25dc7ca15a499641ed2dd2f1bdb30cd8a1bd20b0 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Thu, 18 Dec 2025 11:54:37 +0100
Subject: [PATCH 05/24] feat: add concurrent bid request handling to Neuwo RTD
 Module

---
 modules/neuwoRtdProvider.js | 77 +++++++++++++++++++++++++------------
 1 file changed, 53 insertions(+), 24 deletions(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index 3255547aa47..2f402886c5d 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -25,13 +25,16 @@ export const DATA_PROVIDER = "www.neuwo.ai";
 
 // Cached API response to avoid redundant requests.
 let globalCachedResponse;
+// In-flight request promise to prevent duplicate API calls during the same request cycle.
+let pendingRequest;
 
 /**
- * Clears the cached API response. Primarily used for testing.
+ * Clears the cached API response and pending request. Primarily used for testing.
  * @private
  */
 export function clearCache() {
   globalCachedResponse = undefined;
+  pendingRequest = undefined;
 }
 
 // Maps the IAB Content Taxonomy version string to the corresponding segtax ID.
@@ -113,34 +116,60 @@ export function getBidRequestData(reqBidsConfigObj, callback, config, userConsen
   const neuwoApiUrlFull =
     neuwoApiUrl + joiner + ["token=" + neuwoApiToken, "url=" + pageUrl].join("&");
 
-  const success = (response) => {
-    logInfo(MODULE_NAME, "getBidRequestData:", "Neuwo API raw response:", response);
-    try {
-      const responseParsed = JSON.parse(response);
-
-      if (enableCache) {
-        globalCachedResponse = responseParsed;
-      }
-
-      injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonomyVersion);
-    } catch (ex) {
-      logError(MODULE_NAME, "getBidRequestData:", "Error while processing Neuwo API response", ex);
-    }
-    callback();
-  };
-
-  const error = (err) => {
-    logError(MODULE_NAME, "getBidRequestData:", "AJAX error:", err);
-    callback();
-  };
-
+  // Cache flow: cached response -> pending request -> new request
+  // Each caller gets their own callback invoked when data is ready.
   if (enableCache && globalCachedResponse) {
+    // Previous request succeeded - use cached response immediately
     logInfo(MODULE_NAME, "getBidRequestData:", "Using cached response:", globalCachedResponse);
     injectIabCategories(globalCachedResponse, reqBidsConfigObj, iabContentTaxonomyVersion);
     callback();
+  } else if (enableCache && pendingRequest) {
+    // Another caller started a request - wait for it instead of making a duplicate
+    logInfo(MODULE_NAME, "getBidRequestData:", "Waiting for pending request");
+    pendingRequest
+      .then((responseParsed) => {
+        if (responseParsed) {
+          injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonomyVersion);
+        }
+      })
+      .finally(() => callback());
   } else {
-    logInfo(MODULE_NAME, "getBidRequestData:", "Calling Neuwo API Endpoint: ", neuwoApiUrlFull);
-    ajax(neuwoApiUrlFull, { success, error }, null);
+    // First request or cache disabled - make the API call
+    logInfo(MODULE_NAME, "getBidRequestData:", "Calling Neuwo API Endpoint:", neuwoApiUrlFull);
+
+    const requestPromise = new Promise((resolve) => {
+      ajax(neuwoApiUrlFull, {
+        success: (response) => {
+          logInfo(MODULE_NAME, "getBidRequestData:", "Neuwo API raw response:", response);
+          try {
+            const responseParsed = JSON.parse(response);
+            // Cache response
+            if (enableCache) {
+              globalCachedResponse = responseParsed;
+            }
+            injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonomyVersion);
+            resolve(responseParsed);
+          } catch (ex) {
+            logError(MODULE_NAME, "getBidRequestData:", "Error parsing Neuwo API response:", ex);
+            resolve(null);
+          }
+        },
+        error: (err) => {
+          logError(MODULE_NAME, "getBidRequestData:", "AJAX error:", err);
+          resolve(null);
+        }
+      }, null);
+    });
+
+    if (enableCache) {
+      // Store promise so concurrent callers can wait on it
+      pendingRequest = requestPromise;
+      // Clear after settling so failed requests can be retried
+      requestPromise.finally(() => { pendingRequest = undefined; });
+    }
+
+    // Signal this caller's auction to proceed once request completes
+    requestPromise.finally(() => callback());
   }
 }
 

From 710547c4b477e582aa9cc4f9775a4af4d9f8c3b6 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Thu, 18 Dec 2025 12:32:51 +0100
Subject: [PATCH 06/24] chore: standardize log message format in Neuwo RTD
 Module

---
 modules/neuwoRtdProvider.js | 46 ++++++++++++++++++-------------------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index 2f402886c5d..7523d887b30 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -56,14 +56,14 @@ const IAB_CONTENT_TAXONOMY_MAP = {
  * @returns {boolean} `true` if the module is configured correctly, otherwise `false`.
  */
 function init(config, userConsent) {
-  logInfo(MODULE_NAME, "init:", config, userConsent);
+  logInfo(MODULE_NAME, "init():", config, userConsent);
   const params = config?.params || {};
   if (!params.neuwoApiUrl) {
-    logError(MODULE_NAME, "init:", "Missing Neuwo Edge API Endpoint URL");
+    logError(MODULE_NAME, "init():", "Missing Neuwo Edge API Endpoint URL");
     return false;
   }
   if (!params.neuwoApiToken) {
-    logError(MODULE_NAME, "init:", "Missing Neuwo API Token missing");
+    logError(MODULE_NAME, "init():", "Missing Neuwo API Token missing");
     return false;
   }
   return true;
@@ -89,7 +89,7 @@ function init(config, userConsent) {
  * @param {Object} userConsent The user consent object.
  */
 export function getBidRequestData(reqBidsConfigObj, callback, config, userConsent) {
-  logInfo(MODULE_NAME, "getBidRequestData:", "starting getBidRequestData", config);
+  logInfo(MODULE_NAME, "getBidRequestData():", "starting getBidRequestData", config);
 
   const {
     websiteToAnalyseUrl,
@@ -120,12 +120,12 @@ export function getBidRequestData(reqBidsConfigObj, callback, config, userConsen
   // Each caller gets their own callback invoked when data is ready.
   if (enableCache && globalCachedResponse) {
     // Previous request succeeded - use cached response immediately
-    logInfo(MODULE_NAME, "getBidRequestData:", "Using cached response:", globalCachedResponse);
+    logInfo(MODULE_NAME, "getBidRequestData():", "Cache System:", "Using cached response:", globalCachedResponse);
     injectIabCategories(globalCachedResponse, reqBidsConfigObj, iabContentTaxonomyVersion);
     callback();
   } else if (enableCache && pendingRequest) {
     // Another caller started a request - wait for it instead of making a duplicate
-    logInfo(MODULE_NAME, "getBidRequestData:", "Waiting for pending request");
+    logInfo(MODULE_NAME, "getBidRequestData():", "Cache System:", "Waiting for pending request");
     pendingRequest
       .then((responseParsed) => {
         if (responseParsed) {
@@ -135,12 +135,12 @@ export function getBidRequestData(reqBidsConfigObj, callback, config, userConsen
       .finally(() => callback());
   } else {
     // First request or cache disabled - make the API call
-    logInfo(MODULE_NAME, "getBidRequestData:", "Calling Neuwo API Endpoint:", neuwoApiUrlFull);
+    logInfo(MODULE_NAME, "getBidRequestData():", "Cache System:", "Calling Neuwo API Endpoint:", neuwoApiUrlFull);
 
     const requestPromise = new Promise((resolve) => {
       ajax(neuwoApiUrlFull, {
         success: (response) => {
-          logInfo(MODULE_NAME, "getBidRequestData:", "Neuwo API raw response:", response);
+          logInfo(MODULE_NAME, "getBidRequestData():", "success():", "Neuwo API raw response:", response);
           try {
             const responseParsed = JSON.parse(response);
             // Cache response
@@ -150,12 +150,12 @@ export function getBidRequestData(reqBidsConfigObj, callback, config, userConsen
             injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonomyVersion);
             resolve(responseParsed);
           } catch (ex) {
-            logError(MODULE_NAME, "getBidRequestData:", "Error parsing Neuwo API response:", ex);
+            logError(MODULE_NAME, "getBidRequestData():", "success():", "Error parsing Neuwo API response:", ex);
             resolve(null);
           }
         },
         error: (err) => {
-          logError(MODULE_NAME, "getBidRequestData:", "AJAX error:", err);
+          logError(MODULE_NAME, "getBidRequestData():", "error():", "AJAX error:", err);
           resolve(null);
         }
       }, null);
@@ -192,11 +192,11 @@ export function cleanUrl(url, options = {}) {
   const { stripAllQueryParams, stripQueryParamsForDomains, stripQueryParams, stripFragments } = options;
 
   if (!url) {
-    logInfo(MODULE_NAME, "cleanUrl:", "Empty or null URL provided, returning as-is");
+    logInfo(MODULE_NAME, "cleanUrl():", "Empty or null URL provided, returning as-is");
     return url;
   }
 
-  logInfo(MODULE_NAME, "cleanUrl:", "Input URL:", url, "Options:", options);
+  logInfo(MODULE_NAME, "cleanUrl():", "Input URL:", url, "Options:", options);
 
   try {
     const urlObj = new URL(url);
@@ -204,14 +204,14 @@ export function cleanUrl(url, options = {}) {
     // Strip fragments if requested
     if (stripFragments === true) {
       urlObj.hash = "";
-      logInfo(MODULE_NAME, "cleanUrl:", "Stripped fragment from URL");
+      logInfo(MODULE_NAME, "cleanUrl():", "Stripped fragment from URL");
     }
 
     // Option 1: Strip all query params unconditionally
     if (stripAllQueryParams === true) {
       urlObj.search = "";
       const cleanedUrl = urlObj.toString();
-      logInfo(MODULE_NAME, "cleanUrl:", "Output URL:", cleanedUrl);
+      logInfo(MODULE_NAME, "cleanUrl():", "Output URL:", cleanedUrl);
       return cleanedUrl;
     }
 
@@ -226,7 +226,7 @@ export function cleanUrl(url, options = {}) {
       if (shouldStripForDomain) {
         urlObj.search = "";
         const cleanedUrl = urlObj.toString();
-        logInfo(MODULE_NAME, "cleanUrl:", "Output URL:", cleanedUrl);
+        logInfo(MODULE_NAME, "cleanUrl():", "Output URL:", cleanedUrl);
         return cleanedUrl;
       }
     }
@@ -237,21 +237,21 @@ export function cleanUrl(url, options = {}) {
     // - "??" is treated as query parameter with key "?" and value ""
     if (Array.isArray(stripQueryParams) && stripQueryParams.length > 0) {
       const queryParams = urlObj.searchParams;
-      logInfo(MODULE_NAME, "cleanUrl:", `Query parameters to strip: ${stripQueryParams}`);
+      logInfo(MODULE_NAME, "cleanUrl():", `Query parameters to strip: ${stripQueryParams}`);
       stripQueryParams.forEach(param => {
         queryParams.delete(param);
       });
       urlObj.search = queryParams.toString();
       const cleanedUrl = urlObj.toString();
-      logInfo(MODULE_NAME, "cleanUrl:", "Output URL:", cleanedUrl);
+      logInfo(MODULE_NAME, "cleanUrl():", "Output URL:", cleanedUrl);
       return cleanedUrl;
     }
 
     const finalUrl = urlObj.toString();
-    logInfo(MODULE_NAME, "cleanUrl:", "Output URL:", finalUrl);
+    logInfo(MODULE_NAME, "cleanUrl():", "Output URL:", finalUrl);
     return finalUrl;
   } catch (e) {
-    logError(MODULE_NAME, "cleanUrl:", "Error cleaning URL:", e);
+    logError(MODULE_NAME, "cleanUrl():", "Error cleaning URL:", e);
     return url;
   }
 }
@@ -313,7 +313,7 @@ function injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonom
   const marketingCategories = responseParsed.marketing_categories;
 
   if (!marketingCategories) {
-    logError(MODULE_NAME, "injectIabCategories:", "No Marketing Categories in Neuwo API response.");
+    logError(MODULE_NAME, "injectIabCategories():", "No Marketing Categories in Neuwo API response.");
     return
   }
 
@@ -329,13 +329,13 @@ function injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonom
   const audienceTiers = ["iab_audience_tier_3", "iab_audience_tier_4", "iab_audience_tier_5"];
   const audienceData = buildIabData(marketingCategories, audienceTiers, 4);
 
-  logInfo(MODULE_NAME, "injectIabCategories:", "contentData structure:", contentData);
-  logInfo(MODULE_NAME, "injectIabCategories:", "audienceData structure:", audienceData);
+  logInfo(MODULE_NAME, "injectIabCategories():", "contentData structure:", contentData);
+  logInfo(MODULE_NAME, "injectIabCategories():", "audienceData structure:", audienceData);
 
   injectOrtbData(reqBidsConfigObj, "site.content.data", [contentData]);
   injectOrtbData(reqBidsConfigObj, "user.data", [audienceData]);
 
-  logInfo(MODULE_NAME, "injectIabCategories:", "post-injection bidsConfig", reqBidsConfigObj);
+  logInfo(MODULE_NAME, "injectIabCategories():", "post-injection bidsConfig", reqBidsConfigObj);
 }
 
 export const neuwoRtdModule = {

From f20ddc38407fa20ed1307133cc7dedf5cfb5fcdf Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Thu, 18 Dec 2025 13:01:56 +0100
Subject: [PATCH 07/24] feat: add product identifier to Neuwo API requests

---
 modules/neuwoRtdProvider.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index 7523d887b30..0d4d130758b 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -114,7 +114,7 @@ export function getBidRequestData(reqBidsConfigObj, callback, config, userConsen
   // Adjusted for pages api.url?prefix=test (to add params with '&') as well as api.url (to add params with '?')
   const joiner = neuwoApiUrl.indexOf("?") < 0 ? "?" : "&";
   const neuwoApiUrlFull =
-    neuwoApiUrl + joiner + ["token=" + neuwoApiToken, "url=" + pageUrl].join("&");
+    neuwoApiUrl + joiner + ["token=" + neuwoApiToken, "url=" + pageUrl, "_neuwo_prod=PrebidModule"].join("&");
 
   // Cache flow: cached response -> pending request -> new request
   // Each caller gets their own callback invoked when data is ready.

From 4a54cdc855e2b42f2898694f077d94d26279d98a Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Thu, 18 Dec 2025 13:06:07 +0100
Subject: [PATCH 08/24] docs: fix typo in test file name in Neuwo RTD Module
 documentation

---
 modules/neuwoRtdProvider.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index 8698f049655..9cfda76caa7 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -239,7 +239,7 @@ npx eslint 'modules/neuwoRtdProvider.js' --cache --cache-strategy content
 To run the module-specific tests:
 
 ```bash
-npx gulp test-only --modules=rtdModule,neuwoRtdProvider,appnexusBidAdapter --file=test/spec/modules/euwoRtdProvider_spec.js
+npx gulp test-only --modules=rtdModule,neuwoRtdProvider,appnexusBidAdapter --file=test/spec/modules/neuwoRtdProvider_spec.js
 ```
 
 Skip building, if the project has already been built:

From a2cba4054351e80b9570d340720ba86e06b3a308 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Thu, 18 Dec 2025 13:12:08 +0100
Subject: [PATCH 09/24] style: format Neuwo RTD Module with Prettier

- Add `// prettier-ignore` comment to preserve quoted keys in `IAB_CONTENT_TAXONOMY_MAP`
- Apply Prettier formatting to *modules/neuwoRtdProvider.js*
---
 modules/neuwoRtdProvider.js | 198 ++++++++++++++++++++++++++++--------
 1 file changed, 156 insertions(+), 42 deletions(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index 0d4d130758b..9edc04f7aa0 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -39,6 +39,7 @@ export function clearCache() {
 
 // Maps the IAB Content Taxonomy version string to the corresponding segtax ID.
 // Based on https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list--category-taxonomies-
+// prettier-ignore
 const IAB_CONTENT_TAXONOMY_MAP = {
   "1.0": 1,
   "2.0": 2,
@@ -88,8 +89,18 @@ function init(config, userConsent) {
  * @param {boolean} [config.params.stripFragments] If true, strips URL fragments (hash).
  * @param {Object} userConsent The user consent object.
  */
-export function getBidRequestData(reqBidsConfigObj, callback, config, userConsent) {
-  logInfo(MODULE_NAME, "getBidRequestData():", "starting getBidRequestData", config);
+export function getBidRequestData(
+  reqBidsConfigObj,
+  callback,
+  config,
+  userConsent
+) {
+  logInfo(
+    MODULE_NAME,
+    "getBidRequestData():",
+    "starting getBidRequestData",
+    config
+  );
 
   const {
     websiteToAnalyseUrl,
@@ -108,64 +119,123 @@ export function getBidRequestData(reqBidsConfigObj, callback, config, userConsen
     stripAllQueryParams,
     stripQueryParamsForDomains,
     stripQueryParams,
-    stripFragments
+    stripFragments,
   });
   const pageUrl = encodeURIComponent(processedUrl);
   // Adjusted for pages api.url?prefix=test (to add params with '&') as well as api.url (to add params with '?')
   const joiner = neuwoApiUrl.indexOf("?") < 0 ? "?" : "&";
   const neuwoApiUrlFull =
-    neuwoApiUrl + joiner + ["token=" + neuwoApiToken, "url=" + pageUrl, "_neuwo_prod=PrebidModule"].join("&");
+    neuwoApiUrl +
+    joiner +
+    [
+      "token=" + neuwoApiToken,
+      "url=" + pageUrl,
+      "_neuwo_prod=PrebidModule",
+    ].join("&");
 
   // Cache flow: cached response -> pending request -> new request
   // Each caller gets their own callback invoked when data is ready.
   if (enableCache && globalCachedResponse) {
     // Previous request succeeded - use cached response immediately
-    logInfo(MODULE_NAME, "getBidRequestData():", "Cache System:", "Using cached response:", globalCachedResponse);
-    injectIabCategories(globalCachedResponse, reqBidsConfigObj, iabContentTaxonomyVersion);
+    logInfo(
+      MODULE_NAME,
+      "getBidRequestData():",
+      "Cache System:",
+      "Using cached response:",
+      globalCachedResponse
+    );
+    injectIabCategories(
+      globalCachedResponse,
+      reqBidsConfigObj,
+      iabContentTaxonomyVersion
+    );
     callback();
   } else if (enableCache && pendingRequest) {
     // Another caller started a request - wait for it instead of making a duplicate
-    logInfo(MODULE_NAME, "getBidRequestData():", "Cache System:", "Waiting for pending request");
+    logInfo(
+      MODULE_NAME,
+      "getBidRequestData():",
+      "Cache System:",
+      "Waiting for pending request"
+    );
     pendingRequest
       .then((responseParsed) => {
         if (responseParsed) {
-          injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonomyVersion);
+          injectIabCategories(
+            responseParsed,
+            reqBidsConfigObj,
+            iabContentTaxonomyVersion
+          );
         }
       })
       .finally(() => callback());
   } else {
     // First request or cache disabled - make the API call
-    logInfo(MODULE_NAME, "getBidRequestData():", "Cache System:", "Calling Neuwo API Endpoint:", neuwoApiUrlFull);
+    logInfo(
+      MODULE_NAME,
+      "getBidRequestData():",
+      "Cache System:",
+      "Calling Neuwo API Endpoint:",
+      neuwoApiUrlFull
+    );
 
     const requestPromise = new Promise((resolve) => {
-      ajax(neuwoApiUrlFull, {
-        success: (response) => {
-          logInfo(MODULE_NAME, "getBidRequestData():", "success():", "Neuwo API raw response:", response);
-          try {
-            const responseParsed = JSON.parse(response);
-            // Cache response
-            if (enableCache) {
-              globalCachedResponse = responseParsed;
+      ajax(
+        neuwoApiUrlFull,
+        {
+          success: (response) => {
+            logInfo(
+              MODULE_NAME,
+              "getBidRequestData():",
+              "success():",
+              "Neuwo API raw response:",
+              response
+            );
+            try {
+              const responseParsed = JSON.parse(response);
+              // Cache response
+              if (enableCache) {
+                globalCachedResponse = responseParsed;
+              }
+              injectIabCategories(
+                responseParsed,
+                reqBidsConfigObj,
+                iabContentTaxonomyVersion
+              );
+              resolve(responseParsed);
+            } catch (ex) {
+              logError(
+                MODULE_NAME,
+                "getBidRequestData():",
+                "success():",
+                "Error parsing Neuwo API response:",
+                ex
+              );
+              resolve(null);
             }
-            injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonomyVersion);
-            resolve(responseParsed);
-          } catch (ex) {
-            logError(MODULE_NAME, "getBidRequestData():", "success():", "Error parsing Neuwo API response:", ex);
+          },
+          error: (err) => {
+            logError(
+              MODULE_NAME,
+              "getBidRequestData():",
+              "error():",
+              "AJAX error:",
+              err
+            );
             resolve(null);
-          }
+          },
         },
-        error: (err) => {
-          logError(MODULE_NAME, "getBidRequestData():", "error():", "AJAX error:", err);
-          resolve(null);
-        }
-      }, null);
+        null
+      );
     });
 
     if (enableCache) {
       // Store promise so concurrent callers can wait on it
       pendingRequest = requestPromise;
       // Clear after settling so failed requests can be retried
-      requestPromise.finally(() => { pendingRequest = undefined; });
+      requestPromise.finally(() => {
+        pendingRequest = undefined;
+      });
     }
 
     // Signal this caller's auction to proceed once request completes
@@ -189,10 +259,19 @@ export function getBidRequestData(reqBidsConfigObj, callback, config, userConsen
  * @returns {string} The cleaned URL.
  */
 export function cleanUrl(url, options = {}) {
-  const { stripAllQueryParams, stripQueryParamsForDomains, stripQueryParams, stripFragments } = options;
+  const {
+    stripAllQueryParams,
+    stripQueryParamsForDomains,
+    stripQueryParams,
+    stripFragments,
+  } = options;
 
   if (!url) {
-    logInfo(MODULE_NAME, "cleanUrl():", "Empty or null URL provided, returning as-is");
+    logInfo(
+      MODULE_NAME,
+      "cleanUrl():",
+      "Empty or null URL provided, returning as-is"
+    );
     return url;
   }
 
@@ -216,9 +295,12 @@ export function cleanUrl(url, options = {}) {
     }
 
     // Option 2: Strip all query params for specific domains
-    if (Array.isArray(stripQueryParamsForDomains) && stripQueryParamsForDomains.length > 0) {
+    if (
+      Array.isArray(stripQueryParamsForDomains) &&
+      stripQueryParamsForDomains.length > 0
+    ) {
       const hostname = urlObj.hostname;
-      const shouldStripForDomain = stripQueryParamsForDomains.some(domain => {
+      const shouldStripForDomain = stripQueryParamsForDomains.some((domain) => {
         // Support exact match or subdomain match
         return hostname === domain || hostname.endsWith("." + domain);
       });
@@ -237,8 +319,12 @@ export function cleanUrl(url, options = {}) {
     // - "??" is treated as query parameter with key "?" and value ""
     if (Array.isArray(stripQueryParams) && stripQueryParams.length > 0) {
       const queryParams = urlObj.searchParams;
-      logInfo(MODULE_NAME, "cleanUrl():", `Query parameters to strip: ${stripQueryParams}`);
-      stripQueryParams.forEach(param => {
+      logInfo(
+        MODULE_NAME,
+        "cleanUrl():",
+        `Query parameters to strip: ${stripQueryParams}`
+      );
+      stripQueryParams.forEach((param) => {
         queryParams.delete(param);
       });
       urlObj.search = queryParams.toString();
@@ -309,12 +395,20 @@ export function buildIabData(marketingCategories, tiers, segtax) {
  * @param {Object} reqBidsConfigObj The bid request configuration object to be modified.
  * @param {string} iabContentTaxonomyVersion The version of the IAB content taxonomy to use for segtax mapping.
  */
-function injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonomyVersion) {
+function injectIabCategories(
+  responseParsed,
+  reqBidsConfigObj,
+  iabContentTaxonomyVersion
+) {
   const marketingCategories = responseParsed.marketing_categories;
 
   if (!marketingCategories) {
-    logError(MODULE_NAME, "injectIabCategories():", "No Marketing Categories in Neuwo API response.");
-    return
+    logError(
+      MODULE_NAME,
+      "injectIabCategories():",
+      "No Marketing Categories in Neuwo API response."
+    );
+    return;
   }
 
   // Process content categories
@@ -322,20 +416,40 @@ function injectIabCategories(responseParsed, reqBidsConfigObj, iabContentTaxonom
   const contentData = buildIabData(
     marketingCategories,
     contentTiers,
-    IAB_CONTENT_TAXONOMY_MAP[iabContentTaxonomyVersion] || IAB_CONTENT_TAXONOMY_MAP["3.0"]
+    IAB_CONTENT_TAXONOMY_MAP[iabContentTaxonomyVersion] ||
+      IAB_CONTENT_TAXONOMY_MAP["3.0"]
   );
 
   // Process audience categories
-  const audienceTiers = ["iab_audience_tier_3", "iab_audience_tier_4", "iab_audience_tier_5"];
+  const audienceTiers = [
+    "iab_audience_tier_3",
+    "iab_audience_tier_4",
+    "iab_audience_tier_5",
+  ];
   const audienceData = buildIabData(marketingCategories, audienceTiers, 4);
 
-  logInfo(MODULE_NAME, "injectIabCategories():", "contentData structure:", contentData);
-  logInfo(MODULE_NAME, "injectIabCategories():", "audienceData structure:", audienceData);
+  logInfo(
+    MODULE_NAME,
+    "injectIabCategories():",
+    "contentData structure:",
+    contentData
+  );
+  logInfo(
+    MODULE_NAME,
+    "injectIabCategories():",
+    "audienceData structure:",
+    audienceData
+  );
 
   injectOrtbData(reqBidsConfigObj, "site.content.data", [contentData]);
   injectOrtbData(reqBidsConfigObj, "user.data", [audienceData]);
 
-  logInfo(MODULE_NAME, "injectIabCategories():", "post-injection bidsConfig", reqBidsConfigObj);
+  logInfo(
+    MODULE_NAME,
+    "injectIabCategories():",
+    "post-injection bidsConfig",
+    reqBidsConfigObj
+  );
 }
 
 export const neuwoRtdModule = {

From aa3703cfd6d3788b87dfc784200e449e2388d591 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Fri, 9 Jan 2026 09:12:53 +0100
Subject: [PATCH 10/24] test: add coverage for concurrent requests and product
 identifier in Neuwo RTD Module

---
 test/spec/modules/neuwoRtdProvider_spec.js | 107 +++++++++++++++++++++
 1 file changed, 107 insertions(+)

diff --git a/test/spec/modules/neuwoRtdProvider_spec.js b/test/spec/modules/neuwoRtdProvider_spec.js
index 4b2951afe33..a8b2ab53280 100644
--- a/test/spec/modules/neuwoRtdProvider_spec.js
+++ b/test/spec/modules/neuwoRtdProvider_spec.js
@@ -339,6 +339,9 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "The request URL should include the encoded website URL").to.include(
           encodeURIComponent(conf.params.websiteToAnalyseUrl)
         );
+        expect(request.url, "The request URL should include the product identifier").to.include(
+          "_neuwo_prod=PrebidModule"
+        );
 
         request.respond(
           200,
@@ -1079,6 +1082,110 @@ describe("neuwoRtdModule", function () {
         neuwo.getBidRequestData(bidsConfig2, () => {}, conf, "consent data");
         expect(server.requests.length, "Second call should use cached response").to.equal(1);
       });
+
+      it("should handle concurrent requests by sharing a pending request promise", function (done) {
+        const apiResponse = getNeuwoApiResponse();
+        const bidsConfig1 = bidsConfiglike();
+        const bidsConfig2 = bidsConfiglike();
+        const bidsConfig3 = bidsConfiglike();
+        const conf = config();
+        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=concurrent";
+        conf.params.enableCache = true;
+
+        let callbackCount = 0;
+        const callback = () => {
+          callbackCount++;
+          if (callbackCount === 3) {
+            // All callbacks have been called, now verify the data
+            try {
+              const contentData1 = bidsConfig1.ortb2Fragments.global.site.content.data[0];
+              const contentData2 = bidsConfig2.ortb2Fragments.global.site.content.data[0];
+              const contentData3 = bidsConfig3.ortb2Fragments.global.site.content.data[0];
+
+              expect(contentData1, "First config should have Neuwo data").to.exist;
+              expect(contentData2, "Second config should have Neuwo data from pending request").to.exist;
+              expect(contentData3, "Third config should have Neuwo data from pending request").to.exist;
+              expect(contentData1.name, "First config should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+              expect(contentData2.name, "Second config should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+              expect(contentData3.name, "Third config should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+              done();
+            } catch (e) {
+              done(e);
+            }
+          }
+        };
+
+        // Make three concurrent calls before responding to the first request
+        neuwo.getBidRequestData(bidsConfig1, callback, conf, "consent data");
+        neuwo.getBidRequestData(bidsConfig2, callback, conf, "consent data");
+        neuwo.getBidRequestData(bidsConfig3, callback, conf, "consent data");
+
+        // Only one API request should be made
+        expect(server.requests.length, "Only one API request should be made for concurrent calls").to.equal(1);
+
+        const request = server.requests[0];
+        request.respond(
+          200,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          JSON.stringify(apiResponse)
+        );
+      });
+
+      it("should transition through all three cache states: pending request, then cached response", function (done) {
+        const apiResponse = getNeuwoApiResponse();
+        const bidsConfig1 = bidsConfiglike();
+        const bidsConfig2 = bidsConfiglike();
+        const bidsConfig3 = bidsConfiglike();
+        const conf = config();
+        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=three-stage";
+        conf.params.enableCache = true;
+
+        let callback1and2Count = 0;
+
+        const callback1and2 = () => {
+          callback1and2Count++;
+          if (callback1and2Count === 2) {
+            // Both first and second callbacks have been called
+            // Stage 3: Third request should use cached response (not pending request)
+            neuwo.getBidRequestData(bidsConfig3, () => {
+              try {
+                expect(server.requests.length, "Third call should use cache and not make a new API request").to.equal(1);
+
+                // All three configs should have the same data
+                const contentData1 = bidsConfig1.ortb2Fragments.global.site.content.data[0];
+                const contentData2 = bidsConfig2.ortb2Fragments.global.site.content.data[0];
+                const contentData3 = bidsConfig3.ortb2Fragments.global.site.content.data[0];
+
+                expect(contentData1, "First config should have Neuwo data").to.exist;
+                expect(contentData2, "Second config should have Neuwo data from pending request").to.exist;
+                expect(contentData3, "Third config should have Neuwo data from cache").to.exist;
+                expect(contentData1.name, "First config should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+                expect(contentData2.name, "Second config should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+                expect(contentData3.name, "Third config should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+                done();
+              } catch (e) {
+                done(e);
+              }
+            }, conf, "consent data");
+          }
+        };
+
+        // Stage 1: First request initiates API call (creates pending request)
+        neuwo.getBidRequestData(bidsConfig1, callback1and2, conf, "consent data");
+        expect(server.requests.length, "First call should make an API request").to.equal(1);
+
+        // Stage 2: Second request should attach to pending request before response
+        neuwo.getBidRequestData(bidsConfig2, callback1and2, conf, "consent data");
+        expect(server.requests.length, "Second call should not make a new API request").to.equal(1);
+
+        // Respond to the API request, which populates the cache
+        const request = server.requests[0];
+        request.respond(
+          200,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          JSON.stringify(apiResponse)
+        );
+      });
     });
 
     describe("when enableCache is false", function () {

From 588d77f96e7a060f98af9615c241f949dda9764c Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Fri, 9 Jan 2026 13:46:33 +0100
Subject: [PATCH 11/24] feat: add per-tier IAB taxonomy filtering to Neuwo RTD
 Module

Add optional filtering configuration for IAB Content and Audience taxonomies, allowing publishers to control the quantity and quality of categories injected into bid requests.

- Add `iabTaxonomyFilters` parameter to module configuration for per-tier filtering
- Implement `filterIabTaxonomyTier()` function to filter taxonomies by relevance threshold and limit count
- Implement `filterIabTaxonomies()` function to apply filters across all tiers using tier key mapping
- Add integration example checkbox to enable/disable filtering with hardcoded filter values
---
 .../gpt/neuwoRtdProvider_example.html         |  41 +++++-
 modules/neuwoRtdProvider.js                   | 131 +++++++++++++++++-
 2 files changed, 163 insertions(+), 9 deletions(-)

diff --git a/integrationExamples/gpt/neuwoRtdProvider_example.html b/integrationExamples/gpt/neuwoRtdProvider_example.html
index 71aa2dd26eb..97e72562b86 100644
--- a/integrationExamples/gpt/neuwoRtdProvider_example.html
+++ b/integrationExamples/gpt/neuwoRtdProvider_example.html
@@ -140,6 +140,20 @@
             const inputStripFragments = document.getElementById("strip-fragments");
             const stripFragments = inputStripFragments ? inputStripFragments.checked : undefined;
 
+            // IAB Taxonomy Filtering Option
+            const inputEnableFiltering = document.getElementById("enable-iab-filtering");
+            const enableIabFiltering = inputEnableFiltering ? inputEnableFiltering.checked : false;
+
+            // Build iabTaxonomyFilters object only if filtering is enabled
+            const iabTaxonomyFilters = enableIabFiltering ? {
+                ContentTier1: { limit: 1, threshold: 0.1 },
+                ContentTier2: { limit: 2, threshold: 0.1 },
+                ContentTier3: { limit: 3, threshold: 0.15 },
+                AudienceTier3: { limit: 3, threshold: 0.2 },
+                AudienceTier4: { limit: 5, threshold: 0.2 },
+                AudienceTier5: { limit: 7, threshold: 0.3 },
+            } : undefined;
+
             pbjs.que.push(function () {
                 pbjs.setConfig({
                     debug: true,
@@ -158,7 +172,8 @@
                                     stripAllQueryParams,
                                     stripQueryParamsForDomains,
                                     stripQueryParams,
-                                    stripFragments
+                                    stripFragments,
+                                    iabTaxonomyFilters,
                                 }
                             }
                         ]
@@ -256,6 +271,23 @@ <h3>URL Cleaning Options</h3>
             </label>
         </div>
 
+        <h3>IAB Taxonomy Filtering Options</h3>
+        <div style="margin-bottom: 10px;">
+            <label>
+                <input type="checkbox" id="enable-iab-filtering" />
+                Enable IAB taxonomy filtering (limits categories by relevance and count per tier)
+            </label>
+            <div style="margin-left: 20px; margin-top: 5px; color: #666; font-size: 0.9em;">
+                When enabled, uses these hardcoded filters:<br/>
+                • ContentTier1: top 1 (≥10% relevance)<br/>
+                • ContentTier2: top 2 (≥10% relevance)<br/>
+                • ContentTier3: top 3 (≥15% relevance)<br/>
+                • AudienceTier3: top 3 (≥20% relevance)<br/>
+                • AudienceTier4: top 5 (≥20% relevance)<br/>
+                • AudienceTier5: top 7 (≥30% relevance)
+            </div>
+        </div>
+
         <button onClick="onSettingsUpdate()">Update</button>
     </div>
 
@@ -535,7 +567,8 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
             stripAllQueryParams: document.getElementById("strip-all-query-params")?.checked || false,
             stripQueryParamsForDomains: document.getElementById("strip-query-params-for-domains")?.value || "",
             stripQueryParams: document.getElementById("strip-query-params")?.value || "",
-            stripFragments: document.getElementById("strip-fragments")?.checked || false
+            stripFragments: document.getElementById("strip-fragments")?.checked || false,
+            enableIabFiltering: document.getElementById("enable-iab-filtering")?.checked || false
         };
         localStorage.setItem("neuwoRtdConfig", JSON.stringify(config));
     }
@@ -559,6 +592,7 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
             document.getElementById("enable-cache").checked = config.enableCache !== false;
             document.getElementById("strip-all-query-params").checked = config.stripAllQueryParams;
             document.getElementById("strip-fragments").checked = config.stripFragments;
+            document.getElementById("enable-iab-filtering").checked = config.enableIabFiltering;
         } catch (e) {
             console.error("Error loading saved config:", e);
         }
@@ -578,7 +612,8 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
         const checkboxIds = [
             "enable-cache",
             "strip-all-query-params",
-            "strip-fragments"
+            "strip-fragments",
+            "enable-iab-filtering"
         ];
 
         // Save on text input change
diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index 9edc04f7aa0..30b4d92ec52 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -87,6 +87,7 @@ function init(config, userConsent) {
  * @param {string[]} [config.params.stripQueryParamsForDomains] List of domains for which to strip all query params.
  * @param {string[]} [config.params.stripQueryParams] List of specific query parameter names to strip.
  * @param {boolean} [config.params.stripFragments] If true, strips URL fragments (hash).
+ * @param {Object} [config.params.iabTaxonomyFilters] Per-tier filtering configuration for IAB taxonomies.
  * @param {Object} userConsent The user consent object.
  */
 export function getBidRequestData(
@@ -112,6 +113,7 @@ export function getBidRequestData(
     stripQueryParamsForDomains,
     stripQueryParams,
     stripFragments,
+    iabTaxonomyFilters,
   } = config.params;
 
   const rawUrl = websiteToAnalyseUrl || getRefererInfo().page;
@@ -147,7 +149,8 @@ export function getBidRequestData(
     injectIabCategories(
       globalCachedResponse,
       reqBidsConfigObj,
-      iabContentTaxonomyVersion
+      iabContentTaxonomyVersion,
+      iabTaxonomyFilters
     );
     callback();
   } else if (enableCache && pendingRequest) {
@@ -164,7 +167,8 @@ export function getBidRequestData(
           injectIabCategories(
             responseParsed,
             reqBidsConfigObj,
-            iabContentTaxonomyVersion
+            iabContentTaxonomyVersion,
+            iabTaxonomyFilters
           );
         }
       })
@@ -200,7 +204,8 @@ export function getBidRequestData(
               injectIabCategories(
                 responseParsed,
                 reqBidsConfigObj,
-                iabContentTaxonomyVersion
+                iabContentTaxonomyVersion,
+                iabTaxonomyFilters
               );
               resolve(responseParsed);
             } catch (ex) {
@@ -387,6 +392,115 @@ export function buildIabData(marketingCategories, tiers, segtax) {
   return data;
 }
 
+/**
+ * Filters and limits a single tier's taxonomies based on relevance score and count.
+ *
+ * @param {Array} iabTaxonomies Array of taxonomy objects with ID, label, and relevance
+ * @param {Object} filter Filter configuration for this tier
+ * @returns {Array} Filtered and limited array of taxonomies
+ */
+export function filterIabTaxonomyTier(iabTaxonomies, filter = {}) {
+  if (!Array.isArray(iabTaxonomies) || iabTaxonomies.length === 0) {
+    return iabTaxonomies;
+  }
+
+  const { threshold, limit } = filter;
+  let filtered = [...iabTaxonomies]; // Create copy to avoid mutating original
+
+  // Filter by minimum relevance score
+  if (typeof threshold === "number" && threshold > 0) {
+    filtered = filtered.filter((item) => {
+      const relevance = parseFloat(item?.relevance);
+      return !isNaN(relevance) && relevance >= threshold;
+    });
+  }
+
+  // Sort by relevance (highest first) before limiting
+  filtered = filtered.sort((a, b) => {
+    const relA = parseFloat(a?.relevance) || 0;
+    const relB = parseFloat(b?.relevance) || 0;
+    return relB - relA; // Descending order
+  });
+
+  // Limit count
+  if (typeof limit === "number" && limit > 0) {
+    filtered = filtered.slice(0, limit);
+  }
+
+  return filtered;
+}
+
+/**
+ * Maps tier configuration keys to API response keys.
+ */
+const TIER_KEY_MAP = {
+  ContentTier1: "iab_tier_1",
+  ContentTier2: "iab_tier_2",
+  ContentTier3: "iab_tier_3",
+  AudienceTier3: "iab_audience_tier_3",
+  AudienceTier4: "iab_audience_tier_4",
+  AudienceTier5: "iab_audience_tier_5",
+};
+
+/**
+ * Applies per-tier filtering to all IAB taxonomies.
+ * Filters taxonomies by relevance score and limits the count per tier.
+ *
+ * @param {Object} marketingCategories Marketing Categories returned by Neuwo API.
+ * @param {Object} [tierFilters] Per-tier filter configuration keyed by config tier names (e.g., {ContentTier1: {limit: 3, threshold: 0.75}}).
+ * @returns {Object} Filtered marketing categories with the same structure as input.
+ */
+export function filterIabTaxonomies(marketingCategories, tierFilters = {}) {
+  if (!marketingCategories || typeof marketingCategories !== "object") {
+    return marketingCategories;
+  }
+
+  // If no filters provided, return original data
+  if (!tierFilters || Object.keys(tierFilters).length === 0) {
+    logInfo(
+      MODULE_NAME,
+      "filterIabTaxonomies():",
+      "No filters provided, returning original data"
+    );
+    return marketingCategories;
+  }
+
+  const filtered = {};
+
+  // Iterate through all tiers in the API response
+  Object.keys(marketingCategories).forEach((apiTierKey) => {
+    const tierData = marketingCategories[apiTierKey];
+
+    // Find the corresponding config key for this API tier
+    const configTierKey = Object.keys(TIER_KEY_MAP).find(
+      (key) => TIER_KEY_MAP[key] === apiTierKey
+    );
+
+    // Get filter for this tier (if configured)
+    const filter = configTierKey ? tierFilters[configTierKey] : {};
+
+    // Apply filter if this tier has data
+    if (Array.isArray(tierData)) {
+      filtered[apiTierKey] = filterIabTaxonomyTier(tierData, filter);
+    } else {
+      // Preserve non-array data as-is
+      filtered[apiTierKey] = tierData;
+    }
+  });
+
+  logInfo(
+    MODULE_NAME,
+    "filterIabTaxonomies():",
+    "Filtering results:",
+    "Original:",
+    marketingCategories,
+    "Filtered:",
+    filtered,
+  );
+
+  return filtered;
+}
+
 /**
  * Processes the Neuwo API response to build and inject IAB content and audience categories
  * into the bid request object.
@@ -394,11 +508,13 @@ export function buildIabData(marketingCategories, tiers, segtax) {
  * @param {Object} responseParsed The parsed JSON response from the Neuwo API.
  * @param {Object} reqBidsConfigObj The bid request configuration object to be modified.
  * @param {string} iabContentTaxonomyVersion The version of the IAB content taxonomy to use for segtax mapping.
+ * @param {Object} [iabTaxonomyFilters] Per-tier filter configuration (e.g., {ContentTier1: {limit: 3, threshold: 0.75}}).
  */
 function injectIabCategories(
   responseParsed,
   reqBidsConfigObj,
-  iabContentTaxonomyVersion
+  iabContentTaxonomyVersion,
+  iabTaxonomyFilters
 ) {
   const marketingCategories = responseParsed.marketing_categories;
 
@@ -411,10 +527,13 @@ function injectIabCategories(
     return;
   }
 
+  // Apply per-tier filtering
+  const marketingCategoriesFiltered = filterIabTaxonomies(marketingCategories, iabTaxonomyFilters);
+
   // Process content categories
   const contentTiers = ["iab_tier_1", "iab_tier_2", "iab_tier_3"];
   const contentData = buildIabData(
-    marketingCategories,
+    marketingCategoriesFiltered,
     contentTiers,
     IAB_CONTENT_TAXONOMY_MAP[iabContentTaxonomyVersion] ||
       IAB_CONTENT_TAXONOMY_MAP["3.0"]
@@ -426,7 +545,7 @@ function injectIabCategories(
     "iab_audience_tier_4",
     "iab_audience_tier_5",
   ];
-  const audienceData = buildIabData(marketingCategories, audienceTiers, 4);
+  const audienceData = buildIabData(marketingCategoriesFiltered, audienceTiers, 4);
 
   logInfo(
     MODULE_NAME,

From 8d60f8055c4565c011be4e36be56f32c9e7697a9 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Fri, 9 Jan 2026 13:48:32 +0100
Subject: [PATCH 12/24] docs: add IAB taxonomy filtering documentation to Neuwo
 RTD Module

---
 modules/neuwoRtdProvider.md | 71 +++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index 9cfda76caa7..bb98b6eb107 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -105,6 +105,7 @@ pbjs.setConfig({
 | `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains. |
 | `params.stripQueryParams`           | String[] | No       | `[]`    | List of specific query parameter names to strip from the URL (e.g., `['utm_source', 'fbclid']`). Other parameters are preserved. Only applies when the domain does not match `stripQueryParamsForDomains`.                                                                                                                 |
 | `params.stripFragments`             | Boolean  | No       | `false` | If `true`, strips URL fragments (hash, e.g., `#section`) from the URL before analysis.                                                                                                                                                                                                                                     |
+| `params.iabTaxonomyFilters`         | Object   | No       |         | Per-tier filtering configuration for IAB taxonomies. Allows filtering by relevance threshold and limiting the count of categories per tier. See [IAB Taxonomy Filtering](#iab-taxonomy-filtering) section below for details.                                                                                                |
 
 ### API Response Caching
 
@@ -147,6 +148,76 @@ pbjs.setConfig({
 });
 ```
 
+### IAB Taxonomy Filtering
+
+The module provides optional per-tier filtering for IAB taxonomies to control the quantity and quality of categories injected into bid requests. This allows you to limit categories based on their relevance score and restrict the maximum number of categories per tier.
+
+**Filter Configuration:**
+
+Each tier can have two optional parameters:
+- `threshold` (Number): Minimum relevance score (0.0 to 1.0). Categories below this threshold are excluded.
+- `limit` (Number): Maximum number of categories to include for this tier (after filtering and sorting by relevance).
+
+**Available Tiers:**
+
+| Tier Name        | Description                  | API Response Key         |
+| :--------------- | :--------------------------- | :----------------------- |
+| `ContentTier1`   | IAB Content Tier 1           | `iab_tier_1`             |
+| `ContentTier2`   | IAB Content Tier 2           | `iab_tier_2`             |
+| `ContentTier3`   | IAB Content Tier 3           | `iab_tier_3`             |
+| `AudienceTier3`  | IAB Audience Tier 3          | `iab_audience_tier_3`    |
+| `AudienceTier4`  | IAB Audience Tier 4          | `iab_audience_tier_4`    |
+| `AudienceTier5`  | IAB Audience Tier 5          | `iab_audience_tier_5`    |
+
+**Example with IAB taxonomy filtering:**
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    auctionDelay: 500,
+    dataProviders: [
+      {
+        name: "NeuwoRTDModule",
+        waitForIt: true,
+        params: {
+          neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
+          neuwoApiToken: "<Your Neuwo API Token>",
+          iabContentTaxonomyVersion: "3.0",
+
+          // Filter IAB taxonomies by tier
+          iabTaxonomyFilters: {
+            // Content Tier 1: Keep only the top category with at least 10% relevance
+            ContentTier1: { limit: 1, threshold: 0.1 },
+
+            // Content Tier 2: Keep top 2 categories with at least 10% relevance
+            ContentTier2: { limit: 2, threshold: 0.1 },
+
+            // Content Tier 3: Keep top 3 categories with at least 15% relevance
+            ContentTier3: { limit: 3, threshold: 0.15 },
+
+            // Audience Tier 3: Keep top 3 categories with at least 20% relevance
+            AudienceTier3: { limit: 3, threshold: 0.2 },
+
+            // Audience Tier 4: Keep top 5 categories with at least 20% relevance
+            AudienceTier4: { limit: 5, threshold: 0.2 },
+
+            // Audience Tier 5: Keep top 7 categories with at least 30% relevance
+            AudienceTier5: { limit: 7, threshold: 0.3 },
+          },
+        },
+      },
+    ],
+  },
+});
+```
+
+**How it works:**
+
+1. Categories are first filtered by the `threshold` value (if specified)
+2. Remaining categories are sorted by relevance score in descending order (highest first)
+3. The top N categories are selected based on the `limit` value (if specified)
+4. Tiers without filters configured will use all categories returned by the API
+
 ## Accessing Neuwo Data Outside Prebid.js
 
 The Neuwo RTD module enriches bid requests with contextual data that can be accessed in application code for analytics, targeting, integration with Google Ad Manager as [Publisher Provided Signals (PPS)](https://support.google.com/admanager/answer/15287325) or other purposes. The enriched data is available through Prebid.js events.

From 9dbdc600e0a24f70951f4f06cb12223cdc18ef24 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Fri, 9 Jan 2026 13:57:33 +0100
Subject: [PATCH 13/24] test: add error handling and edge case tests for Neuwo
 RTD Module

- Add test for API URL construction when `neuwoApiUrl` contains existing query parameters
- Add tests for error response handling: 404 errors, pending request cleanup, and retry behaviour
- Add tests for concurrent requests with errors ensuring all callbacks are invoked
- Add tests for JSON parsing errors in success callback
- Add test for retry after JSON parsing error
- Add test for missing `marketing_categories` field in API response
- Add test for sorting items with undefined/null relevance values
- Reorganise test structure: nest caching, URL stripping, and filtering describes under main `getBidRequestData` block
- Add documentation for generating test coverage reports with viewing instructions
---
 modules/neuwoRtdProvider.md                |  17 +
 test/spec/modules/neuwoRtdProvider_spec.js | 776 ++++++++++++++++++---
 2 files changed, 705 insertions(+), 88 deletions(-)

diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index bb98b6eb107..ec606792153 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -318,3 +318,20 @@ Skip building, if the project has already been built:
 ```bash
 npx gulp test-only-nobuild --file=test/spec/modules/neuwoRtdProvider_spec.js
 ```
+
+To generate test coverage report for the Neuwo RTD Module:
+
+```bash
+npx gulp test-coverage --file=test/spec/modules/neuwoRtdProvider_spec.js
+```
+
+After running the coverage command, you can view the HTML report:
+
+```bash
+# Open the coverage report in your browser
+firefox build/coverage/lcov-report/index.html
+# or
+google-chrome build/coverage/lcov-report/index.html
+```
+
+Navigate to `modules/neuwoRtdProvider.js` in the report to see detailed line-by-line coverage with highlighted covered/uncovered lines.
diff --git a/test/spec/modules/neuwoRtdProvider_spec.js b/test/spec/modules/neuwoRtdProvider_spec.js
index a8b2ab53280..c13219361f5 100644
--- a/test/spec/modules/neuwoRtdProvider_spec.js
+++ b/test/spec/modules/neuwoRtdProvider_spec.js
@@ -1024,6 +1024,35 @@ describe("neuwoRtdModule", function () {
         neuwo.DATA_PROVIDER
       );
     });
+
+    it("should correctly construct API URL when neuwoApiUrl already contains query parameters", function () {
+      const apiResponse = getNeuwoApiResponse();
+      const bidsConfig = bidsConfiglike();
+      const conf = config();
+      // Set API URL that already has query parameters
+      conf.params.neuwoApiUrl = "https://api.neuwo.ai/v1/analyze?environment=production";
+      conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
+
+      neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+      const request = server.requests[0];
+
+      // Should use & as joiner instead of ?
+      expect(request.url, "URL should contain environment param from base URL").to.include("environment=production");
+      expect(request.url, "URL should contain token param joined with &").to.include("&token=");
+      expect(request.url, "URL should contain url param").to.include("&url=");
+      expect(request.url, "URL should contain product identifier").to.include("&_neuwo_prod=PrebidModule");
+      // Should not have ?? in the URL
+      expect(request.url, "URL should not contain double question marks").to.not.include("??");
+
+      request.respond(
+        200,
+        { "Content-Type": "application/json; encoding=UTF-8" },
+        JSON.stringify(apiResponse)
+      );
+
+      const contentData = bidsConfig.ortb2Fragments.global.site.content.data[0];
+      expect(contentData.name, "Should successfully process response").to.equal(neuwo.DATA_PROVIDER);
+    });
   });
 
   describe("getBidRequestData with caching", function () {
@@ -1263,146 +1292,717 @@ describe("neuwoRtdModule", function () {
           JSON.stringify(apiResponse)
         );
       });
-    });
-  });
 
-  describe("getBidRequestData with URL query param stripping", function () {
-    describe("when stripAllQueryParams is enabled", function () {
-      it("should strip all query parameters from the analyzed URL", function () {
-        const bidsConfig = bidsConfiglike();
+      it("should clear pending request after error response and retry on next call", function (done) {
+        const bidsConfig1 = bidsConfiglike();
+        const bidsConfig2 = bidsConfiglike();
         const conf = config();
-        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?utm_source=test&utm_campaign=example&id=5";
-        conf.params.stripAllQueryParams = true;
+        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=error-test";
+        conf.params.enableCache = true;
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
-        const request = server.requests[0];
+        // First call - will get 404 error
+        neuwo.getBidRequestData(bidsConfig1, () => {
+          // After error, data should not be injected
+          const contentData = bidsConfig1.ortb2Fragments.global?.site?.content?.data;
+          expect(contentData, "No data should be injected after error").to.be.undefined;
 
-        expect(request.url, "The request URL should not contain encoded query params").to.include(
-          encodeURIComponent("https://publisher.works/article.php")
-        );
-        expect(request.url, "The request URL should not contain utm_source").to.not.include(
-          encodeURIComponent("utm_source")
+          // Second call - should retry API (pending should be cleared)
+          neuwo.getBidRequestData(bidsConfig2, () => {
+            try {
+              expect(server.requests.length, "Second call should retry after error").to.equal(2);
+              const contentData2 = bidsConfig2.ortb2Fragments.global?.site?.content?.data?.[0];
+              expect(contentData2, "Second call should have Neuwo data after retry").to.exist;
+              expect(contentData2.name, "Second call should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+              done();
+            } catch (e) {
+              done(e);
+            }
+          }, conf, "consent data");
+
+          // Respond with success to second request
+          const request2 = server.requests[1];
+          request2.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(getNeuwoApiResponse())
+          );
+        }, conf, "consent data");
+
+        expect(server.requests.length, "First call should make an API request").to.equal(1);
+
+        // Respond with error to first request
+        const request1 = server.requests[0];
+        request1.respond(
+          404,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          JSON.stringify({ error: "Not found" })
         );
       });
-    });
 
-    describe("when stripQueryParamsForDomains is enabled", function () {
-      it("should strip query params only for matching domains", function () {
-        const bidsConfig = bidsConfiglike();
+      it("should handle concurrent requests when API returns error", function (done) {
+        const bidsConfig1 = bidsConfiglike();
+        const bidsConfig2 = bidsConfiglike();
+        const bidsConfig3 = bidsConfiglike();
         const conf = config();
-        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?foo=bar&id=5";
-        conf.params.stripQueryParamsForDomains = ["publisher.works"];
+        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=concurrent-error";
+        conf.params.enableCache = true;
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
-        const request = server.requests[0];
+        let callbackCount = 0;
+        const callback = () => {
+          callbackCount++;
+          if (callbackCount === 3) {
+            try {
+              // None of the configs should have data after error
+              const contentData1 = bidsConfig1.ortb2Fragments.global?.site?.content?.data;
+              const contentData2 = bidsConfig2.ortb2Fragments.global?.site?.content?.data;
+              const contentData3 = bidsConfig3.ortb2Fragments.global?.site?.content?.data;
+
+              expect(contentData1, "First config should not have data after error").to.be.undefined;
+              expect(contentData2, "Second config should not have data after error").to.be.undefined;
+              expect(contentData3, "Third config should not have data after error").to.be.undefined;
+              done();
+            } catch (e) {
+              done(e);
+            }
+          }
+        };
 
-        expect(request.url, "The request URL should contain the URL without query params").to.include(
-          encodeURIComponent("https://publisher.works/article.php")
-        );
-        expect(request.url, "The request URL should not contain the id param").to.not.include(
-          encodeURIComponent("id=5")
+        // Make three concurrent calls
+        neuwo.getBidRequestData(bidsConfig1, callback, conf, "consent data");
+        neuwo.getBidRequestData(bidsConfig2, callback, conf, "consent data");
+        neuwo.getBidRequestData(bidsConfig3, callback, conf, "consent data");
+
+        expect(server.requests.length, "Only one API request should be made").to.equal(1);
+
+        // Respond with error
+        const request = server.requests[0];
+        request.respond(
+          500,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          JSON.stringify({ error: "Internal server error" })
         );
       });
 
-      it("should not strip query params for non-matching domains", function () {
+      it("should handle JSON parsing error in success callback", function (done) {
         const bidsConfig = bidsConfiglike();
         const conf = config();
-        conf.params.websiteToAnalyseUrl = "https://other-domain.com/page?foo=bar&id=5";
-        conf.params.stripQueryParamsForDomains = ["publisher.works"];
+        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=parse-error";
+        conf.params.enableCache = true;
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
-        const request = server.requests[0];
+        neuwo.getBidRequestData(bidsConfig, () => {
+          // Callback should still be called
+          const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data;
+          expect(contentData, "No data should be injected after parsing error").to.be.undefined;
+          done();
+        }, conf, "consent data");
 
-        expect(request.url, "The request URL should contain the full URL with query params").to.include(
-          encodeURIComponent("https://other-domain.com/page?foo=bar&id=5")
+        expect(server.requests.length, "Should make an API request").to.equal(1);
+
+        // Respond with invalid JSON
+        const request = server.requests[0];
+        request.respond(
+          200,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          "{ invalid json content }"
         );
       });
 
-      it("should handle subdomain matching correctly", function () {
-        const bidsConfig = bidsConfiglike();
+      it("should not cache response after JSON parsing error and allow retry", function (done) {
+        const bidsConfig1 = bidsConfiglike();
+        const bidsConfig2 = bidsConfiglike();
         const conf = config();
-        conf.params.websiteToAnalyseUrl = "https://sub.publisher.works/page?tracking=123";
-        conf.params.stripQueryParamsForDomains = ["publisher.works"];
+        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=parse-error-retry";
+        conf.params.enableCache = true;
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
-        const request = server.requests[0];
+        neuwo.getBidRequestData(bidsConfig1, () => {
+          // First call with parsing error
+          const contentData1 = bidsConfig1.ortb2Fragments.global?.site?.content?.data;
+          expect(contentData1, "No data after parsing error").to.be.undefined;
 
-        expect(request.url, "The request URL should strip params for subdomain").to.include(
-          encodeURIComponent("https://sub.publisher.works/page")
-        );
-        expect(request.url, "The request URL should not contain tracking param").to.not.include(
-          encodeURIComponent("tracking=123")
+          // Second call should retry (not use cached error)
+          neuwo.getBidRequestData(bidsConfig2, () => {
+            try {
+              expect(server.requests.length, "Should retry after parsing error").to.equal(2);
+              const contentData2 = bidsConfig2.ortb2Fragments.global?.site?.content?.data?.[0];
+              expect(contentData2, "Second call should have valid data").to.exist;
+              expect(contentData2.name, "Should have correct provider").to.equal(neuwo.DATA_PROVIDER);
+              done();
+            } catch (e) {
+              done(e);
+            }
+          }, conf, "consent data");
+
+          // Second request gets valid response
+          const request2 = server.requests[1];
+          request2.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(getNeuwoApiResponse())
+          );
+        }, conf, "consent data");
+
+        // First request gets invalid JSON
+        const request1 = server.requests[0];
+        request1.respond(
+          200,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          "{ this is not valid JSON }"
         );
       });
-    });
 
-    describe("when stripQueryParams is enabled", function () {
-      it("should strip only specified query parameters", function () {
+      it("should handle response with missing marketing_categories", function (done) {
         const bidsConfig = bidsConfiglike();
         const conf = config();
-        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?utm_source=test&utm_campaign=example&id=5";
-        conf.params.stripQueryParams = ["utm_source", "utm_campaign"];
+        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=no-categories";
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
-        const request = server.requests[0];
+        neuwo.getBidRequestData(bidsConfig, () => {
+          // Callback should still be called even without marketing_categories
+          const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data;
+          expect(contentData, "No data should be injected without marketing_categories").to.be.undefined;
+          done();
+        }, conf, "consent data");
 
-        expect(request.url, "The request URL should contain the id param").to.include(
-          encodeURIComponent("id=5")
-        );
-        expect(request.url, "The request URL should not contain utm_source").to.not.include(
-          encodeURIComponent("utm_source")
-        );
-        expect(request.url, "The request URL should not contain utm_campaign").to.not.include(
-          encodeURIComponent("utm_campaign")
+        const request = server.requests[0];
+        request.respond(
+          200,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          JSON.stringify({ brand_safety: { BS_score: "1.0" } }) // Missing marketing_categories
         );
       });
+    });
 
-      it("should handle stripping params that result in no query string", function () {
+    describe("with URL query param stripping", function () {
+      describe("when stripAllQueryParams is enabled", function () {
+        it("should strip all query parameters from the analyzed URL", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?utm_source=test&utm_campaign=example&id=5";
+          conf.params.stripAllQueryParams = true;
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should not contain encoded query params").to.include(
+            encodeURIComponent("https://publisher.works/article.php")
+          );
+          expect(request.url, "The request URL should not contain utm_source").to.not.include(
+            encodeURIComponent("utm_source")
+          );
+        });
+      });
+
+      describe("when stripQueryParamsForDomains is enabled", function () {
+        it("should strip query params only for matching domains", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?foo=bar&id=5";
+          conf.params.stripQueryParamsForDomains = ["publisher.works"];
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should contain the URL without query params").to.include(
+            encodeURIComponent("https://publisher.works/article.php")
+          );
+          expect(request.url, "The request URL should not contain the id param").to.not.include(
+            encodeURIComponent("id=5")
+          );
+        });
+
+        it("should not strip query params for non-matching domains", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://other-domain.com/page?foo=bar&id=5";
+          conf.params.stripQueryParamsForDomains = ["publisher.works"];
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should contain the full URL with query params").to.include(
+            encodeURIComponent("https://other-domain.com/page?foo=bar&id=5")
+          );
+        });
+
+        it("should handle subdomain matching correctly", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://sub.publisher.works/page?tracking=123";
+          conf.params.stripQueryParamsForDomains = ["publisher.works"];
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should strip params for subdomain").to.include(
+            encodeURIComponent("https://sub.publisher.works/page")
+          );
+          expect(request.url, "The request URL should not contain tracking param").to.not.include(
+            encodeURIComponent("tracking=123")
+          );
+        });
+      });
+
+      describe("when stripQueryParams is enabled", function () {
+        it("should strip only specified query parameters", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?utm_source=test&utm_campaign=example&id=5";
+          conf.params.stripQueryParams = ["utm_source", "utm_campaign"];
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should contain the id param").to.include(
+            encodeURIComponent("id=5")
+          );
+          expect(request.url, "The request URL should not contain utm_source").to.not.include(
+            encodeURIComponent("utm_source")
+          );
+          expect(request.url, "The request URL should not contain utm_campaign").to.not.include(
+            encodeURIComponent("utm_campaign")
+          );
+        });
+
+        it("should handle stripping params that result in no query string", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?utm_source=test";
+          conf.params.stripQueryParams = ["utm_source"];
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should not contain a query string").to.include(
+            encodeURIComponent("https://publisher.works/article.php")
+          );
+          expect(request.url, "The request URL should not contain utm_source").to.not.include(
+            encodeURIComponent("utm_source")
+          );
+        });
+
+        it("should leave URL unchanged if specified params do not exist", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          const originalUrl = "https://publisher.works/article.php?id=5";
+          conf.params.websiteToAnalyseUrl = originalUrl;
+          conf.params.stripQueryParams = ["utm_source", "nonexistent"];
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should contain the original URL").to.include(
+            encodeURIComponent(originalUrl)
+          );
+        });
+      });
+
+      describe("when no stripping options are provided", function () {
+        it("should send the URL with all query parameters intact", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          const originalUrl = "https://publisher.works/article.php?get=horrible_url_for_testing&id=5";
+          conf.params.websiteToAnalyseUrl = originalUrl;
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should contain the full original URL").to.include(
+            encodeURIComponent(originalUrl)
+          );
+        });
+      });
+    });
+
+    describe("filterIabTaxonomyTier", function () {
+      it("should return original array when no filter is provided", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2", relevance: "0.5" },
+          { ID: "3", label: "Category 3", relevance: "0.3" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies, {});
+        expect(result, "should return all items when no filter is provided").to.have.lengthOf(3);
+      });
+
+      it("should return original array when filter is empty", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2", relevance: "0.5" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies);
+        expect(result, "should return all items when no filter parameter").to.have.lengthOf(2);
+      });
+
+      it("should filter by threshold only", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2", relevance: "0.5" },
+          { ID: "3", label: "Category 3", relevance: "0.3" },
+          { ID: "4", label: "Category 4", relevance: "0.1" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies, { threshold: 0.4 });
+        expect(result, "should filter out items below threshold").to.have.lengthOf(2);
+        expect(result[0].ID, "should keep highest relevance item").to.equal("1");
+        expect(result[1].ID, "should keep second highest relevance item").to.equal("2");
+      });
+
+      it("should limit by count only", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2", relevance: "0.5" },
+          { ID: "3", label: "Category 3", relevance: "0.3" },
+          { ID: "4", label: "Category 4", relevance: "0.1" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies, { limit: 2 });
+        expect(result, "should limit to specified count").to.have.lengthOf(2);
+        expect(result[0].ID, "should keep highest relevance item").to.equal("1");
+        expect(result[1].ID, "should keep second highest relevance item").to.equal("2");
+      });
+
+      it("should apply both threshold and limit", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.9" },
+          { ID: "2", label: "Category 2", relevance: "0.7" },
+          { ID: "3", label: "Category 3", relevance: "0.6" },
+          { ID: "4", label: "Category 4", relevance: "0.5" },
+          { ID: "5", label: "Category 5", relevance: "0.2" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies, { threshold: 0.5, limit: 2 });
+        expect(result, "should apply both threshold and limit").to.have.lengthOf(2);
+        expect(result[0].ID, "should keep highest relevance item").to.equal("1");
+        expect(result[1].ID, "should keep second highest relevance item").to.equal("2");
+      });
+
+      it("should sort by relevance in descending order", function () {
+        const taxonomies = [
+          { ID: "3", label: "Category 3", relevance: "0.3" },
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2", relevance: "0.5" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies, {});
+        expect(result[0].ID, "first item should have highest relevance").to.equal("1");
+        expect(result[1].ID, "second item should have second highest relevance").to.equal("2");
+        expect(result[2].ID, "third item should have lowest relevance").to.equal("3");
+      });
+
+      it("should handle empty array", function () {
+        const result = neuwo.filterIabTaxonomyTier([], { threshold: 0.5, limit: 2 });
+        expect(result, "should return empty array for empty input").to.be.an("array").that.is.empty;
+      });
+
+      it("should handle null input", function () {
+        const result = neuwo.filterIabTaxonomyTier(null, { threshold: 0.5 });
+        expect(result, "should return null for null input").to.be.null;
+      });
+
+      it("should handle undefined input", function () {
+        const result = neuwo.filterIabTaxonomyTier(undefined, { threshold: 0.5 });
+        expect(result, "should return undefined for undefined input").to.be.undefined;
+      });
+
+      it("should handle items with missing relevance", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2" },
+          { ID: "3", label: "Category 3", relevance: "0.5" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies, { threshold: 0.3 });
+        expect(result, "should handle missing relevance").to.have.lengthOf(2);
+      });
+
+      it("should not mutate original array", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2", relevance: "0.5" },
+          { ID: "3", label: "Category 3", relevance: "0.3" }
+        ];
+        const original = [...taxonomies];
+        neuwo.filterIabTaxonomyTier(taxonomies, { limit: 1 });
+        expect(taxonomies, "should not mutate original array").to.deep.equal(original);
+      });
+
+      it("should sort items with undefined/null relevance to the end", function () {
+        const taxonomies = [
+          { ID: "1", label: "Category 1", relevance: "0.8" },
+          { ID: "2", label: "Category 2" }, // missing relevance
+          { ID: "3", label: "Category 3", relevance: null },
+          { ID: "4", label: "Category 4", relevance: undefined },
+          { ID: "5", label: "Category 5", relevance: "0.5" }
+        ];
+        const result = neuwo.filterIabTaxonomyTier(taxonomies, { limit: 5 });
+        expect(result, "should return all items").to.have.lengthOf(5);
+        expect(result[0].ID, "should have highest relevance first").to.equal("1");
+        expect(result[1].ID, "should have second highest relevance").to.equal("5");
+        // Items with missing/null/undefined relevance should be sorted to the end
+        const lastThreeIds = [result[2].ID, result[3].ID, result[4].ID].sort();
+        expect(lastThreeIds, "items with no relevance should be at the end").to.deep.equal(["2", "3", "4"]);
+      });
+    });
+
+    describe("filterIabTaxonomies", function () {
+      function getTestMarketingCategories() {
+        return {
+          iab_tier_1: [
+            { ID: "1", label: "Cat 1", relevance: "0.9" },
+            { ID: "2", label: "Cat 2", relevance: "0.7" },
+            { ID: "3", label: "Cat 3", relevance: "0.5" }
+          ],
+          iab_tier_2: [
+            { ID: "4", label: "Cat 4", relevance: "0.8" },
+            { ID: "5", label: "Cat 5", relevance: "0.6" }
+          ],
+          iab_audience_tier_3: [
+            { ID: "6", label: "Aud 1", relevance: "0.95" },
+            { ID: "7", label: "Aud 2", relevance: "0.85" },
+            { ID: "8", label: "Aud 3", relevance: "0.75" }
+          ]
+        };
+      }
+
+      it("should return original data when no filters provided", function () {
+        const marketingCategories = getTestMarketingCategories();
+        const result = neuwo.filterIabTaxonomies(marketingCategories, {});
+        expect(result.iab_tier_1, "should return all tier 1 items").to.have.lengthOf(3);
+        expect(result.iab_tier_2, "should return all tier 2 items").to.have.lengthOf(2);
+        expect(result.iab_audience_tier_3, "should return all audience tier 3 items").to.have.lengthOf(3);
+      });
+
+      it("should return original data when filters parameter is undefined", function () {
+        const marketingCategories = getTestMarketingCategories();
+        const result = neuwo.filterIabTaxonomies(marketingCategories);
+        expect(result.iab_tier_1, "should return all tier 1 items").to.have.lengthOf(3);
+      });
+
+      it("should filter ContentTier1 correctly", function () {
+        const marketingCategories = getTestMarketingCategories();
+        const filters = {
+          ContentTier1: { limit: 1, threshold: 0.8 }
+        };
+        const result = neuwo.filterIabTaxonomies(marketingCategories, filters);
+        expect(result.iab_tier_1, "should filter tier 1").to.have.lengthOf(1);
+        expect(result.iab_tier_1[0].ID, "should keep highest relevance item").to.equal("1");
+        expect(result.iab_tier_2, "should not filter tier 2").to.have.lengthOf(2);
+      });
+
+      it("should filter multiple tiers independently", function () {
+        const marketingCategories = getTestMarketingCategories();
+        const filters = {
+          ContentTier1: { limit: 2, threshold: 0.6 },
+          ContentTier2: { limit: 1, threshold: 0.7 },
+          AudienceTier3: { limit: 2, threshold: 0.8 }
+        };
+        const result = neuwo.filterIabTaxonomies(marketingCategories, filters);
+        expect(result.iab_tier_1, "should filter tier 1 to 2 items").to.have.lengthOf(2);
+        expect(result.iab_tier_2, "should filter tier 2 to 1 item").to.have.lengthOf(1);
+        expect(result.iab_tier_2[0].ID, "tier 2 should keep highest item").to.equal("4");
+        expect(result.iab_audience_tier_3, "should filter audience tier 3 to 2 items").to.have.lengthOf(2);
+      });
+
+      it("should handle tier with no matching config", function () {
+        const marketingCategories = getTestMarketingCategories();
+        const filters = {
+          ContentTier1: { limit: 1 }
+        };
+        const result = neuwo.filterIabTaxonomies(marketingCategories, filters);
+        expect(result.iab_tier_1, "should filter configured tier").to.have.lengthOf(1);
+        expect(result.iab_tier_2, "should keep all items in non-configured tier").to.have.lengthOf(2);
+      });
+
+      it("should preserve non-array tier data", function () {
+        const marketingCategories = {
+          iab_tier_1: [{ ID: "1", label: "Cat 1", relevance: "0.9" }],
+          some_other_field: "string value",
+          another_field: 123
+        };
+        const filters = {
+          ContentTier1: { limit: 1 }
+        };
+        const result = neuwo.filterIabTaxonomies(marketingCategories, filters);
+        expect(result.some_other_field, "should preserve string field").to.equal("string value");
+        expect(result.another_field, "should preserve number field").to.equal(123);
+      });
+
+      it("should handle null marketingCategories", function () {
+        const result = neuwo.filterIabTaxonomies(null, { ContentTier1: { limit: 1 } });
+        expect(result, "should return null for null input").to.be.null;
+      });
+
+      it("should handle undefined marketingCategories", function () {
+        const result = neuwo.filterIabTaxonomies(undefined, { ContentTier1: { limit: 1 } });
+        expect(result, "should return undefined for undefined input").to.be.undefined;
+      });
+
+      it("should handle all tier configurations", function () {
+        const marketingCategories = {
+          iab_tier_1: [
+            { ID: "1", label: "C1", relevance: "0.9" },
+            { ID: "2", label: "C2", relevance: "0.5" }
+          ],
+          iab_tier_2: [
+            { ID: "3", label: "C3", relevance: "0.8" },
+            { ID: "4", label: "C4", relevance: "0.4" }
+          ],
+          iab_tier_3: [
+            { ID: "5", label: "C5", relevance: "0.7" },
+            { ID: "6", label: "C6", relevance: "0.3" }
+          ],
+          iab_audience_tier_3: [
+            { ID: "7", label: "A1", relevance: "0.95" },
+            { ID: "8", label: "A2", relevance: "0.45" }
+          ],
+          iab_audience_tier_4: [
+            { ID: "9", label: "A3", relevance: "0.85" },
+            { ID: "10", label: "A4", relevance: "0.35" }
+          ],
+          iab_audience_tier_5: [
+            { ID: "11", label: "A5", relevance: "0.75" },
+            { ID: "12", label: "A6", relevance: "0.25" }
+          ]
+        };
+        const filters = {
+          ContentTier1: { limit: 1, threshold: 0.8 },
+          ContentTier2: { limit: 1, threshold: 0.7 },
+          ContentTier3: { limit: 1, threshold: 0.6 },
+          AudienceTier3: { limit: 1, threshold: 0.9 },
+          AudienceTier4: { limit: 1, threshold: 0.8 },
+          AudienceTier5: { limit: 1, threshold: 0.7 }
+        };
+        const result = neuwo.filterIabTaxonomies(marketingCategories, filters);
+        expect(result.iab_tier_1, "ContentTier1 filtered").to.have.lengthOf(1);
+        expect(result.iab_tier_2, "ContentTier2 filtered").to.have.lengthOf(1);
+        expect(result.iab_tier_3, "ContentTier3 filtered").to.have.lengthOf(1);
+        expect(result.iab_audience_tier_3, "AudienceTier3 filtered").to.have.lengthOf(1);
+        expect(result.iab_audience_tier_4, "AudienceTier4 filtered").to.have.lengthOf(1);
+        expect(result.iab_audience_tier_5, "AudienceTier5 filtered").to.have.lengthOf(1);
+      });
+    });
+
+    describe("with iabTaxonomyFilters", function () {
+      it("should work without filtering when no iabTaxonomyFilters provided", function (done) {
         const bidsConfig = bidsConfiglike();
         const conf = config();
-        conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?utm_source=test";
-        conf.params.stripQueryParams = ["utm_source"];
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
-        const request = server.requests[0];
-
-        expect(request.url, "The request URL should not contain a query string").to.include(
-          encodeURIComponent("https://publisher.works/article.php")
-        );
-        expect(request.url, "The request URL should not contain utm_source").to.not.include(
-          encodeURIComponent("utm_source")
+        neuwo.getBidRequestData(
+          bidsConfig,
+          () => {
+            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+
+            expect(contentData, "should have content data").to.exist;
+            expect(contentData.segment, "should have unfiltered content segments").to.have.lengthOf(2);
+            expect(userData, "should have user data").to.exist;
+            expect(userData.segment, "should have unfiltered audience segments").to.have.lengthOf(3);
+            done();
+          },
+          conf,
+          "consent data"
         );
+
+        const request = server.requests[0];
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
       });
 
-      it("should leave URL unchanged if specified params do not exist", function () {
+      it("should apply filtering when iabTaxonomyFilters are provided", function (done) {
         const bidsConfig = bidsConfiglike();
         const conf = config();
-        const originalUrl = "https://publisher.works/article.php?id=5";
-        conf.params.websiteToAnalyseUrl = originalUrl;
-        conf.params.stripQueryParams = ["utm_source", "nonexistent"];
+        conf.params.iabTaxonomyFilters = {
+          ContentTier1: { limit: 1, threshold: 0.4 },
+          AudienceTier3: { limit: 1, threshold: 0.9 }
+        };
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
-        const request = server.requests[0];
+        neuwo.getBidRequestData(
+          bidsConfig,
+          () => {
+            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
 
-        expect(request.url, "The request URL should contain the original URL").to.include(
-          encodeURIComponent(originalUrl)
+            expect(contentData, "should have content data").to.exist;
+            expect(contentData.segment, "should have filtered content segments").to.have.lengthOf(2);
+
+            // Check that tier 1 was limited to 1
+            const tier1Items = contentData.segment.filter(s => s.id === "274");
+            expect(tier1Items, "should have only 1 tier 1 item").to.have.lengthOf(1);
+
+            expect(userData, "should have user data").to.exist;
+            // Audience tier 3 should be filtered to 1, but tiers 4 and 5 should remain
+            expect(userData.segment, "should have filtered audience segments").to.have.lengthOf(3);
+
+            done();
+          },
+          conf,
+          "consent data"
         );
+
+        const request = server.requests[0];
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
       });
-    });
 
-    describe("when no stripping options are provided", function () {
-      it("should send the URL with all query parameters intact", function () {
+      it("should apply strict filtering that removes all low-relevance items", function (done) {
         const bidsConfig = bidsConfiglike();
         const conf = config();
-        const originalUrl = "https://publisher.works/article.php?get=horrible_url_for_testing&id=5";
-        conf.params.websiteToAnalyseUrl = originalUrl;
+        conf.params.iabTaxonomyFilters = {
+          ContentTier1: { threshold: 0.9 }, // Only keep items with 90%+ relevance
+          ContentTier2: { threshold: 0.9 },
+          AudienceTier4: { threshold: 0.99 },
+          AudienceTier5: { threshold: 0.99 }
+        };
+
+        neuwo.getBidRequestData(
+          bidsConfig,
+          () => {
+            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+
+            expect(contentData, "should have content data").to.exist;
+            // Tier 1 has 0.47, Tier 2 has 0.41 - both below 0.9 threshold
+            // Only tier 3 (empty) should remain, resulting in no segments
+            expect(contentData.segment, "should have no content segments due to strict filtering").to.have.lengthOf(0);
+
+            expect(userData, "should have user data").to.exist;
+            // Tier 3 has 0.9923 (passes), Tier 4 has 0.9673 (fails), Tier 5 has 0.9066 (fails)
+            expect(userData.segment, "should have only 1 audience segment").to.have.lengthOf(1);
+
+            done();
+          },
+          conf,
+          "consent data"
+        );
 
-        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
         const request = server.requests[0];
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
+      });
 
-        expect(request.url, "The request URL should contain the full original URL").to.include(
-          encodeURIComponent(originalUrl)
+      it("should handle filtering with cached response", function (done) {
+        const bidsConfig1 = bidsConfiglike();
+        const bidsConfig2 = bidsConfiglike();
+        const conf = config();
+        conf.params.iabTaxonomyFilters = {
+          ContentTier1: { limit: 1 }
+        };
+
+        // First request
+        neuwo.getBidRequestData(
+          bidsConfig1,
+          () => {
+          // Second request (should use cache)
+            neuwo.getBidRequestData(
+              bidsConfig2,
+              () => {
+                const contentData = bidsConfig2.ortb2Fragments.global?.site?.content?.data?.[0];
+                expect(contentData, "should have content data from cache").to.exist;
+                expect(contentData.segment, "should apply filtering to cached response").to.have.lengthOf(2);
+                done();
+              },
+              conf,
+              "consent data"
+            );
+          },
+          conf,
+          "consent data"
         );
+
+        const request = server.requests[0];
+        expect(server.requests, "should only make one API request").to.have.lengthOf(1);
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
       });
     });
   });

From e451de57115fbbdc0515f89834822333681914f5 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Mon, 12 Jan 2026 12:17:31 +0100
Subject: [PATCH 14/24] style: apply formatting to Neuwo RTD Module markdown
 documentation

---
 modules/neuwoRtdProvider.md | 37 +++++++++++++++++++++----------------
 1 file changed, 21 insertions(+), 16 deletions(-)

diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index ec606792153..7cbec18f54c 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -105,7 +105,7 @@ pbjs.setConfig({
 | `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains. |
 | `params.stripQueryParams`           | String[] | No       | `[]`    | List of specific query parameter names to strip from the URL (e.g., `['utm_source', 'fbclid']`). Other parameters are preserved. Only applies when the domain does not match `stripQueryParamsForDomains`.                                                                                                                 |
 | `params.stripFragments`             | Boolean  | No       | `false` | If `true`, strips URL fragments (hash, e.g., `#section`) from the URL before analysis.                                                                                                                                                                                                                                     |
-| `params.iabTaxonomyFilters`         | Object   | No       |         | Per-tier filtering configuration for IAB taxonomies. Allows filtering by relevance threshold and limiting the count of categories per tier. See [IAB Taxonomy Filtering](#iab-taxonomy-filtering) section below for details.                                                                                                |
+| `params.iabTaxonomyFilters`         | Object   | No       |         | Per-tier filtering configuration for IAB taxonomies. Allows filtering by relevance threshold and limiting the count of categories per tier. See [IAB Taxonomy Filtering](#iab-taxonomy-filtering) section below for details.                                                                                               |
 
 ### API Response Caching
 
@@ -155,19 +155,20 @@ The module provides optional per-tier filtering for IAB taxonomies to control th
 **Filter Configuration:**
 
 Each tier can have two optional parameters:
+
 - `threshold` (Number): Minimum relevance score (0.0 to 1.0). Categories below this threshold are excluded.
 - `limit` (Number): Maximum number of categories to include for this tier (after filtering and sorting by relevance).
 
 **Available Tiers:**
 
-| Tier Name        | Description                  | API Response Key         |
-| :--------------- | :--------------------------- | :----------------------- |
-| `ContentTier1`   | IAB Content Tier 1           | `iab_tier_1`             |
-| `ContentTier2`   | IAB Content Tier 2           | `iab_tier_2`             |
-| `ContentTier3`   | IAB Content Tier 3           | `iab_tier_3`             |
-| `AudienceTier3`  | IAB Audience Tier 3          | `iab_audience_tier_3`    |
-| `AudienceTier4`  | IAB Audience Tier 4          | `iab_audience_tier_4`    |
-| `AudienceTier5`  | IAB Audience Tier 5          | `iab_audience_tier_5`    |
+| Tier Name       | Description         | API Response Key      |
+| :-------------- | :------------------ | :-------------------- |
+| `ContentTier1`  | IAB Content Tier 1  | `iab_tier_1`          |
+| `ContentTier2`  | IAB Content Tier 2  | `iab_tier_2`          |
+| `ContentTier3`  | IAB Content Tier 3  | `iab_tier_3`          |
+| `AudienceTier3` | IAB Audience Tier 3 | `iab_audience_tier_3` |
+| `AudienceTier4` | IAB Audience Tier 4 | `iab_audience_tier_4` |
+| `AudienceTier5` | IAB Audience Tier 5 | `iab_audience_tier_5` |
 
 **Example with IAB taxonomy filtering:**
 
@@ -227,23 +228,27 @@ The Neuwo RTD module enriches bid requests with contextual data that can be acce
 Listen to the `bidRequested` event to access the enriched ORTB2 data. This event fires early in the auction lifecycle and provides direct access to the Neuwo data:
 
 ```javascript
-pbjs.que.push(function() {
-  pbjs.onEvent('bidRequested', function(bidRequest) {
+pbjs.que.push(function () {
+  pbjs.onEvent("bidRequested", function (bidRequest) {
     // The ortb2 data is available directly on the bidRequest
     const ortb2 = bidRequest.ortb2;
 
     // Extract Neuwo-specific data (from www.neuwo.ai provider)
-    const neuwoSiteData = ortb2?.site?.content?.data?.find(d => d.name === 'www.neuwo.ai');
-    const neuwoUserData = ortb2?.user?.data?.find(d => d.name === 'www.neuwo.ai');
+    const neuwoSiteData = ortb2?.site?.content?.data?.find(
+      (d) => d.name === "www.neuwo.ai"
+    );
+    const neuwoUserData = ortb2?.user?.data?.find(
+      (d) => d.name === "www.neuwo.ai"
+    );
 
     // Use the data in the application
-    console.log('Neuwo Site Content:', neuwoSiteData);
-    console.log('Neuwo User Data:', neuwoUserData);
+    console.log("Neuwo Site Content:", neuwoSiteData);
+    console.log("Neuwo User Data:", neuwoUserData);
 
     // Example: Store in a global variable for later use
     window.neuwoData = {
       siteContent: neuwoSiteData,
-      user: neuwoUserData
+      user: neuwoUserData,
     };
   });
 });

From 10d5faf3ff841b0bbd3ce2f8cd9df1010e448f61 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Mon, 19 Jan 2026 08:37:10 +0100
Subject: [PATCH 15/24] refactor: remove name field from IAB segments in ORTB2
 output

- Update `buildIabData()` to only include `id` in segment objects
- Remove `label` requirement; segments now only need valid `ID`
- Update documentation examples to reflect simplified segment structure
- Update unit tests to match new segment format
---
 modules/neuwoRtdProvider.js                |  5 +-
 modules/neuwoRtdProvider.md                | 36 ++++-----------
 test/spec/modules/neuwoRtdProvider_spec.js | 53 +++++++---------------
 3 files changed, 29 insertions(+), 65 deletions(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index 30b4d92ec52..b899c82a01e 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -380,10 +380,9 @@ export function buildIabData(marketingCategories, tiers, segtax) {
     if (Array.isArray(tierData)) {
       tierData.forEach((item) => {
         const ID = item?.ID;
-        const label = item?.label;
 
-        if (ID && label) {
-          data.segment.push({ id: ID, name: label });
+        if (ID) {
+          data.segment.push({ id: ID });
         }
       });
     }
diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index 7cbec18f54c..acf0ca4dfa1 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -19,46 +19,30 @@ ortb2: {
       // IAB Content Taxonomy data is injected here
       data: [{
         name: "www.neuwo.ai",
-        segment: [{
-            id: "274",
-            name: "Home & Garden",
-          },
-          {
-            id: "42",
-            name: "Books and Literature",
-          },
-          {
-            id: "210",
-            name: "Food & Drink",
-          },
+        segment: [
+          { id: "274" },
+          { id: "42" },
+          { id: "210" },
         ],
         ext: {
           segtax: 7,
         },
-      }, ],
+      }],
     },
   },
   user: {
     // IAB Audience Taxonomy data is injected here
     data: [{
       name: "www.neuwo.ai",
-      segment: [{
-          id: "49",
-          name: "Demographic | Gender | Female |",
-        },
-        {
-          id: "161",
-          name: "Demographic | Marital Status | Married |",
-        },
-        {
-          id: "6",
-          name: "Demographic | Age Range | 30-34 |",
-        },
+      segment: [
+        { id: "49" },
+        { id: "161" },
+        { id: "6" },
       ],
       ext: {
         segtax: 4,
       },
-    }, ],
+    }],
   },
 }
 ```
diff --git a/test/spec/modules/neuwoRtdProvider_spec.js b/test/spec/modules/neuwoRtdProvider_spec.js
index c13219361f5..5f699da6c9f 100644
--- a/test/spec/modules/neuwoRtdProvider_spec.js
+++ b/test/spec/modules/neuwoRtdProvider_spec.js
@@ -150,14 +150,8 @@ describe("neuwoRtdModule", function () {
       const expected = {
         name: neuwo.DATA_PROVIDER,
         segment: [
-          {
-            id: "274",
-            name: "Home & Garden",
-          },
-          {
-            id: "216",
-            name: "Cooking",
-          },
+          { id: "274" },
+          { id: "216" },
         ],
         ext: {
           segtax,
@@ -175,18 +169,9 @@ describe("neuwoRtdModule", function () {
       const expected = {
         name: neuwo.DATA_PROVIDER,
         segment: [
-          {
-            id: "49",
-            name: "Demographic | Gender | Female |",
-          },
-          {
-            id: "127",
-            name: "Demographic | Household Data | 1 Child |",
-          },
-          {
-            id: "98",
-            name: "Demographic | Household Data | Parents with Children |",
-          },
+          { id: "49" },
+          { id: "127" },
+          { id: "98" },
         ],
         ext: {
           segtax,
@@ -243,7 +228,6 @@ describe("neuwoRtdModule", function () {
         segment: [
           {
             id: "216",
-            name: "Cooking",
           },
         ],
         ext: {
@@ -261,7 +245,6 @@ describe("neuwoRtdModule", function () {
       // Overwrite iab_tier_1 with various malformed objects
       marketingCategories.iab_tier_1 = [
         { ID: "274", label: "Valid Object" },
-        { ID: "999" }, // Missing 'label' property
         { label: "Another Label" }, // Missing 'ID' property
         null, // A null value
         "just-a-string", // A string primitive
@@ -276,11 +259,9 @@ describe("neuwoRtdModule", function () {
         segment: [
           {
             id: "274",
-            name: "Valid Object",
           },
           {
             id: "216",
-            name: "Cooking",
           },
         ],
         ext: {
@@ -362,9 +343,9 @@ describe("neuwoRtdModule", function () {
           "The first segment ID should match the API response"
         ).to.equal(apiResponse.marketing_categories.iab_tier_1[0].ID);
         expect(
-          contentData.segment[1].name,
-          "The second segment name should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].label);
+          contentData.segment[1].id,
+          "The second segment ID should match the API response"
+        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].ID);
       });
     });
 
@@ -407,9 +388,9 @@ describe("neuwoRtdModule", function () {
           "The first segment ID should match the API response"
         ).to.equal(apiResponse.marketing_categories.iab_tier_1[0].ID);
         expect(
-          contentData.segment[1].name,
-          "The second segment name should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].label);
+          contentData.segment[1].id,
+          "The second segment ID should match the API response"
+        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].ID);
       });
     });
 
@@ -452,9 +433,9 @@ describe("neuwoRtdModule", function () {
           "The first segment ID should match the API response"
         ).to.equal(apiResponse.marketing_categories.iab_tier_1[0].ID);
         expect(
-          contentData.segment[1].name,
-          "The second segment name should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].label);
+          contentData.segment[1].id,
+          "The second segment ID should match the API response"
+        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].ID);
       });
     });
 
@@ -496,9 +477,9 @@ describe("neuwoRtdModule", function () {
           "The first segment ID should match the API response"
         ).to.equal(apiResponse.marketing_categories.iab_audience_tier_3[0].ID);
         expect(
-          userData.segment[1].name,
-          "The second segment name should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_audience_tier_4[0].label);
+          userData.segment[1].id,
+          "The second segment ID should match the API response"
+        ).to.equal(apiResponse.marketing_categories.iab_audience_tier_4[0].ID);
       });
     });
 

From 22b5cc8eb905ffaa23269604366f7bc5c2e390c7 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 21 Jan 2026 08:58:02 +0100
Subject: [PATCH 16/24] feat: migrate Neuwo RTD Module to new API architecture
 (v2.0.0) and maintain backward compatibility

- Add version 2.0.0 with multi-version IAB Content Taxonomy support
- Implement automatic API capability detection from endpoint URL format
- Maintain backward compatibility with legacy GET endpoints
- Consolidate default IAB Content Taxonomy version to "2.2" constant
- Transform legacy API responses to unified segtax-based format
- Add `buildIabFilterConfig()` for filter configuration conversion
- Add `transformV1ResponseToV2()` and `transformSegmentsV1ToV2()` helpers
- Refactor `buildIabData()` to dynamically process all tiers
- Update `injectIabCategories()` to work with unified response format
- Enhance JSDoc documentation with format examples and API details
- Add conditional logging for POST request bodies
- Optimise filtering: apply once before caching for legacy endpoints
---
 modules/neuwoRtdProvider.js | 327 ++++++++++++++++++++++++++----------
 1 file changed, 242 insertions(+), 85 deletions(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index b899c82a01e..bb653036c43 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -1,5 +1,6 @@
 /**
  * @module neuwoRtdProvider
+ * @version 2.0.0
  * @author Grzegorz Malisz
  * @see {project-root-directory}/integrationExamples/gpt/neuwoRtdProvider_example.html for an example/testing page.
  * @see {project-root-directory}/test/spec/modules/neuwoRtdProvider_spec.js for unit tests.
@@ -7,7 +8,7 @@
  * This module is a Prebid.js Real-Time Data (RTD) provider that integrates with the Neuwo API.
  *
  * It fetches contextual marketing categories (IAB content and audience) for the current page from the Neuwo API.
- * The retrieved data is then injected into the bid request as OpenRTB (ORTB2)`site.content.data`
+ * The retrieved data is then injected into the bid request as OpenRTB (ORTB2) `site.content.data`
  * and `user.data` fragments, making it available for bidders to use in their decisioning process.
  *
  * @see {@link https://docs.prebid.org/dev-docs/add-rtd-submodule.html} for more information on development of Prebid.js RTD modules.
@@ -23,6 +24,9 @@ import { deepSetValue, logError, logInfo, mergeDeep } from "../src/utils.js";
 const MODULE_NAME = "NeuwoRTDModule";
 export const DATA_PROVIDER = "www.neuwo.ai";
 
+// Default IAB Content Taxonomy version
+const DEFAULT_IAB_CONTENT_TAXONOMY_VERSION = "2.2";
+
 // Cached API response to avoid redundant requests.
 let globalCachedResponse;
 // In-flight request promise to prevent duplicate API calls during the same request cycle.
@@ -73,6 +77,9 @@ function init(config, userConsent) {
 /**
  * Fetches contextual data from the Neuwo API and enriches the bid request object with IAB categories.
  * Uses cached response if available to avoid redundant API calls.
+ * Automatically detects API capabilities from the endpoint URL format:
+ * - URLs containing "/v1/iab" use POST requests with server-side filtering
+ * - Other URLs use GET requests with client-side filtering (legacy support)
  *
  * @param {Object} reqBidsConfigObj The bid request configuration object.
  * @param {function} callback The callback function to continue the auction.
@@ -81,13 +88,13 @@ function init(config, userConsent) {
  * @param {string} config.params.neuwoApiUrl The Neuwo API endpoint URL.
  * @param {string} config.params.neuwoApiToken The Neuwo API authentication token.
  * @param {string} [config.params.websiteToAnalyseUrl] Optional URL to analyze instead of current page.
- * @param {string} [config.params.iabContentTaxonomyVersion] IAB content taxonomy version (default: "3.0").
- * @param {boolean} [config.params.enableCache=true] If true, caches API responses to avoid redundant requests (default: true).
+ * @param {string} [config.params.iabContentTaxonomyVersion="2.2"] IAB Content Taxonomy version.
+ * @param {boolean} [config.params.enableCache=true] If true, caches API responses to avoid redundant requests.
  * @param {boolean} [config.params.stripAllQueryParams] If true, strips all query parameters from the URL.
  * @param {string[]} [config.params.stripQueryParamsForDomains] List of domains for which to strip all query params.
  * @param {string[]} [config.params.stripQueryParams] List of specific query parameter names to strip.
  * @param {boolean} [config.params.stripFragments] If true, strips URL fragments (hash).
- * @param {Object} [config.params.iabTaxonomyFilters] Per-tier filtering configuration for IAB taxonomies.
+ * @param {Object} [config.params.iabTaxonomyFilters] Per-tier filtering configuration for IAB Taxonomies.
  * @param {Object} userConsent The user consent object.
  */
 export function getBidRequestData(
@@ -107,7 +114,7 @@ export function getBidRequestData(
     websiteToAnalyseUrl,
     neuwoApiUrl,
     neuwoApiToken,
-    iabContentTaxonomyVersion,
+    iabContentTaxonomyVersion = DEFAULT_IAB_CONTENT_TAXONOMY_VERSION,
     enableCache = true,
     stripAllQueryParams,
     stripQueryParamsForDomains,
@@ -124,16 +131,33 @@ export function getBidRequestData(
     stripFragments,
   });
   const pageUrl = encodeURIComponent(processedUrl);
-  // Adjusted for pages api.url?prefix=test (to add params with '&') as well as api.url (to add params with '?')
+  const contentSegtax =
+    IAB_CONTENT_TAXONOMY_MAP[iabContentTaxonomyVersion] ||
+    IAB_CONTENT_TAXONOMY_MAP[DEFAULT_IAB_CONTENT_TAXONOMY_VERSION];
+
+  // Detect API version from URL
+  const isV2Api = neuwoApiUrl.includes("/v1/iab");
+
+  // Build IAB filter configuration
+  const iabFilterConfig = buildIabFilterConfig(
+    iabTaxonomyFilters,
+    contentSegtax
+  );
+
   const joiner = neuwoApiUrl.indexOf("?") < 0 ? "?" : "&";
-  const neuwoApiUrlFull =
-    neuwoApiUrl +
-    joiner +
-    [
-      "token=" + neuwoApiToken,
-      "url=" + pageUrl,
-      "_neuwo_prod=PrebidModule",
-    ].join("&");
+  const urlParams = [
+    "token=" + neuwoApiToken,
+    "url=" + pageUrl,
+    "_neuwo_prod=PrebidModule",
+  ];
+
+  // Request both IAB Content Taxonomy (based on config) and IAB Audience Taxonomy (segtax 4)
+  if (isV2Api) {
+    urlParams.push("iabVersions=" + contentSegtax);
+    urlParams.push("iabVersions=4"); // IAB Audience 1.1
+  }
+
+  const neuwoApiUrlFull = neuwoApiUrl + joiner + urlParams.join("&");
 
   // Cache flow: cached response -> pending request -> new request
   // Each caller gets their own callback invoked when data is ready.
@@ -149,8 +173,7 @@ export function getBidRequestData(
     injectIabCategories(
       globalCachedResponse,
       reqBidsConfigObj,
-      iabContentTaxonomyVersion,
-      iabTaxonomyFilters
+      iabContentTaxonomyVersion
     );
     callback();
   } else if (enableCache && pendingRequest) {
@@ -167,8 +190,7 @@ export function getBidRequestData(
           injectIabCategories(
             responseParsed,
             reqBidsConfigObj,
-            iabContentTaxonomyVersion,
-            iabTaxonomyFilters
+            iabContentTaxonomyVersion
           );
         }
       })
@@ -180,7 +202,8 @@ export function getBidRequestData(
       "getBidRequestData():",
       "Cache System:",
       "Calling Neuwo API Endpoint:",
-      neuwoApiUrlFull
+      neuwoApiUrlFull,
+      ...(isV2Api ? ["Body:", iabFilterConfig] : [])
     );
 
     const requestPromise = new Promise((resolve) => {
@@ -196,16 +219,31 @@ export function getBidRequestData(
               response
             );
             try {
-              const responseParsed = JSON.parse(response);
+              let responseParsed = JSON.parse(response);
+
+              if (!isV2Api) {
+                // Apply per-tier filtering to V1 format
+                const filteredMarketingCategories = filterIabTaxonomies(
+                  responseParsed.marketing_categories,
+                  iabTaxonomyFilters
+                );
+
+                // Transform filtered V1 response to unified internal format
+                responseParsed = transformV1ResponseToV2(
+                  { marketing_categories: filteredMarketingCategories },
+                  contentSegtax
+                );
+              }
+
               // Cache response
               if (enableCache) {
                 globalCachedResponse = responseParsed;
               }
+
               injectIabCategories(
                 responseParsed,
                 reqBidsConfigObj,
-                iabContentTaxonomyVersion,
-                iabTaxonomyFilters
+                iabContentTaxonomyVersion
               );
               resolve(responseParsed);
             } catch (ex) {
@@ -230,7 +268,10 @@ export function getBidRequestData(
             resolve(null);
           },
         },
-        null
+        isV2Api ? JSON.stringify(iabFilterConfig) : null,
+        isV2Api
+          ? { method: "POST", contentType: "application/json" }
+          : undefined
       );
     });
 
@@ -361,28 +402,32 @@ export function injectOrtbData(reqBidsConfigObj, path, data) {
 }
 
 /**
- * Builds an IAB category data object for use in OpenRTB.
+ * Builds an IAB category data object for OpenRTB injection.
+ * Dynamically processes all tiers present in the response data.
  *
- * @param {Object} marketingCategories Marketing Categories returned by Neuwo API.
- * @param {string[]} tiers The tier keys to extract from marketingCategories.
- * @param {number} segtax The IAB taxonomy version Id.
- * @returns {Object} The constructed data object.
+ * @param {Object} tierData The tier data keyed by tier numbers (e.g., {"1": [...], "2": [...], "3": [...]}).
+ * @param {number} segtax The IAB Taxonomy segtax ID.
+ * @returns {Object} The OpenRTB data object with name, segment array, and ext.segtax.
  */
-export function buildIabData(marketingCategories, tiers, segtax) {
+export function buildIabData(tierData, segtax) {
   const data = {
     name: DATA_PROVIDER,
     segment: [],
     ext: { segtax },
   };
 
-  tiers.forEach((tier) => {
-    const tierData = marketingCategories?.[tier];
-    if (Array.isArray(tierData)) {
-      tierData.forEach((item) => {
-        const ID = item?.ID;
+  // Handle null, undefined, or non-object tierData
+  if (!tierData || typeof tierData !== "object") {
+    return data;
+  }
 
-        if (ID) {
-          data.segment.push({ id: ID });
+  // Process ALL tier keys present in tierData
+  Object.keys(tierData).forEach((tierKey) => {
+    const segments = tierData[tierKey];
+    if (Array.isArray(segments)) {
+      segments.forEach((item) => {
+        if (item?.id) {
+          data.segment.push({ id: item.id });
         }
       });
     }
@@ -392,11 +437,13 @@ export function buildIabData(marketingCategories, tiers, segtax) {
 }
 
 /**
+ * v1 API specific
  * Filters and limits a single tier's taxonomies based on relevance score and count.
+ * Used for client-side filtering with legacy endpoints.
  *
- * @param {Array} iabTaxonomies Array of taxonomy objects with ID, label, and relevance
- * @param {Object} filter Filter configuration for this tier
- * @returns {Array} Filtered and limited array of taxonomies
+ * @param {Array} iabTaxonomies Array of IAB Taxonomy Segments objects with ID, label, and relevance.
+ * @param {Object} filter Filter configuration with optional threshold and limit properties.
+ * @returns {Array} Filtered and limited array of taxonomies, sorted by relevance (highest first).
  */
 export function filterIabTaxonomyTier(iabTaxonomies, filter = {}) {
   if (!Array.isArray(iabTaxonomies) || iabTaxonomies.length === 0) {
@@ -442,11 +489,12 @@ const TIER_KEY_MAP = {
 };
 
 /**
- * Applies per-tier filtering to all IAB taxonomies.
+ * v1 API specific
+ * Applies per-tier filtering to IAB taxonomies (client-side filtering for legacy endpoints).
  * Filters taxonomies by relevance score and limits the count per tier.
  *
- * @param {Object} marketingCategories Marketing Categories returned by Neuwo API.
- * @param {Object} [tierFilters] Per-tier filter configuration keyed by config tier names (e.g., {ContentTier1: {limit: 3, threshold: 0.75}}).
+ * @param {Object} marketingCategories Marketing categories from legacy API response.
+ * @param {Object} [tierFilters] Per-tier filter configuration with human-readable tier names (e.g., {ContentTier1: {limit: 3, threshold: 0.75}}).
  * @returns {Object} Filtered marketing categories with the same structure as input.
  */
 export function filterIabTaxonomies(marketingCategories, tierFilters = {}) {
@@ -494,57 +542,157 @@ export function filterIabTaxonomies(marketingCategories, tierFilters = {}) {
     "Original:",
     marketingCategories,
     "Filtered:",
-    filtered,
+    filtered
   );
 
   return filtered;
 }
 
 /**
- * Processes the Neuwo API response to build and inject IAB content and audience categories
- * into the bid request object.
+ * v1 API specific
+ * Transforms legacy API response format to unified internal format.
+ * Converts marketing_categories structure to segtax-based structure for consistent processing.
+ *
+ * Legacy format: { marketing_categories: { iab_tier_1: [...], iab_audience_tier_3: [...] } }
+ * Unified format: { "6": { "1": [...], "2": [...] }, "4": { "3": [...], "4": [...] } }
+ *
+ * @param {Object} v1Response The legacy API response with marketing_categories structure.
+ * @param {number} contentSegtax The segtax ID for content taxonomies (determined by iabContentTaxonomyVersion).
+ * @returns {Object} Unified format response keyed by segtax and tier numbers.
+ */
+export function transformV1ResponseToV2(v1Response, contentSegtax) {
+  const marketingCategories = v1Response?.marketing_categories || {};
+  const contentSegtaxStr = String(contentSegtax);
+  const result = {};
+
+  // Content tiers → segtax from config
+  result[contentSegtaxStr] = {};
+  if (marketingCategories.iab_tier_1) {
+    result[contentSegtaxStr]["1"] = transformSegmentsV1ToV2(
+      marketingCategories.iab_tier_1
+    );
+  }
+  if (marketingCategories.iab_tier_2) {
+    result[contentSegtaxStr]["2"] = transformSegmentsV1ToV2(
+      marketingCategories.iab_tier_2
+    );
+  }
+  if (marketingCategories.iab_tier_3) {
+    result[contentSegtaxStr]["3"] = transformSegmentsV1ToV2(
+      marketingCategories.iab_tier_3
+    );
+  }
+
+  // Audience tiers → segtax 4
+  result["4"] = {};
+  if (marketingCategories.iab_audience_tier_3) {
+    result["4"]["3"] = transformSegmentsV1ToV2(
+      marketingCategories.iab_audience_tier_3
+    );
+  }
+  if (marketingCategories.iab_audience_tier_4) {
+    result["4"]["4"] = transformSegmentsV1ToV2(
+      marketingCategories.iab_audience_tier_4
+    );
+  }
+  if (marketingCategories.iab_audience_tier_5) {
+    result["4"]["5"] = transformSegmentsV1ToV2(
+      marketingCategories.iab_audience_tier_5
+    );
+  }
+
+  return result;
+}
+
+/**
+ * v1 API specific
+ * Transforms segment objects from legacy format to unified format.
+ * Maps field names from legacy API response to unified internal representation.
+ *
+ * Legacy format: { ID: "123", label: "Category Name", relevance: "0.95" }
+ * Unified format: { id: "123", name: "Category Name", relevance: "0.95" }
+ *
+ * @param {Array} segments Array of legacy segment objects with ID, label, relevance.
+ * @returns {Array} Array of unified format segment objects with id, name, relevance.
+ */
+export function transformSegmentsV1ToV2(segments) {
+  if (!Array.isArray(segments)) return [];
+  return segments.map((seg) => ({
+    id: seg.ID,
+    name: seg.label,
+    relevance: seg.relevance,
+  }));
+}
+
+/**
+ * Builds IAB filter configuration from publisher settings.
+ * Converts human-readable tier names to segtax-based structure for API communication.
+ *
+ * Input format:  { ContentTier1: { limit: 3, threshold: 0.5 }, AudienceTier3: { limit: 5 } }
+ * Output format: { "6": { "1": { limit: 3, threshold: 0.5 } }, "4": { "3": { limit: 5 } } }
  *
- * @param {Object} responseParsed The parsed JSON response from the Neuwo API.
- * @param {Object} reqBidsConfigObj The bid request configuration object to be modified.
- * @param {string} iabContentTaxonomyVersion The version of the IAB content taxonomy to use for segtax mapping.
- * @param {Object} [iabTaxonomyFilters] Per-tier filter configuration (e.g., {ContentTier1: {limit: 3, threshold: 0.75}}).
+ * @param {Object} iabTaxonomyFilters Publisher's tier filter configuration using human-readable tier names.
+ * @param {number} contentSegtax The segtax ID for content taxonomies (determined by iabContentTaxonomyVersion).
+ * @returns {Object} Filter configuration in segtax-based structure.
  */
-function injectIabCategories(
+export function buildIabFilterConfig(iabTaxonomyFilters, contentSegtax) {
+  const TIER_TO_SEGTAX = {
+    ContentTier1: { segtax: contentSegtax, tier: "1" },
+    ContentTier2: { segtax: contentSegtax, tier: "2" },
+    ContentTier3: { segtax: contentSegtax, tier: "3" },
+    AudienceTier3: { segtax: 4, tier: "3" },
+    AudienceTier4: { segtax: 4, tier: "4" },
+    AudienceTier5: { segtax: 4, tier: "5" },
+  };
+
+  const body = {};
+  Object.entries(iabTaxonomyFilters || {}).forEach(([tierName, filter]) => {
+    const mapping = TIER_TO_SEGTAX[tierName];
+    if (mapping) {
+      const segtaxKey = String(mapping.segtax);
+      if (!body[segtaxKey]) body[segtaxKey] = {};
+      body[segtaxKey][mapping.tier] = filter;
+    }
+  });
+  return body;
+}
+
+/**
+ * Processes the Neuwo API response and injects IAB Content and Audience Segments into the bid request.
+ * Extracts Segments from the response and injects them into ORTB2 structure.
+ *
+ * Response format: { "6": { "1": [{id, name}], "2": [...] }, "4": { "3": [...], "4": [...] } }
+ * - Content taxonomies are injected into ortb2.site.content.data
+ * - Audience taxonomies are injected into ortb2.user.data
+ *
+ * Only injects data if segments exist to avoid adding empty data structures.
+ *
+ * @param {Object} responseParsed The parsed API response.
+ * @param {Object} reqBidsConfigObj The bid request configuration object to be enriched.
+ * @param {string} iabContentTaxonomyVersion The IAB Content Taxonomy version for segtax mapping.
+ */
+export function injectIabCategories(
   responseParsed,
   reqBidsConfigObj,
-  iabContentTaxonomyVersion,
-  iabTaxonomyFilters
+  iabContentTaxonomyVersion
 ) {
-  const marketingCategories = responseParsed.marketing_categories;
-
-  if (!marketingCategories) {
-    logError(
-      MODULE_NAME,
-      "injectIabCategories():",
-      "No Marketing Categories in Neuwo API response."
-    );
+  if (!responseParsed || typeof responseParsed !== "object") {
+    logError(MODULE_NAME, "injectIabCategories():", "Invalid response format");
     return;
   }
 
-  // Apply per-tier filtering
-  const marketingCategoriesFiltered = filterIabTaxonomies(marketingCategories, iabTaxonomyFilters);
-
-  // Process content categories
-  const contentTiers = ["iab_tier_1", "iab_tier_2", "iab_tier_3"];
-  const contentData = buildIabData(
-    marketingCategoriesFiltered,
-    contentTiers,
+  const contentSegtax =
     IAB_CONTENT_TAXONOMY_MAP[iabContentTaxonomyVersion] ||
-      IAB_CONTENT_TAXONOMY_MAP["3.0"]
-  );
+    IAB_CONTENT_TAXONOMY_MAP[DEFAULT_IAB_CONTENT_TAXONOMY_VERSION];
+  const contentSegtaxStr = String(contentSegtax);
 
-  // Process audience categories
-  const audienceTiers = [
-    "iab_audience_tier_3",
-    "iab_audience_tier_4",
-    "iab_audience_tier_5",
-  ];
-  const audienceData = buildIabData(marketingCategoriesFiltered, audienceTiers, 4);
+  // Extract IAB Content Taxonomy data for the configured version
+  const contentTiers = responseParsed[contentSegtaxStr] || {};
+  const contentData = buildIabData(contentTiers, contentSegtax);
+
+  // Extract IAB Audience Taxonomy data
+  const audienceTiers = responseParsed["4"] || {};
+  const audienceData = buildIabData(audienceTiers, 4);
 
   logInfo(
     MODULE_NAME,
@@ -559,15 +707,24 @@ function injectIabCategories(
     audienceData
   );
 
-  injectOrtbData(reqBidsConfigObj, "site.content.data", [contentData]);
-  injectOrtbData(reqBidsConfigObj, "user.data", [audienceData]);
+  // Only inject data if there are actual segments
+  if (contentData.segment.length > 0 || audienceData.segment.length > 0) {
+    injectOrtbData(reqBidsConfigObj, "site.content.data", [contentData]);
+    injectOrtbData(reqBidsConfigObj, "user.data", [audienceData]);
 
-  logInfo(
-    MODULE_NAME,
-    "injectIabCategories():",
-    "post-injection bidsConfig",
-    reqBidsConfigObj
-  );
+    logInfo(
+      MODULE_NAME,
+      "injectIabCategories():",
+      "post-injection bidsConfig",
+      reqBidsConfigObj
+    );
+  } else {
+    logInfo(
+      MODULE_NAME,
+      "injectIabCategories():",
+      "No segments to inject, skipping data injection"
+    );
+  }
 }
 
 export const neuwoRtdModule = {

From 8052cf249b0f37ce4970b23115756aa556281b49 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 21 Jan 2026 08:59:17 +0100
Subject: [PATCH 17/24] test: update Neuwo RTD Module tests for new API
 architecture

- Update all test mocks to use new segtax-based response format
- Add tests for `buildIabFilterConfig()` function
- Add tests for `injectIabCategories()` function
- Add tests for `transformV1ResponseToV2()` function
- Add tests for `transformSegmentsV1ToV2()` function
- Update `buildIabData()` tests to use new tierData parameter structure
- Add V1 API backward compatibility test suite with client-side filtering tests
- Verify POST method and iabVersions query parameters for new API
- Verify GET method and no iabVersions parameter for legacy V1 API
- Update edge case tests for empty responses and error handling
- Update integration tests for URL parameter handling with query strings
- Remove hardcoded tier array constants (CONTENT_TIERS, AUDIENCE_TIERS)
---
 test/spec/modules/neuwoRtdProvider_spec.js | 1295 +++++++++++++++++---
 1 file changed, 1106 insertions(+), 189 deletions(-)

diff --git a/test/spec/modules/neuwoRtdProvider_spec.js b/test/spec/modules/neuwoRtdProvider_spec.js
index 5f699da6c9f..7c73d935519 100644
--- a/test/spec/modules/neuwoRtdProvider_spec.js
+++ b/test/spec/modules/neuwoRtdProvider_spec.js
@@ -1,10 +1,11 @@
 import * as neuwo from "modules/neuwoRtdProvider";
 import { server } from "test/mocks/xhr.js";
 
-const NEUWO_API_URL = "https://api.url.neuwo.ai/edge/GetAiTopics";
+const NEUWO_API_URL = "https://edge.neuwo.ai/api/aitopics/edge/v1/iab";
 const NEUWO_API_TOKEN = "token";
-const IAB_CONTENT_TAXONOMY_VERSION = "3.0";
+const IAB_CONTENT_TAXONOMY_VERSION = "2.2";
 
+// API config
 const config = () => ({
   params: {
     neuwoApiUrl: NEUWO_API_URL,
@@ -13,7 +14,115 @@ const config = () => ({
   },
 });
 
+/**
+ * API Response Mock
+ * Returns new format with segtax-based structure
+ * Field names: id, name, relevance (lowercase)
+ * Structure: { "6": { "1": [...], "2": [...] }, "4": { "3": [...] } }
+ */
 function getNeuwoApiResponse() {
+  return {
+    7: {
+      1: [
+        {
+          id: "80DV8O",
+        },
+        {
+          id: "52",
+        },
+        {
+          id: "432",
+        },
+      ],
+      2: [
+        {
+          id: "90",
+        },
+      ],
+      3: [
+        {
+          id: "106",
+        },
+      ],
+    },
+    1: {
+      1: [
+        {
+          id: "IAB12",
+        },
+      ],
+    },
+    6: {
+      1: [
+        {
+          id: "52",
+        },
+      ],
+      2: [
+        {
+          id: "90",
+        },
+        {
+          id: "434",
+        },
+      ],
+      3: [
+        {
+          id: "106",
+        },
+      ],
+    },
+    4: {
+      3: [
+        {
+          id: "49",
+        },
+        {
+          id: "780",
+        },
+      ],
+      4: [
+        {
+          id: "431",
+        },
+        {
+          id: "196",
+        },
+        {
+          id: "197",
+        },
+      ],
+      5: [
+        {
+          id: "98",
+        },
+      ],
+    },
+  };
+}
+
+// ============================================================================
+// V1 API Constants and Mocks
+// ============================================================================
+
+const NEUWO_API_URL_V1 = "https://api.url.neuwo.ai/edge/GetAiTopics";
+const IAB_CONTENT_TAXONOMY_VERSION_V1 = "3.0";
+
+// Legacy V1 API config (for backward compatibility tests)
+const configV1 = () => ({
+  params: {
+    neuwoApiUrl: NEUWO_API_URL_V1,
+    neuwoApiToken: NEUWO_API_TOKEN,
+    iabContentTaxonomyVersion: IAB_CONTENT_TAXONOMY_VERSION_V1,
+  },
+});
+
+/**
+ * V1 API Response Mock
+ * Returns legacy format with marketing_categories structure
+ * Field names: ID, label, relevance (capital letters)
+ */
+function getNeuwoApiResponseV1() {
   return {
     brand_safety: {
       BS_score: "1.0",
@@ -65,8 +174,6 @@ function getNeuwoApiResponse() {
     ],
   };
 }
-const CONTENT_TIERS = ["iab_tier_1", "iab_tier_2", "iab_tier_3"];
-const AUDIENCE_TIERS = ["iab_audience_tier_3", "iab_audience_tier_4", "iab_audience_tier_5"];
 
 /**
  * Object generator, like above, written using alternative techniques
@@ -126,27 +233,15 @@ describe("neuwoRtdModule", function () {
   });
 
   describe("buildIabData", function () {
-    it("should return an empty segment array when no matching tiers are found", function () {
-      const marketingCategories = getNeuwoApiResponse().marketing_categories;
-      const tiers = ["non_existent_tier"];
-      const segtax = 0;
-      const result = neuwo.buildIabData(marketingCategories, tiers, segtax);
-      const expected = {
-        name: neuwo.DATA_PROVIDER,
-        segment: [],
-        ext: {
-          segtax,
-        },
-      };
-      expect(result, "should produce a valid object with an empty segment array").to.deep.equal(
-        expected
-      );
-    });
-
     it("should correctly build the data object for content tiers", function () {
-      const marketingCategories = getNeuwoApiResponse().marketing_categories;
+      // format with tier keys "1", "2", "3"
+      const tierData = {
+        "1": [{ id: "274", name: "Home & Garden", relevance: "0.47" }],
+        "2": [{ id: "216", name: "Cooking", relevance: "0.41" }],
+        "3": [],
+      };
       const segtax = 0;
-      const result = neuwo.buildIabData(marketingCategories, CONTENT_TIERS, segtax);
+      const result = neuwo.buildIabData(tierData, segtax);
       const expected = {
         name: neuwo.DATA_PROVIDER,
         segment: [
@@ -163,9 +258,14 @@ describe("neuwoRtdModule", function () {
     });
 
     it("should correctly build the data object for audience tiers", function () {
-      const marketingCategories = getNeuwoApiResponse().marketing_categories;
+      // format with tier keys "3", "4", "5" for audience
+      const tierData = {
+        "3": [{ id: "49", name: "Demographic | Gender | Female |", relevance: "0.9923" }],
+        "4": [{ id: "127", name: "Demographic | Household Data | 1 Child |", relevance: "0.9673" }],
+        "5": [{ id: "98", name: "Demographic | Household Data | Parents with Children |", relevance: "0.9066" }],
+      };
       const segtax = 0;
-      const result = neuwo.buildIabData(marketingCategories, AUDIENCE_TIERS, segtax);
+      const result = neuwo.buildIabData(tierData, segtax);
       const expected = {
         name: neuwo.DATA_PROVIDER,
         segment: [
@@ -182,7 +282,7 @@ describe("neuwoRtdModule", function () {
       );
     });
 
-    it("should return an empty segment array when marketingCategories is null or undefined", function () {
+    it("should return an empty segment array when tierData is null or undefined", function () {
       const segtax = 4;
       const expected = {
         name: neuwo.DATA_PROVIDER,
@@ -192,19 +292,19 @@ describe("neuwoRtdModule", function () {
         },
       };
       expect(
-        neuwo.buildIabData(null, CONTENT_TIERS, segtax),
-        "should handle null marketingCategories gracefully"
+        neuwo.buildIabData(null, segtax),
+        "should handle null tierData gracefully"
       ).to.deep.equal(expected);
       expect(
-        neuwo.buildIabData(undefined, CONTENT_TIERS, segtax),
-        "should handle undefined marketingCategories gracefully"
+        neuwo.buildIabData(undefined, segtax),
+        "should handle undefined tierData gracefully"
       ).to.deep.equal(expected);
     });
 
-    it("should return an empty segment array when marketingCategories is empty", function () {
-      const marketingCategories = {};
+    it("should return an empty segment array when tierData is empty", function () {
+      const tierData = {};
       const segtax = 4;
-      const result = neuwo.buildIabData(marketingCategories, CONTENT_TIERS, segtax);
+      const result = neuwo.buildIabData(tierData, segtax);
       const expected = {
         name: neuwo.DATA_PROVIDER,
         segment: [],
@@ -212,19 +312,20 @@ describe("neuwoRtdModule", function () {
           segtax,
         },
       };
-      expect(result, "should handle an empty marketingCategories object").to.deep.equal(expected);
+      expect(result, "should handle an empty tierData object").to.deep.equal(expected);
     });
 
-    it("should gracefully handle if a marketing_categories key contains a non-array value", function () {
-      const marketingCategories = getNeuwoApiResponse().marketing_categories;
-      // Overwrite iab_tier_1 to be an object instead of an array
-      marketingCategories.iab_tier_1 = { ID: "274", label: "Home & Garden" };
+    it("should gracefully handle if a tier key contains a non-array value", function () {
+      const tierData = {
+        "1": { id: "274", name: "Home & Garden" }, // Not an array
+        "2": [{ id: "216", name: "Cooking", relevance: "0.41" }],
+      };
 
       const segtax = 4;
-      const result = neuwo.buildIabData(marketingCategories, CONTENT_TIERS, segtax);
+      const result = neuwo.buildIabData(tierData, segtax);
       const expected = {
         name: neuwo.DATA_PROVIDER,
-        // The segment should only contain data from the valid iab_tier_2
+        // The segment should only contain data from the valid tier "2"
         segment: [
           {
             id: "216",
@@ -241,21 +342,23 @@ describe("neuwoRtdModule", function () {
     });
 
     it("should ignore malformed objects within a tier array", function () {
-      const marketingCategories = getNeuwoApiResponse().marketing_categories;
-      // Overwrite iab_tier_1 with various malformed objects
-      marketingCategories.iab_tier_1 = [
-        { ID: "274", label: "Valid Object" },
-        { label: "Another Label" }, // Missing 'ID' property
-        null, // A null value
-        "just-a-string", // A string primitive
-        {}, // An empty object
-      ];
+      // Tier "1" with various malformed objects
+      const tierData = {
+        "1": [
+          { id: "274", name: "Valid Object" },
+          { name: "Another Label" }, // Missing 'id' property
+          null, // A null value
+          "just-a-string", // A string primitive
+          {}, // An empty object
+        ],
+        "2": [{ id: "216", name: "Cooking", relevance: "0.41" }],
+      };
 
       const segtax = 4;
-      const result = neuwo.buildIabData(marketingCategories, CONTENT_TIERS, segtax);
+      const result = neuwo.buildIabData(tierData, segtax);
       const expected = {
         name: neuwo.DATA_PROVIDER,
-        // The segment should contain the one valid object from iab_tier_1 and the data from iab_tier_2
+        // The segment should contain the one valid object from tier "1" and the data from tier "2"
         segment: [
           {
             id: "274",
@@ -274,7 +377,7 @@ describe("neuwoRtdModule", function () {
       );
     });
 
-    it("should return an empty segment array if the entire marketingCategories object is not a valid object", function () {
+    it("should return an empty segment array if the entire tierData is not a valid object", function () {
       const segtax = 4;
       const expected = {
         name: neuwo.DATA_PROVIDER,
@@ -282,13 +385,271 @@ describe("neuwoRtdModule", function () {
         ext: { segtax },
       };
       // Test with a string
-      const resultString = neuwo.buildIabData("incorrect format", CONTENT_TIERS, segtax);
-      expect(resultString, "should handle non-object marketingCategories input").to.deep.equal(
+      const resultString = neuwo.buildIabData("incorrect format", segtax);
+      expect(resultString, "should handle non-object tierData input").to.deep.equal(
         expected
       );
     });
   });
 
+  describe("buildIabFilterConfig", function () {
+    it("should return empty object when no filters provided", function () {
+      const result = neuwo.buildIabFilterConfig(null, 6);
+      expect(result, "should return empty object for null filters").to.deep.equal({});
+    });
+
+    it("should return empty object when filters parameter is undefined", function () {
+      const result = neuwo.buildIabFilterConfig(undefined, 6);
+      expect(result, "should return empty object for undefined filters").to.deep.equal({});
+    });
+
+    it("should return empty object when filters is empty object", function () {
+      const result = neuwo.buildIabFilterConfig({}, 6);
+      expect(result, "should return empty object for empty filters").to.deep.equal({});
+    });
+
+    it("should convert ContentTier1 filter correctly", function () {
+      const filters = {
+        ContentTier1: { limit: 3, threshold: 0.5 }
+      };
+      const contentSegtax = 6;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should have segtax key").to.have.property("6");
+      expect(result["6"], "should have tier key").to.have.property("1");
+      expect(result["6"]["1"], "should preserve filter properties").to.deep.equal({
+        limit: 3,
+        threshold: 0.5
+      });
+    });
+
+    it("should convert ContentTier2 filter correctly", function () {
+      const filters = {
+        ContentTier2: { limit: 5, threshold: 0.6 }
+      };
+      const contentSegtax = 7;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should have segtax key").to.have.property("7");
+      expect(result["7"], "should have tier key").to.have.property("2");
+      expect(result["7"]["2"], "should have limit property").to.have.property("limit", 5);
+      expect(result["7"]["2"], "should have threshold property").to.have.property("threshold", 0.6);
+    });
+
+    it("should convert ContentTier3 filter correctly", function () {
+      const filters = {
+        ContentTier3: { limit: 4, threshold: 0.8 }
+      };
+      const contentSegtax = 6;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should have segtax key").to.have.property("6");
+      expect(result["6"], "should have tier key").to.have.property("3");
+      expect(result["6"]["3"], "should have limit property").to.have.property("limit", 4);
+      expect(result["6"]["3"], "should have threshold property").to.have.property("threshold", 0.8);
+    });
+
+    it("should convert AudienceTier3 filter correctly", function () {
+      const filters = {
+        AudienceTier3: { limit: 2, threshold: 0.9 }
+      };
+      const contentSegtax = 6;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should use segtax 4 for audience").to.have.property("4");
+      expect(result["4"], "should have tier key").to.have.property("3");
+      expect(result["4"]["3"], "should have limit property").to.have.property("limit", 2);
+      expect(result["4"]["3"], "should have threshold property").to.have.property("threshold", 0.9);
+    });
+
+    it("should convert AudienceTier4 filter correctly", function () {
+      const filters = {
+        AudienceTier4: { limit: 10, threshold: 0.85 }
+      };
+      const contentSegtax = 6;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should use segtax 4 for audience").to.have.property("4");
+      expect(result["4"], "should have tier key").to.have.property("4");
+      expect(result["4"]["4"], "should have limit property").to.have.property("limit", 10);
+      expect(result["4"]["4"], "should have threshold property").to.have.property("threshold", 0.85);
+    });
+
+    it("should convert AudienceTier5 filter correctly", function () {
+      const filters = {
+        AudienceTier5: { limit: 7, threshold: 0.95 }
+      };
+      const contentSegtax = 6;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should use segtax 4 for audience").to.have.property("4");
+      expect(result["4"], "should have tier key").to.have.property("5");
+      expect(result["4"]["5"], "should have limit property").to.have.property("limit", 7);
+      expect(result["4"]["5"], "should have threshold property").to.have.property("threshold", 0.95);
+    });
+
+    it("should handle multiple content tiers with same segtax", function () {
+      const filters = {
+        ContentTier1: { limit: 3 },
+        ContentTier2: { limit: 5 },
+        ContentTier3: { threshold: 0.7 }
+      };
+      const contentSegtax = 6;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should have single segtax key").to.have.all.keys("6");
+      expect(result["6"], "should have all three tier keys").to.have.all.keys("1", "2", "3");
+      expect(result["6"]["1"], "tier 1 should be correct").to.deep.equal({ limit: 3 });
+      expect(result["6"]["2"], "tier 2 should be correct").to.deep.equal({ limit: 5 });
+      expect(result["6"]["3"], "tier 3 should be correct").to.deep.equal({ threshold: 0.7 });
+    });
+
+    it("should handle multiple audience tiers", function () {
+      const filters = {
+        AudienceTier3: { limit: 2 },
+        AudienceTier4: { limit: 4 },
+        AudienceTier5: { threshold: 0.85 }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result, "should have segtax 4 key").to.have.all.keys("4");
+      expect(result["4"], "should have all three tier keys").to.have.all.keys("3", "4", "5");
+      expect(result["4"]["3"], "tier 3 should be correct").to.deep.equal({ limit: 2 });
+      expect(result["4"]["4"], "tier 4 should be correct").to.deep.equal({ limit: 4 });
+      expect(result["4"]["5"], "tier 5 should be correct").to.deep.equal({ threshold: 0.85 });
+    });
+
+    it("should handle both content and audience tiers together", function () {
+      const filters = {
+        ContentTier1: { limit: 3, threshold: 0.5 },
+        ContentTier2: { limit: 5 },
+        AudienceTier3: { limit: 2, threshold: 0.9 },
+        AudienceTier4: { threshold: 0.8 }
+      };
+      const contentSegtax = 6;
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+      expect(result, "should have both segtax keys").to.have.all.keys("6", "4");
+      expect(result["6"], "content segtax should have two tiers").to.have.all.keys("1", "2");
+      expect(result["4"], "audience segtax should have two tiers").to.have.all.keys("3", "4");
+      expect(result["6"]["1"]).to.deep.equal({ limit: 3, threshold: 0.5 });
+      expect(result["4"]["3"]).to.deep.equal({ limit: 2, threshold: 0.9 });
+    });
+
+    it("should use different content segtax values correctly", function () {
+      const filters = {
+        ContentTier1: { limit: 3 }
+      };
+
+      // Test with segtax 6 (IAB 2.2)
+      const result6 = neuwo.buildIabFilterConfig(filters, 6);
+      expect(result6, "should use segtax 6").to.have.property("6");
+      expect(result6, "should not have segtax 7").to.not.have.property("7");
+
+      // Test with segtax 7 (IAB 3.0)
+      const result7 = neuwo.buildIabFilterConfig(filters, 7);
+      expect(result7, "should use segtax 7").to.have.property("7");
+      expect(result7, "should not have segtax 6").to.not.have.property("6");
+    });
+
+    it("should ignore unknown tier names", function () {
+      const filters = {
+        ContentTier1: { limit: 3 },
+        UnknownTier: { limit: 10 },
+        InvalidTier99: { threshold: 0.5 }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result, "should only have segtax 6").to.have.all.keys("6");
+      expect(result["6"], "should only have tier 1").to.have.all.keys("1");
+      expect(result["6"]["1"]).to.deep.equal({ limit: 3 });
+    });
+
+    it("should handle filters with only limit property", function () {
+      const filters = {
+        ContentTier1: { limit: 5 }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["6"]["1"], "should only have limit property").to.deep.equal({ limit: 5 });
+      expect(result["6"]["1"], "should not have threshold").to.not.have.property("threshold");
+    });
+
+    it("should handle filters with only threshold property", function () {
+      const filters = {
+        AudienceTier3: { threshold: 0.75 }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["4"]["3"], "should only have threshold property").to.deep.equal({ threshold: 0.75 });
+      expect(result["4"]["3"], "should not have limit").to.not.have.property("limit");
+    });
+
+    it("should handle filters with additional custom properties", function () {
+      const filters = {
+        ContentTier1: { limit: 3, threshold: 0.5, customProp: "value" }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["6"]["1"], "should preserve all properties").to.deep.equal({
+        limit: 3,
+        threshold: 0.5,
+        customProp: "value"
+      });
+    });
+
+    it("should handle empty filter objects for tiers", function () {
+      const filters = {
+        ContentTier1: {},
+        AudienceTier3: {}
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["6"]["1"], "should create empty object for content tier").to.deep.equal({});
+      expect(result["4"]["3"], "should create empty object for audience tier").to.deep.equal({});
+    });
+
+    it("should handle null limit value", function () {
+      const filters = {
+        ContentTier1: { limit: null, threshold: 0.5 }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["6"]["1"], "should preserve null limit").to.have.property("limit", null);
+      expect(result["6"]["1"], "should preserve threshold").to.have.property("threshold", 0.5);
+    });
+
+    it("should handle undefined limit value", function () {
+      const filters = {
+        ContentTier1: { limit: undefined, threshold: 0.5 }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["6"]["1"], "should preserve undefined limit").to.have.property("limit", undefined);
+      expect(result["6"]["1"], "should preserve threshold").to.have.property("threshold", 0.5);
+    });
+
+    it("should handle null threshold value", function () {
+      const filters = {
+        AudienceTier3: { limit: 5, threshold: null }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["4"]["3"], "should preserve limit").to.have.property("limit", 5);
+      expect(result["4"]["3"], "should preserve null threshold").to.have.property("threshold", null);
+    });
+
+    it("should handle undefined threshold value", function () {
+      const filters = {
+        AudienceTier3: { limit: 5, threshold: undefined }
+      };
+      const result = neuwo.buildIabFilterConfig(filters, 6);
+
+      expect(result["4"]["3"], "should preserve limit").to.have.property("limit", 5);
+      expect(result["4"]["3"], "should preserve undefined threshold").to.have.property("threshold", undefined);
+    });
+  });
+
   describe("injectOrtbData", function () {
     it("should correctly mutate the request bids config object with new data", function () {
       const reqBidsConfigObj = { ortb2Fragments: { global: {} } };
@@ -300,8 +661,170 @@ describe("neuwoRtdModule", function () {
     });
   });
 
+  describe("injectIabCategories", function () {
+    it("should not inject data when responseParsed is null or undefined", function () {
+      const bidsConfig1 = bidsConfiglike();
+      const bidsConfig2 = bidsConfiglike();
+      const bidsConfigCopy = JSON.parse(JSON.stringify(bidsConfig1));
+
+      neuwo.injectIabCategories(null, bidsConfig1, "2.2");
+      neuwo.injectIabCategories(undefined, bidsConfig2, "2.2");
+
+      expect(
+        bidsConfig1.ortb2Fragments.global,
+        "should not modify ortb2Fragments when response is null"
+      ).to.deep.equal(bidsConfigCopy.ortb2Fragments.global);
+      expect(
+        bidsConfig2.ortb2Fragments.global,
+        "should not modify ortb2Fragments when response is undefined"
+      ).to.deep.equal(bidsConfigCopy.ortb2Fragments.global);
+    });
+
+    it("should not inject data when responseParsed is not an object", function () {
+      const bidsConfig1 = bidsConfiglike();
+      const bidsConfig2 = bidsConfiglike();
+      const bidsConfig3 = bidsConfiglike();
+      const bidsConfigCopy = JSON.parse(JSON.stringify(bidsConfig1));
+
+      neuwo.injectIabCategories("invalid string", bidsConfig1, "2.2");
+      neuwo.injectIabCategories(123, bidsConfig2, "2.2");
+      neuwo.injectIabCategories([1, 2, 3], bidsConfig3, "2.2");
+
+      expect(
+        bidsConfig1.ortb2Fragments.global,
+        "should not modify ortb2Fragments when response is a string"
+      ).to.deep.equal(bidsConfigCopy.ortb2Fragments.global);
+      expect(
+        bidsConfig2.ortb2Fragments.global,
+        "should not modify ortb2Fragments when response is a number"
+      ).to.deep.equal(bidsConfigCopy.ortb2Fragments.global);
+      expect(
+        bidsConfig3.ortb2Fragments.global,
+        "should not modify ortb2Fragments when response is an array"
+      ).to.deep.equal(bidsConfigCopy.ortb2Fragments.global);
+    });
+
+    it("should handle empty object response", function () {
+      const bidsConfig = bidsConfiglike();
+      const bidsConfigCopy = JSON.parse(JSON.stringify(bidsConfig));
+
+      neuwo.injectIabCategories({}, bidsConfig, "2.2");
+
+      expect(
+        bidsConfig.ortb2Fragments.global,
+        "should not inject data when response object is empty"
+      ).to.deep.equal(bidsConfigCopy.ortb2Fragments.global);
+    });
+
+    it("should inject content data when valid content segments exist", function () {
+      const response = {
+        "6": {
+          "1": [{ id: "52", name: "Food & Drink" }],
+          "2": [{ id: "90", name: "Cooking" }]
+        }
+      };
+      const bidsConfig = bidsConfiglike();
+
+      neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+      const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+      expect(contentData, "should have content data").to.exist;
+      expect(contentData.ext.segtax, "should have correct segtax").to.equal(6);
+      expect(contentData.segment, "should have segments").to.have.lengthOf(2);
+      expect(contentData.segment[0].id, "first segment should match").to.equal("52");
+    });
+
+    it("should inject audience data when valid audience segments exist", function () {
+      const response = {
+        "4": {
+          "3": [{ id: "49", name: "Female" }],
+          "4": [{ id: "431", name: "Age 25-34" }]
+        }
+      };
+      const bidsConfig = bidsConfiglike();
+
+      neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+      const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+      expect(userData, "should have user data").to.exist;
+      expect(userData.ext.segtax, "should have correct segtax").to.equal(4);
+      expect(userData.segment, "should have segments").to.have.lengthOf(2);
+      expect(userData.segment[0].id, "first segment should match").to.equal("49");
+    });
+
+    it("should inject both content and audience data when both exist", function () {
+      const response = {
+        "6": {
+          "1": [{ id: "52", name: "Food & Drink" }]
+        },
+        "4": {
+          "3": [{ id: "49", name: "Female" }]
+        }
+      };
+      const bidsConfig = bidsConfiglike();
+
+      neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+      const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+      const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+
+      expect(contentData, "should have content data").to.exist;
+      expect(userData, "should have user data").to.exist;
+      expect(contentData.ext.segtax, "content should have segtax 6").to.equal(6);
+      expect(userData.ext.segtax, "audience should have segtax 4").to.equal(4);
+    });
+
+    it("should handle different IAB Content Taxonomy versions", function () {
+      const response = {
+        "7": {
+          "1": [{ id: "80DV8O", name: "Automotive" }]
+        }
+      };
+      const bidsConfig = bidsConfiglike();
+
+      neuwo.injectIabCategories(response, bidsConfig, "3.0");
+
+      const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+      expect(contentData, "should have content data").to.exist;
+      expect(contentData.ext.segtax, "should use segtax 7 for IAB 3.0").to.equal(7);
+    });
+
+    it("should not inject data when segtax has no segments", function () {
+      const response1 = { "6": {} };
+      const response2 = { "4": {} };
+      const response3 = { "6": { "1": [] }, "4": { "3": [] } };
+      const bidsConfig1 = bidsConfiglike();
+      const bidsConfig2 = bidsConfiglike();
+      const bidsConfig3 = bidsConfiglike();
+
+      neuwo.injectIabCategories(response1, bidsConfig1, "2.2");
+      neuwo.injectIabCategories(response2, bidsConfig2, "2.2");
+      neuwo.injectIabCategories(response3, bidsConfig3, "2.2");
+
+      expect(bidsConfig1.ortb2Fragments.global?.site?.content?.data, "should not inject empty content data").to.be.undefined;
+      expect(bidsConfig2.ortb2Fragments.global?.user?.data, "should not inject empty audience data").to.be.undefined;
+      expect(bidsConfig3.ortb2Fragments.global?.site?.content?.data, "should not inject content data with empty segments").to.be.undefined;
+      expect(bidsConfig3.ortb2Fragments.global?.user?.data, "should not inject audience data with empty segments").to.be.undefined;
+    });
+
+    it("should use default taxonomy version when invalid version provided", function () {
+      const response = {
+        "6": {
+          "1": [{ id: "52", name: "Food & Drink" }]
+        }
+      };
+      const bidsConfig = bidsConfiglike();
+
+      neuwo.injectIabCategories(response, bidsConfig, "invalid-version");
+
+      const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+      expect(contentData, "should have content data").to.exist;
+      expect(contentData.ext.segtax, "should default to segtax 6 (IAB 2.2)").to.equal(6);
+    });
+  });
+
   describe("getBidRequestData", function () {
-    describe("when using IAB Content Taxonomy 3.0", function () {
+    describe("when using IAB Content Taxonomy 2.2 (API default)", function () {
       it("should correctly structure the bids object after a successful API response", function () {
         const apiResponse = getNeuwoApiResponse();
         const bidsConfig = bidsConfiglike();
@@ -323,6 +846,13 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "The request URL should include the product identifier").to.include(
           "_neuwo_prod=PrebidModule"
         );
+        expect(request.url, "API should include iabVersions parameter for segtax 6").to.include(
+          "iabVersions=6"
+        );
+        expect(request.url, "PI should include iabVersions parameter for segtax 4").to.include(
+          "iabVersions=4"
+        );
+        expect(request.method, "API should use POST method").to.equal("POST");
 
         request.respond(
           200,
@@ -336,26 +866,28 @@ describe("neuwoRtdModule", function () {
         );
         expect(
           contentData.ext.segtax,
-          "The segtax value should correspond to IAB Content Taxonomy 3.0"
-        ).to.equal(7);
+          "The segtax value should correspond to IAB Content Taxonomy 2.2"
+        ).to.equal(6);
         expect(
           contentData.segment[0].id,
           "The first segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_1[0].ID);
+        ).to.equal(apiResponse["6"]["1"][0].id);
         expect(
           contentData.segment[1].id,
           "The second segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].ID);
+        ).to.equal(apiResponse["6"]["2"][0].id);
       });
     });
 
-    describe("when using IAB Content Taxonomy 2.2", function () {
+    describe("when using IAB Content Taxonomy 1.0", function () {
       it("should correctly structure the bids object after a successful API response", function () {
-        const apiResponse = getNeuwoApiResponse();
+        const apiResponse = {
+          1: { 1: [{ id: "IAB1" }], 2: [{ id: "IAB1-1" }], 3: [{ id: "IAB1-1-1" }] },
+          4: { 3: [{ id: "49" }, { id: "780" }], 4: [{ id: "431" }], 5: [{ id: "98" }] },
+        };
         const bidsConfig = bidsConfiglike();
         const conf = config();
-        conf.params.iabContentTaxonomyVersion = "2.2";
-        // control xhr api request target for testing
+        conf.params.iabContentTaxonomyVersion = "1.0";
         conf.params.websiteToAnalyseUrl =
           "https://publisher.works/article.php?get=horrible_url_for_testing&id=5";
 
@@ -369,38 +901,51 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "The request URL should include the encoded website URL").to.include(
           encodeURIComponent(conf.params.websiteToAnalyseUrl)
         );
+        expect(request.url, "The request URL should include the product identifier").to.include(
+          "_neuwo_prod=PrebidModule"
+        );
+        expect(request.url, "API should include iabVersions parameter for segtax 1").to.include(
+          "iabVersions=1"
+        );
+        expect(request.url, "API should include iabVersions parameter for segtax 4").to.include(
+          "iabVersions=4"
+        );
+        expect(request.method, "API should use POST method").to.equal("POST");
 
         request.respond(
           200,
           { "Content-Type": "application/json; encoding=UTF-8" },
           JSON.stringify(apiResponse)
         );
+
         const contentData = bidsConfig.ortb2Fragments.global.site.content.data[0];
         expect(contentData.name, "The data provider name should be correctly set").to.equal(
           neuwo.DATA_PROVIDER
         );
         expect(
           contentData.ext.segtax,
-          "The segtax value should correspond to IAB Content Taxonomy 2.2"
-        ).to.equal(6);
+          "The segtax value should correspond to IAB Content Taxonomy 1.0"
+        ).to.equal(1);
         expect(
           contentData.segment[0].id,
           "The first segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_1[0].ID);
+        ).to.equal(apiResponse["1"]["1"][0].id);
         expect(
           contentData.segment[1].id,
           "The second segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].ID);
+        ).to.equal(apiResponse["1"]["2"][0].id);
       });
     });
 
-    describe("when using the default IAB Content Taxonomy", function () {
+    describe("when using IAB Content Taxonomy 3.0", function () {
       it("should correctly structure the bids object after a successful API response", function () {
-        const apiResponse = getNeuwoApiResponse();
+        const apiResponse = {
+          7: { 1: [{ id: "80DV8O" }], 2: [{ id: "90" }], 3: [{ id: "106" }] },
+          4: { 3: [{ id: "49" }, { id: "780" }], 4: [{ id: "431" }], 5: [{ id: "98" }] },
+        };
         const bidsConfig = bidsConfiglike();
         const conf = config();
-        conf.params.iabContentTaxonomyVersion = undefined;
-        // control xhr api request target for testing
+        conf.params.iabContentTaxonomyVersion = "3.0";
         conf.params.websiteToAnalyseUrl =
           "https://publisher.works/article.php?get=horrible_url_for_testing&id=5";
 
@@ -414,28 +959,39 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "The request URL should include the encoded website URL").to.include(
           encodeURIComponent(conf.params.websiteToAnalyseUrl)
         );
+        expect(request.url, "The request URL should include the product identifier").to.include(
+          "_neuwo_prod=PrebidModule"
+        );
+        expect(request.url, "API should include iabVersions parameter for segtax 7").to.include(
+          "iabVersions=7"
+        );
+        expect(request.url, "API should include iabVersions parameter for segtax 4").to.include(
+          "iabVersions=4"
+        );
+        expect(request.method, "API should use POST method").to.equal("POST");
 
         request.respond(
           200,
           { "Content-Type": "application/json; encoding=UTF-8" },
           JSON.stringify(apiResponse)
         );
+
         const contentData = bidsConfig.ortb2Fragments.global.site.content.data[0];
         expect(contentData.name, "The data provider name should be correctly set").to.equal(
           neuwo.DATA_PROVIDER
         );
         expect(
           contentData.ext.segtax,
-          "The segtax value should default to IAB Content Taxonomy 3.0"
+          "The segtax value should correspond to IAB Content Taxonomy 3.0"
         ).to.equal(7);
         expect(
           contentData.segment[0].id,
           "The first segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_1[0].ID);
+        ).to.equal(apiResponse["7"]["1"][0].id);
         expect(
           contentData.segment[1].id,
           "The second segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].ID);
+        ).to.equal(apiResponse["7"]["2"][0].id);
       });
     });
 
@@ -458,6 +1014,7 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "The request URL should include the encoded website URL").to.include(
           encodeURIComponent(conf.params.websiteToAnalyseUrl)
         );
+        expect(request.method, "API should use POST method").to.equal("POST");
 
         request.respond(
           200,
@@ -474,12 +1031,12 @@ describe("neuwoRtdModule", function () {
         ).to.equal(4);
         expect(
           userData.segment[0].id,
-          "The first segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_audience_tier_3[0].ID);
+          "The first segment ID should match the API response (tier 3, first item)"
+        ).to.equal(apiResponse["4"]["3"][0].id);
         expect(
           userData.segment[1].id,
-          "The second segment ID should match the API response"
-        ).to.equal(apiResponse.marketing_categories.iab_audience_tier_4[0].ID);
+          "The second segment ID should match the API response (tier 3, second item)"
+        ).to.equal(apiResponse["4"]["3"][1].id);
       });
     });
 
@@ -937,8 +1494,8 @@ describe("neuwoRtdModule", function () {
 
   // Integration Tests
   describe("injectIabCategories edge cases and merging", function () {
-    it("should not inject data if 'marketing_categories' is missing from the successful API response", function () {
-      const apiResponse = { brand_safety: { BS_score: "1.0" } }; // Missing marketing_categories
+    it("should not inject data if response contains no segments", function () {
+      const apiResponse = { "6": {}, "4": {} }; // Empty response (no segments)
       const bidsConfig = bidsConfiglike();
       const bidsConfigCopy = bidsConfiglike();
       const conf = config();
@@ -951,8 +1508,8 @@ describe("neuwoRtdModule", function () {
         JSON.stringify(apiResponse)
       );
 
-      // After a successful response with missing data, the global ortb2 fragments should remain empty
-      // as the data injection logic checks for marketingCategories.
+      // After a successful response with no segments, the global ortb2 fragments should remain empty
+      // as the data injection logic only injects when segments exist
       expect(
         bidsConfig.ortb2Fragments.global,
         "The global ORTB fragments should remain empty"
@@ -1011,7 +1568,7 @@ describe("neuwoRtdModule", function () {
       const bidsConfig = bidsConfiglike();
       const conf = config();
       // Set API URL that already has query parameters
-      conf.params.neuwoApiUrl = "https://api.neuwo.ai/v1/analyze?environment=production";
+      conf.params.neuwoApiUrl = "https://edge.neuwo.ai/api/aitopics/edge/v1/iab?environment=production";
       conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
 
       neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
@@ -1022,6 +1579,7 @@ describe("neuwoRtdModule", function () {
       expect(request.url, "URL should contain token param joined with &").to.include("&token=");
       expect(request.url, "URL should contain url param").to.include("&url=");
       expect(request.url, "URL should contain product identifier").to.include("&_neuwo_prod=PrebidModule");
+      expect(request.url, "URL should include iabVersions parameter").to.include("iabVersions=");
       // Should not have ?? in the URL
       expect(request.url, "URL should not contain double question marks").to.not.include("??");
 
@@ -1431,15 +1989,15 @@ describe("neuwoRtdModule", function () {
         );
       });
 
-      it("should handle response with missing marketing_categories", function (done) {
+      it("should handle response with empty segments", function (done) {
         const bidsConfig = bidsConfiglike();
         const conf = config();
         conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=no-categories";
 
         neuwo.getBidRequestData(bidsConfig, () => {
-          // Callback should still be called even without marketing_categories
+          // Callback should still be called even with empty response
           const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data;
-          expect(contentData, "No data should be injected without marketing_categories").to.be.undefined;
+          expect(contentData, "No data should be injected without segments").to.be.undefined;
           done();
         }, conf, "consent data");
 
@@ -1447,7 +2005,7 @@ describe("neuwoRtdModule", function () {
         request.respond(
           200,
           { "Content-Type": "application/json; encoding=UTF-8" },
-          JSON.stringify({ brand_safety: { BS_score: "1.0" } }) // Missing marketing_categories
+          JSON.stringify({ "6": {}, "4": {} }) // Empty segments
         );
       });
     });
@@ -1592,8 +2150,285 @@ describe("neuwoRtdModule", function () {
         });
       });
     });
+  });
 
-    describe("filterIabTaxonomyTier", function () {
+  // V1 API Format Tests
+  // These tests use the legacy V1 API response format with marketing_categories structure.
+  // V1 API uses GET requests and returns: { marketing_categories: { iab_tier_1: [], iab_tier_2: [], etc. } }
+  // Field names in V1: ID, label, relevance (capital letters)
+  describe("V1 API", function () {
+    describe("getBidRequestData", function () {
+      describe("when using IAB Content Taxonomy 3.0", function () {
+        it("should correctly structure the bids object after a successful API response", function () {
+          const apiResponse = getNeuwoApiResponseV1();
+          const bidsConfig = bidsConfiglike();
+          const conf = configV1();
+          // control xhr api request target for testing
+          conf.params.websiteToAnalyseUrl =
+            "https://publisher.works/article.php?get=horrible_url_for_testing&id=5";
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should be a string").to.be.a("string");
+          expect(request.url, "The request URL should include the public API token").to.include(
+            conf.params.neuwoApiToken
+          );
+          expect(request.url, "The request URL should include the encoded website URL").to.include(
+            encodeURIComponent(conf.params.websiteToAnalyseUrl)
+          );
+          expect(request.url, "The request URL should include the product identifier").to.include(
+            "_neuwo_prod=PrebidModule"
+          );
+          expect(request.url, "V1 API should NOT include iabVersions parameter").to.not.include(
+            "iabVersions"
+          );
+
+          request.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(apiResponse)
+          );
+
+          const contentData = bidsConfig.ortb2Fragments.global.site.content.data[0];
+          expect(contentData.name, "The data provider name should be correctly set").to.equal(
+            neuwo.DATA_PROVIDER
+          );
+          expect(
+            contentData.ext.segtax,
+            "The segtax value should correspond to IAB Content Taxonomy 3.0"
+          ).to.equal(7);
+          expect(
+            contentData.segment[0].id,
+            "The first segment ID should match the API response (transformed from V1)"
+          ).to.equal(apiResponse.marketing_categories.iab_tier_1[0].ID);
+          expect(
+            contentData.segment[1].id,
+            "The second segment ID should match the API response (transformed from V1)"
+          ).to.equal(apiResponse.marketing_categories.iab_tier_2[0].ID);
+        });
+      });
+
+      describe("when using IAB Audience Taxonomy 1.1", function () {
+        it("should correctly structure the bids object after a successful API response", function () {
+          const apiResponse = getNeuwoApiResponseV1();
+          const bidsConfig = bidsConfiglike();
+          const conf = configV1();
+          // control xhr api request target for testing
+          conf.params.websiteToAnalyseUrl =
+            "https://publisher.works/article.php?get=horrible_url_for_testing&id=5";
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "The request URL should be a string").to.be.a("string");
+          expect(request.url, "The request URL should include the public API token").to.include(
+            conf.params.neuwoApiToken
+          );
+          expect(request.url, "The request URL should include the encoded website URL").to.include(
+            encodeURIComponent(conf.params.websiteToAnalyseUrl)
+          );
+
+          request.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(apiResponse)
+          );
+          const userData = bidsConfig.ortb2Fragments.global.user.data[0];
+          expect(userData.name, "The data provider name should be correctly set").to.equal(
+            neuwo.DATA_PROVIDER
+          );
+          expect(
+            userData.ext.segtax,
+            "The segtax value should correspond to IAB Audience Taxonomy 1.1"
+          ).to.equal(4);
+          expect(
+            userData.segment[0].id,
+            "The first segment ID should match the API response (transformed from V1)"
+          ).to.equal(apiResponse.marketing_categories.iab_audience_tier_3[0].ID);
+          expect(
+            userData.segment[1].id,
+            "The second segment ID should match the API response (transformed from V1)"
+          ).to.equal(apiResponse.marketing_categories.iab_audience_tier_4[0].ID);
+        });
+      });
+
+      describe("edge cases", function () {
+        it("should not inject data if 'marketing_categories' is missing from the successful API response", function () {
+          const apiResponse = { brand_safety: { BS_score: "1.0" } }; // Missing marketing_categories
+          const bidsConfig = bidsConfiglike();
+          const bidsConfigCopy = bidsConfiglike();
+          const conf = configV1();
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+          request.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(apiResponse)
+          );
+
+          // After a successful response with missing data, the global ortb2 fragments should remain empty
+          // as the data injection logic checks for marketing_categories in V1 format
+          expect(
+            bidsConfig.ortb2Fragments.global,
+            "The global ORTB fragments should remain empty"
+          ).to.deep.equal(bidsConfigCopy.ortb2Fragments.global);
+        });
+
+        it("should handle response with missing marketing_categories", function (done) {
+          const bidsConfig = bidsConfiglike();
+          const conf = configV1();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=no-categories";
+
+          neuwo.getBidRequestData(bidsConfig, () => {
+            // Callback should still be called even without marketing_categories
+            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data;
+            expect(contentData, "No data should be injected without marketing_categories").to.be.undefined;
+            done();
+          }, conf, "consent data");
+
+          const request = server.requests[0];
+          request.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify({ brand_safety: { BS_score: "1.0" } }) // Missing marketing_categories
+          );
+        });
+      });
+    });
+
+    describe("with iabTaxonomyFilters (client-side filtering)", function () {
+      it("should work without filtering when no iabTaxonomyFilters provided", function (done) {
+        const bidsConfig = bidsConfiglike();
+        const conf = configV1();
+
+        neuwo.getBidRequestData(
+          bidsConfig,
+          () => {
+            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+
+            expect(contentData, "should have content data").to.exist;
+            expect(contentData.segment, "should have unfiltered content segments").to.have.lengthOf(2);
+            expect(userData, "should have user data").to.exist;
+            expect(userData.segment, "should have unfiltered audience segments").to.have.lengthOf(3);
+            done();
+          },
+          conf,
+          "consent data"
+        );
+
+        const request = server.requests[0];
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponseV1()));
+      });
+
+      it("should apply client-side filtering when iabTaxonomyFilters are provided", function (done) {
+        const bidsConfig = bidsConfiglike();
+        const conf = configV1();
+        conf.params.iabTaxonomyFilters = {
+          ContentTier1: { limit: 1, threshold: 0.4 },
+          AudienceTier3: { limit: 1, threshold: 0.9 }
+        };
+
+        neuwo.getBidRequestData(
+          bidsConfig,
+          () => {
+            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+
+            expect(contentData, "should have content data").to.exist;
+            expect(contentData.segment, "should have filtered content segments").to.have.lengthOf(2);
+
+            // Check that tier 1 was limited to 1
+            const tier1Items = contentData.segment.filter(s => s.id === "274");
+            expect(tier1Items, "should have only 1 tier 1 item").to.have.lengthOf(1);
+
+            expect(userData, "should have user data").to.exist;
+            // Audience tier 3 should be filtered to 1, but tiers 4 and 5 should remain
+            expect(userData.segment, "should have filtered audience segments").to.have.lengthOf(3);
+
+            done();
+          },
+          conf,
+          "consent data"
+        );
+
+        const request = server.requests[0];
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponseV1()));
+      });
+
+      it("should apply strict client-side filtering that removes all low-relevance items", function (done) {
+        const bidsConfig = bidsConfiglike();
+        const conf = configV1();
+        conf.params.iabTaxonomyFilters = {
+          ContentTier1: { threshold: 0.9 }, // Only keep items with 90%+ relevance
+          ContentTier2: { threshold: 0.9 },
+          AudienceTier4: { threshold: 0.99 },
+          AudienceTier5: { threshold: 0.99 }
+        };
+
+        neuwo.getBidRequestData(
+          bidsConfig,
+          () => {
+            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+
+            expect(contentData, "should have content data").to.exist;
+            // Tier 1 has 0.47, Tier 2 has 0.41 - both below 0.9 threshold
+            // Only tier 3 (empty) should remain, resulting in no segments
+            expect(contentData.segment, "should have no content segments due to strict filtering").to.have.lengthOf(0);
+
+            expect(userData, "should have user data").to.exist;
+            // Tier 3 has 0.9923 (passes), Tier 4 has 0.9673 (fails), Tier 5 has 0.9066 (fails)
+            expect(userData.segment, "should have only 1 audience segment").to.have.lengthOf(1);
+
+            done();
+          },
+          conf,
+          "consent data"
+        );
+
+        const request = server.requests[0];
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponseV1()));
+      });
+
+      it("should handle client-side filtering with cached response", function (done) {
+        const bidsConfig1 = bidsConfiglike();
+        const bidsConfig2 = bidsConfiglike();
+        const conf = configV1();
+        conf.params.iabTaxonomyFilters = {
+          ContentTier1: { limit: 1 }
+        };
+
+        // First request
+        neuwo.getBidRequestData(
+          bidsConfig1,
+          () => {
+          // Second request (should use cache)
+            neuwo.getBidRequestData(
+              bidsConfig2,
+              () => {
+                const contentData = bidsConfig2.ortb2Fragments.global?.site?.content?.data?.[0];
+                expect(contentData, "should have content data from cache").to.exist;
+                expect(contentData.segment, "should apply filtering to cached response").to.have.lengthOf(2);
+                done();
+              },
+              conf,
+              "consent data"
+            );
+          },
+          conf,
+          "consent data"
+        );
+
+        const request = server.requests[0];
+        expect(server.requests, "should only make one API request").to.have.lengthOf(1);
+        request.respond(200, {}, JSON.stringify(getNeuwoApiResponseV1()));
+      });
+    });
+
+    describe("filterIabTaxonomyTier", function () {
       it("should return original array when no filter is provided", function () {
         const taxonomies = [
           { ID: "1", label: "Category 1", relevance: "0.8" },
@@ -1857,133 +2692,215 @@ describe("neuwoRtdModule", function () {
       });
     });
 
-    describe("with iabTaxonomyFilters", function () {
-      it("should work without filtering when no iabTaxonomyFilters provided", function (done) {
-        const bidsConfig = bidsConfiglike();
-        const conf = config();
+    describe("transformSegmentsV1ToV2", function () {
+      it("should transform V1 segment format to V2 format", function () {
+        const v1Segments = [
+          { ID: "274", label: "Home & Garden", relevance: "0.47" },
+          { ID: "216", label: "Cooking", relevance: "0.41" }
+        ];
+        const result = neuwo.transformSegmentsV1ToV2(v1Segments);
 
-        neuwo.getBidRequestData(
-          bidsConfig,
-          () => {
-            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
-            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+        expect(result, "should return array with same length").to.have.lengthOf(2);
+        expect(result[0], "first segment should have id property").to.have.property("id", "274");
+        expect(result[0], "first segment should have name property").to.have.property("name", "Home & Garden");
+        expect(result[0], "first segment should have relevance property").to.have.property("relevance", "0.47");
+        expect(result[1], "second segment should have id property").to.have.property("id", "216");
+        expect(result[1], "second segment should have name property").to.have.property("name", "Cooking");
+        expect(result[1], "second segment should have relevance property").to.have.property("relevance", "0.41");
+      });
 
-            expect(contentData, "should have content data").to.exist;
-            expect(contentData.segment, "should have unfiltered content segments").to.have.lengthOf(2);
-            expect(userData, "should have user data").to.exist;
-            expect(userData.segment, "should have unfiltered audience segments").to.have.lengthOf(3);
-            done();
-          },
-          conf,
-          "consent data"
-        );
+      it("should handle empty array", function () {
+        const result = neuwo.transformSegmentsV1ToV2([]);
+        expect(result, "should return empty array").to.be.an("array").that.is.empty;
+      });
 
-        const request = server.requests[0];
-        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
+      it("should handle null input", function () {
+        const result = neuwo.transformSegmentsV1ToV2(null);
+        expect(result, "should return empty array for null").to.be.an("array").that.is.empty;
       });
 
-      it("should apply filtering when iabTaxonomyFilters are provided", function (done) {
-        const bidsConfig = bidsConfiglike();
-        const conf = config();
-        conf.params.iabTaxonomyFilters = {
-          ContentTier1: { limit: 1, threshold: 0.4 },
-          AudienceTier3: { limit: 1, threshold: 0.9 }
+      it("should handle undefined input", function () {
+        const result = neuwo.transformSegmentsV1ToV2(undefined);
+        expect(result, "should return empty array for undefined").to.be.an("array").that.is.empty;
+      });
+
+      it("should handle non-array input", function () {
+        const result = neuwo.transformSegmentsV1ToV2("not an array");
+        expect(result, "should return empty array for non-array").to.be.an("array").that.is.empty;
+      });
+
+      it("should handle segments with missing properties", function () {
+        const v1Segments = [
+          { ID: "274", label: "Home & Garden" }, // missing relevance
+          { ID: "216", relevance: "0.41" }, // missing label
+          { label: "Test", relevance: "0.5" } // missing ID
+        ];
+        const result = neuwo.transformSegmentsV1ToV2(v1Segments);
+
+        expect(result, "should return array with same length").to.have.lengthOf(3);
+        expect(result[0].id, "should handle missing relevance").to.equal("274");
+        expect(result[0].relevance, "should set undefined for missing relevance").to.be.undefined;
+        expect(result[1].name, "should set undefined for missing label").to.be.undefined;
+        expect(result[2].id, "should set undefined for missing ID").to.be.undefined;
+      });
+
+      it("should preserve all properties from V1 format", function () {
+        const v1Segments = [
+          { ID: "49", label: "Female", relevance: "0.9923" }
+        ];
+        const result = neuwo.transformSegmentsV1ToV2(v1Segments);
+
+        expect(result[0], "should only have id, name, and relevance properties").to.have.all.keys("id", "name", "relevance");
+      });
+    });
+
+    describe("transformV1ResponseToV2", function () {
+      it("should transform complete V1 response to V2 format", function () {
+        const v1Response = {
+          marketing_categories: {
+            iab_tier_1: [{ ID: "274", label: "Home & Garden", relevance: "0.47" }],
+            iab_tier_2: [{ ID: "216", label: "Cooking", relevance: "0.41" }],
+            iab_tier_3: [{ ID: "388", label: "Recipes", relevance: "0.35" }],
+            iab_audience_tier_3: [{ ID: "49", label: "Female", relevance: "0.9923" }],
+            iab_audience_tier_4: [{ ID: "431", label: "Age 25-34", relevance: "0.9673" }],
+            iab_audience_tier_5: [{ ID: "98", label: "Interest: Cooking", relevance: "0.9066" }]
+          }
         };
+        const contentSegtax = 7; // IAB Content Taxonomy 3.0
+        const result = neuwo.transformV1ResponseToV2(v1Response, contentSegtax);
+
+        expect(result, "should have content segtax key").to.have.property("7");
+        expect(result, "should have audience segtax key").to.have.property("4");
+        expect(result["7"], "content segtax should have all tiers").to.have.all.keys("1", "2", "3");
+        expect(result["4"], "audience segtax should have all tiers").to.have.all.keys("3", "4", "5");
+        expect(result["7"]["1"][0], "content tier 1 should be transformed").to.deep.equal({
+          id: "274",
+          name: "Home & Garden",
+          relevance: "0.47"
+        });
+        expect(result["4"]["3"][0], "audience tier 3 should be transformed").to.deep.equal({
+          id: "49",
+          name: "Female",
+          relevance: "0.9923"
+        });
+      });
 
-        neuwo.getBidRequestData(
-          bidsConfig,
-          () => {
-            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
-            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+      it("should handle different content segtax values", function () {
+        const v1Response = {
+          marketing_categories: {
+            iab_tier_1: [{ ID: "274", label: "Home & Garden", relevance: "0.47" }]
+          }
+        };
 
-            expect(contentData, "should have content data").to.exist;
-            expect(contentData.segment, "should have filtered content segments").to.have.lengthOf(2);
+        // Test with segtax 6 (IAB 2.2)
+        const result6 = neuwo.transformV1ResponseToV2(v1Response, 6);
+        expect(result6, "should use segtax 6 for content").to.have.property("6");
+        expect(result6["6"], "should have tier 1").to.have.property("1");
 
-            // Check that tier 1 was limited to 1
-            const tier1Items = contentData.segment.filter(s => s.id === "274");
-            expect(tier1Items, "should have only 1 tier 1 item").to.have.lengthOf(1);
+        // Test with segtax 1 (IAB 1.0)
+        const result1 = neuwo.transformV1ResponseToV2(v1Response, 1);
+        expect(result1, "should use segtax 1 for content").to.have.property("1");
+        expect(result1["1"], "should have tier 1").to.have.property("1");
+      });
 
-            expect(userData, "should have user data").to.exist;
-            // Audience tier 3 should be filtered to 1, but tiers 4 and 5 should remain
-            expect(userData.segment, "should have filtered audience segments").to.have.lengthOf(3);
+      it("should handle missing marketing_categories", function () {
+        const v1Response = {};
+        const result = neuwo.transformV1ResponseToV2(v1Response, 6);
 
-            done();
-          },
-          conf,
-          "consent data"
-        );
+        expect(result, "should have content segtax key").to.have.property("6");
+        expect(result, "should have audience segtax key").to.have.property("4");
+        expect(result["6"], "content segtax should be empty object").to.deep.equal({});
+        expect(result["4"], "audience segtax should be empty object").to.deep.equal({});
+      });
 
-        const request = server.requests[0];
-        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
+      it("should handle null v1Response", function () {
+        const result = neuwo.transformV1ResponseToV2(null, 6);
+
+        expect(result, "should have content segtax key").to.have.property("6");
+        expect(result, "should have audience segtax key").to.have.property("4");
+        expect(result["6"], "content segtax should be empty object").to.deep.equal({});
+        expect(result["4"], "audience segtax should be empty object").to.deep.equal({});
       });
 
-      it("should apply strict filtering that removes all low-relevance items", function (done) {
-        const bidsConfig = bidsConfiglike();
-        const conf = config();
-        conf.params.iabTaxonomyFilters = {
-          ContentTier1: { threshold: 0.9 }, // Only keep items with 90%+ relevance
-          ContentTier2: { threshold: 0.9 },
-          AudienceTier4: { threshold: 0.99 },
-          AudienceTier5: { threshold: 0.99 }
+      it("should handle undefined v1Response", function () {
+        const result = neuwo.transformV1ResponseToV2(undefined, 6);
+
+        expect(result, "should have content segtax key").to.have.property("6");
+        expect(result, "should have audience segtax key").to.have.property("4");
+        expect(result["6"], "content segtax should be empty object").to.deep.equal({});
+        expect(result["4"], "audience segtax should be empty object").to.deep.equal({});
+      });
+
+      it("should handle partial V1 response with only content tiers", function () {
+        const v1Response = {
+          marketing_categories: {
+            iab_tier_1: [{ ID: "274", label: "Home & Garden", relevance: "0.47" }],
+            iab_tier_2: [{ ID: "216", label: "Cooking", relevance: "0.41" }]
+            // No tier 3, no audience tiers
+          }
         };
+        const result = neuwo.transformV1ResponseToV2(v1Response, 6);
 
-        neuwo.getBidRequestData(
-          bidsConfig,
-          () => {
-            const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
-            const userData = bidsConfig.ortb2Fragments.global?.user?.data?.[0];
+        expect(result["6"], "should have only tier 1 and 2").to.have.all.keys("1", "2");
+        expect(result["6"], "should not have tier 3").to.not.have.property("3");
+        expect(result["4"], "audience segtax should be empty").to.deep.equal({});
+      });
 
-            expect(contentData, "should have content data").to.exist;
-            // Tier 1 has 0.47, Tier 2 has 0.41 - both below 0.9 threshold
-            // Only tier 3 (empty) should remain, resulting in no segments
-            expect(contentData.segment, "should have no content segments due to strict filtering").to.have.lengthOf(0);
+      it("should handle partial V1 response with only audience tiers", function () {
+        const v1Response = {
+          marketing_categories: {
+            iab_audience_tier_3: [{ ID: "49", label: "Female", relevance: "0.9923" }],
+            iab_audience_tier_4: [{ ID: "431", label: "Age 25-34", relevance: "0.9673" }]
+            // No content tiers
+          }
+        };
+        const result = neuwo.transformV1ResponseToV2(v1Response, 6);
 
-            expect(userData, "should have user data").to.exist;
-            // Tier 3 has 0.9923 (passes), Tier 4 has 0.9673 (fails), Tier 5 has 0.9066 (fails)
-            expect(userData.segment, "should have only 1 audience segment").to.have.lengthOf(1);
+        expect(result["6"], "content segtax should be empty").to.deep.equal({});
+        expect(result["4"], "should have tier 3 and 4").to.have.all.keys("3", "4");
+        expect(result["4"], "should not have tier 5").to.not.have.property("5");
+      });
 
-            done();
-          },
-          conf,
-          "consent data"
-        );
+      it("should handle empty arrays in V1 response", function () {
+        const v1Response = {
+          marketing_categories: {
+            iab_tier_1: [],
+            iab_tier_2: [],
+            iab_audience_tier_3: []
+          }
+        };
+        const result = neuwo.transformV1ResponseToV2(v1Response, 6);
 
-        const request = server.requests[0];
-        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
+        expect(result["6"]["1"], "content tier 1 should be empty array").to.be.an("array").that.is.empty;
+        expect(result["6"]["2"], "content tier 2 should be empty array").to.be.an("array").that.is.empty;
+        expect(result["4"]["3"], "audience tier 3 should be empty array").to.be.an("array").that.is.empty;
       });
 
-      it("should handle filtering with cached response", function (done) {
-        const bidsConfig1 = bidsConfiglike();
-        const bidsConfig2 = bidsConfiglike();
-        const conf = config();
-        conf.params.iabTaxonomyFilters = {
-          ContentTier1: { limit: 1 }
+      it("should convert segtax to string keys", function () {
+        const v1Response = {
+          marketing_categories: {
+            iab_tier_1: [{ ID: "274", label: "Home & Garden", relevance: "0.47" }]
+          }
         };
+        const result = neuwo.transformV1ResponseToV2(v1Response, 6);
 
-        // First request
-        neuwo.getBidRequestData(
-          bidsConfig1,
-          () => {
-          // Second request (should use cache)
-            neuwo.getBidRequestData(
-              bidsConfig2,
-              () => {
-                const contentData = bidsConfig2.ortb2Fragments.global?.site?.content?.data?.[0];
-                expect(contentData, "should have content data from cache").to.exist;
-                expect(contentData.segment, "should apply filtering to cached response").to.have.lengthOf(2);
-                done();
-              },
-              conf,
-              "consent data"
-            );
+        expect(Object.keys(result), "segtax keys should be strings").to.include.members(["6", "4"]);
+        expect(typeof Object.keys(result)[0], "key type should be string").to.equal("string");
+      });
+
+      it("should preserve brand_safety and other non-marketing_categories fields", function () {
+        const v1Response = {
+          brand_safety: { BS_score: "1.0" },
+          marketing_categories: {
+            iab_tier_1: [{ ID: "274", label: "Home & Garden", relevance: "0.47" }]
           },
-          conf,
-          "consent data"
-        );
+          custom_field: "value"
+        };
+        const result = neuwo.transformV1ResponseToV2(v1Response, 6);
 
-        const request = server.requests[0];
-        expect(server.requests, "should only make one API request").to.have.lengthOf(1);
-        request.respond(200, {}, JSON.stringify(getNeuwoApiResponse()));
+        expect(result, "should not have brand_safety").to.not.have.property("brand_safety");
+        expect(result, "should not have custom_field").to.not.have.property("custom_field");
+        expect(result, "should only have segtax keys").to.have.all.keys("6", "4");
       });
     });
   });

From 39039ef9f42b49c1f68e52800207c61d370f3508 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 21 Jan 2026 09:06:03 +0100
Subject: [PATCH 18/24] docs: update Neuwo RTD Module documentation for new API
 version

- Change default IAB Content Taxonomy version from "3.0" to "2.2"
- Add IAB Content Taxonomy version "1.0" to supported values list
- Add server-side filtering explanation to IAB Taxonomy Filtering section
- Update Available Tiers table to focus on taxonomy types instead of API internals
- Add recommended configuration comments for `auctionDelay` and `waitForIt`
- Update all configuration examples to use "2.2" as default taxonomy version
- Remove "How it works" section
---
 modules/neuwoRtdProvider.md | 47 +++++++++++++++++--------------------
 1 file changed, 21 insertions(+), 26 deletions(-)

diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index acf0ca4dfa1..c49cdb69ef7 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -58,15 +58,15 @@ This module is configured as part of the `realTimeData.dataProviders` object.
 ```javascript
 pbjs.setConfig({
   realTimeData: {
-    auctionDelay: 500, // Value can be adjusted based on the needs
+    auctionDelay: 500, // Value can be adjusted based on the needs. Recommended to start with value `500`
     dataProviders: [
       {
         name: "NeuwoRTDModule",
-        waitForIt: true,
+        waitForIt: true, // Recommended to be set to `true`
         params: {
           neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
           neuwoApiToken: "<Your Neuwo API Token>",
-          iabContentTaxonomyVersion: "3.0",
+          iabContentTaxonomyVersion: "2.2",
           enableCache: true, // Default: true. Caches API responses to avoid redundant requests
         },
       },
@@ -83,7 +83,7 @@ pbjs.setConfig({
 | `params`                            | Object   | Yes      |         | Container for module-specific parameters.                                                                                                                                                                                                                                                                                  |
 | `params.neuwoApiUrl`                | String   | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                                                                                                                                                                                                                                                   |
 | `params.neuwoApiToken`              | String   | Yes      |         | Your unique API token provided by Neuwo.                                                                                                                                                                                                                                                                                   |
-| `params.iabContentTaxonomyVersion`  | String   | No       | `'3.0'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'2.2'`, `'3.0'`.                                                                                                                                                                                                                          |
+| `params.iabContentTaxonomyVersion`  | String   | No       | `'2.2'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'1.0'`, `'2.2'`, `'3.0'`.                                                                                                                                                                                                                 |
 | `params.enableCache`                | Boolean  | No       | `true`  | If `true`, caches API responses to avoid redundant requests for the same page during the session. Set to `false` to disable caching and make a fresh API call on every bid request.                                                                                                                                        |
 | `params.stripAllQueryParams`        | Boolean  | No       | `false` | If `true`, strips all query parameters from the URL before analysis. Takes precedence over other stripping options.                                                                                                                                                                                                        |
 | `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains. |
@@ -104,15 +104,15 @@ The module provides optional URL cleaning capabilities to strip query parameters
 ```javascript
 pbjs.setConfig({
   realTimeData: {
-    auctionDelay: 500, // Value can be adjusted based on the needs
+    auctionDelay: 500, // Value can be adjusted based on the needs. Recommended to start with value `500`
     dataProviders: [
       {
         name: "NeuwoRTDModule",
-        waitForIt: true,
+        waitForIt: true, // Recommended to be set to `true`
         params: {
           neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
           neuwoApiToken: "<Your Neuwo API Token>",
-          iabContentTaxonomyVersion: "3.0",
+          iabContentTaxonomyVersion: "2.2",
 
           // Option 1: Strip all query parameters from the URL
           stripAllQueryParams: true,
@@ -134,7 +134,7 @@ pbjs.setConfig({
 
 ### IAB Taxonomy Filtering
 
-The module provides optional per-tier filtering for IAB taxonomies to control the quantity and quality of categories injected into bid requests. This allows you to limit categories based on their relevance score and restrict the maximum number of categories per tier.
+The module provides optional per-tier filtering for IAB taxonomies to control the quantity and quality of categories injected into bid requests. This allows you to limit categories based on their relevance score and restrict the maximum number of categories per tier. Filtering is performed server-side, which means only the filtered categories are returned in the response. This reduces bandwidth and improves performance.
 
 **Filter Configuration:**
 
@@ -145,29 +145,29 @@ Each tier can have two optional parameters:
 
 **Available Tiers:**
 
-| Tier Name       | Description         | API Response Key      |
-| :-------------- | :------------------ | :-------------------- |
-| `ContentTier1`  | IAB Content Tier 1  | `iab_tier_1`          |
-| `ContentTier2`  | IAB Content Tier 2  | `iab_tier_2`          |
-| `ContentTier3`  | IAB Content Tier 3  | `iab_tier_3`          |
-| `AudienceTier3` | IAB Audience Tier 3 | `iab_audience_tier_3` |
-| `AudienceTier4` | IAB Audience Tier 4 | `iab_audience_tier_4` |
-| `AudienceTier5` | IAB Audience Tier 5 | `iab_audience_tier_5` |
+| Tier Name       | Description         | IAB Taxonomy                         |
+| :-------------- | :------------------ | :----------------------------------- |
+| `ContentTier1`  | IAB Content Tier 1  | Based on configured taxonomy version |
+| `ContentTier2`  | IAB Content Tier 2  | Based on configured taxonomy version |
+| `ContentTier3`  | IAB Content Tier 3  | Based on configured taxonomy version |
+| `AudienceTier3` | IAB Audience Tier 3 | IAB Audience Taxonomy 1.1 (segtax 4) |
+| `AudienceTier4` | IAB Audience Tier 4 | IAB Audience Taxonomy 1.1 (segtax 4) |
+| `AudienceTier5` | IAB Audience Tier 5 | IAB Audience Taxonomy 1.1 (segtax 4) |
 
 **Example with IAB taxonomy filtering:**
 
 ```javascript
 pbjs.setConfig({
   realTimeData: {
-    auctionDelay: 500,
+    auctionDelay: 500, // Value can be adjusted based on the needs. Recommended to start with value `500`
     dataProviders: [
       {
         name: "NeuwoRTDModule",
-        waitForIt: true,
+        waitForIt: true, // Recommended to be set to `true`
         params: {
           neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
           neuwoApiToken: "<Your Neuwo API Token>",
-          iabContentTaxonomyVersion: "3.0",
+          iabContentTaxonomyVersion: "2.2",
 
           // Filter IAB taxonomies by tier
           iabTaxonomyFilters: {
@@ -196,13 +196,6 @@ pbjs.setConfig({
 });
 ```
 
-**How it works:**
-
-1. Categories are first filtered by the `threshold` value (if specified)
-2. Remaining categories are sorted by relevance score in descending order (highest first)
-3. The top N categories are selected based on the `limit` value (if specified)
-4. Tiers without filters configured will use all categories returned by the API
-
 ## Accessing Neuwo Data Outside Prebid.js
 
 The Neuwo RTD module enriches bid requests with contextual data that can be accessed in application code for analytics, targeting, integration with Google Ad Manager as [Publisher Provided Signals (PPS)](https://support.google.com/admanager/answer/15287325) or other purposes. The enriched data is available through Prebid.js events.
@@ -324,3 +317,5 @@ google-chrome build/coverage/lcov-report/index.html
 ```
 
 Navigate to `modules/neuwoRtdProvider.js` in the report to see detailed line-by-line coverage with highlighted covered/uncovered lines.
+
+> Version **2.0.0**

From 31c03e79119f7e124d8506f633bfdc960830a4cf Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 21 Jan 2026 18:46:22 +0100
Subject: [PATCH 19/24] feat: add OpenRTB 2.5 category fields support to Neuwo
 RTD Module

Add support for populating OpenRTB 2.5 category fields (`site.cat`, `site.sectioncat`, `site.pagecat`, `site.content.cat`) with IAB Content Taxonomy 1.0 segments.

Changes:
- Add `enableOrtb25Fields` configuration parameter (default: true)
- Add `extractCategoryIds()` helper function to extract segment IDs from tier data
- Refactor `buildIabData()` to use `extractCategoryIds()` for code reuse
- Extend `buildIabFilterConfig()` to apply filters to IAB 1.0 when feature enabled
- Modify `getBidRequestData()` to request IAB 1.0 data (segtax 1) when feature enabled
- Add warning when feature enabled with legacy API endpoint
- Extend `injectIabCategories()` to populate four OpenRTB 2.5 category fields
- Update version to 2.1.0
---
 modules/neuwoRtdProvider.js | 141 ++++++++++++++++++++++++++++++------
 1 file changed, 119 insertions(+), 22 deletions(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index bb653036c43..d7a593e1790 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -1,6 +1,6 @@
 /**
  * @module neuwoRtdProvider
- * @version 2.0.0
+ * @version 2.1.0
  * @author Grzegorz Malisz
  * @see {project-root-directory}/integrationExamples/gpt/neuwoRtdProvider_example.html for an example/testing page.
  * @see {project-root-directory}/test/spec/modules/neuwoRtdProvider_spec.js for unit tests.
@@ -10,6 +10,8 @@
  * It fetches contextual marketing categories (IAB content and audience) for the current page from the Neuwo API.
  * The retrieved data is then injected into the bid request as OpenRTB (ORTB2) `site.content.data`
  * and `user.data` fragments, making it available for bidders to use in their decisioning process.
+ * Additionally, when enabled, the module populates OpenRTB 2.5 category fields (`ortb2.site.cat`,
+ * `ortb2.site.sectioncat`, `ortb2.site.pagecat`, `ortb2.site.content.cat`) with IAB Content Taxonomy 1.0 segments.
  *
  * @see {@link https://docs.prebid.org/dev-docs/add-rtd-submodule.html} for more information on development of Prebid.js RTD modules.
  * @see {@link https://docs.prebid.org/features/firstPartyData.html} for more information on Prebid.js First Party Data.
@@ -19,7 +21,13 @@
 import { ajax } from "../src/ajax.js";
 import { submodule } from "../src/hook.js";
 import { getRefererInfo } from "../src/refererDetection.js";
-import { deepSetValue, logError, logInfo, mergeDeep } from "../src/utils.js";
+import {
+  deepSetValue,
+  logError,
+  logInfo,
+  logWarn,
+  mergeDeep,
+} from "../src/utils.js";
 
 const MODULE_NAME = "NeuwoRTDModule";
 export const DATA_PROVIDER = "www.neuwo.ai";
@@ -90,6 +98,7 @@ function init(config, userConsent) {
  * @param {string} [config.params.websiteToAnalyseUrl] Optional URL to analyze instead of current page.
  * @param {string} [config.params.iabContentTaxonomyVersion="2.2"] IAB Content Taxonomy version.
  * @param {boolean} [config.params.enableCache=true] If true, caches API responses to avoid redundant requests.
+ * @param {boolean} [config.params.enableOrtb25Fields=true] If true, populates OpenRTB 2.5 category fields (site.cat, site.sectioncat, site.pagecat, site.content.cat) with IAB Content Taxonomy 1.0 segments.
  * @param {boolean} [config.params.stripAllQueryParams] If true, strips all query parameters from the URL.
  * @param {string[]} [config.params.stripQueryParamsForDomains] List of domains for which to strip all query params.
  * @param {string[]} [config.params.stripQueryParams] List of specific query parameter names to strip.
@@ -116,6 +125,7 @@ export function getBidRequestData(
     neuwoApiToken,
     iabContentTaxonomyVersion = DEFAULT_IAB_CONTENT_TAXONOMY_VERSION,
     enableCache = true,
+    enableOrtb25Fields = true,
     stripAllQueryParams,
     stripQueryParamsForDomains,
     stripQueryParams,
@@ -138,10 +148,20 @@ export function getBidRequestData(
   // Detect API version from URL
   const isV2Api = neuwoApiUrl.includes("/v1/iab");
 
+  // Warn if OpenRTB 2.5 feature enabled with legacy API
+  if (enableOrtb25Fields && !isV2Api) {
+    logWarn(
+      MODULE_NAME,
+      "getBidRequestData():",
+      "OpenRTB 2.5 category fields are only supported with /v1/iab endpoint"
+    );
+  }
+
   // Build IAB filter configuration
   const iabFilterConfig = buildIabFilterConfig(
     iabTaxonomyFilters,
-    contentSegtax
+    contentSegtax,
+    enableOrtb25Fields
   );
 
   const joiner = neuwoApiUrl.indexOf("?") < 0 ? "?" : "&";
@@ -155,6 +175,11 @@ export function getBidRequestData(
   if (isV2Api) {
     urlParams.push("iabVersions=" + contentSegtax);
     urlParams.push("iabVersions=4"); // IAB Audience 1.1
+
+    // Request IAB 1.0 for OpenRTB 2.5 fields if feature enabled
+    if (enableOrtb25Fields) {
+      urlParams.push("iabVersions=1"); // IAB Content 1.0
+    }
   }
 
   const neuwoApiUrlFull = neuwoApiUrl + joiner + urlParams.join("&");
@@ -173,7 +198,8 @@ export function getBidRequestData(
     injectIabCategories(
       globalCachedResponse,
       reqBidsConfigObj,
-      iabContentTaxonomyVersion
+      iabContentTaxonomyVersion,
+      enableOrtb25Fields
     );
     callback();
   } else if (enableCache && pendingRequest) {
@@ -190,7 +216,8 @@ export function getBidRequestData(
           injectIabCategories(
             responseParsed,
             reqBidsConfigObj,
-            iabContentTaxonomyVersion
+            iabContentTaxonomyVersion,
+            enableOrtb25Fields
           );
         }
       })
@@ -243,7 +270,8 @@ export function getBidRequestData(
               injectIabCategories(
                 responseParsed,
                 reqBidsConfigObj,
-                iabContentTaxonomyVersion
+                iabContentTaxonomyVersion,
+                enableOrtb25Fields
               );
               resolve(responseParsed);
             } catch (ex) {
@@ -402,23 +430,18 @@ export function injectOrtbData(reqBidsConfigObj, path, data) {
 }
 
 /**
- * Builds an IAB category data object for OpenRTB injection.
- * Dynamically processes all tiers present in the response data.
+ * Extracts all segment IDs from tier data into a flat array.
+ * Used for populating OpenRTB 2.5 category fields and building IAB data objects.
  *
- * @param {Object} tierData The tier data keyed by tier numbers (e.g., {"1": [...], "2": [...], "3": [...]}).
- * @param {number} segtax The IAB Taxonomy segtax ID.
- * @returns {Object} The OpenRTB data object with name, segment array, and ext.segtax.
+ * @param {Object} tierData The tier data keyed by tier numbers (e.g., {"1": [{id: "IAB12"}], "2": [...]}).
+ * @returns {Array<string>} Flat array of segment IDs (e.g., ["IAB12", "IAB12-3", "IAB12-5"]).
  */
-export function buildIabData(tierData, segtax) {
-  const data = {
-    name: DATA_PROVIDER,
-    segment: [],
-    ext: { segtax },
-  };
+export function extractCategoryIds(tierData) {
+  const ids = [];
 
   // Handle null, undefined, or non-object tierData
   if (!tierData || typeof tierData !== "object") {
-    return data;
+    return ids;
   }
 
   // Process ALL tier keys present in tierData
@@ -427,13 +450,30 @@ export function buildIabData(tierData, segtax) {
     if (Array.isArray(segments)) {
       segments.forEach((item) => {
         if (item?.id) {
-          data.segment.push({ id: item.id });
+          ids.push(item.id);
         }
       });
     }
   });
 
-  return data;
+  return ids;
+}
+
+/**
+ * Builds an IAB category data object for OpenRTB injection.
+ * Dynamically processes all tiers present in the response data.
+ *
+ * @param {Object} tierData The tier data keyed by tier numbers (e.g., {"1": [...], "2": [...], "3": [...]}).
+ * @param {number} segtax The IAB Taxonomy segtax ID.
+ * @returns {Object} The OpenRTB data object with name, segment array, and ext.segtax.
+ */
+export function buildIabData(tierData, segtax) {
+  const ids = extractCategoryIds(tierData);
+  return {
+    name: DATA_PROVIDER,
+    segment: ids.map((id) => ({ id })),
+    ext: { segtax },
+  };
 }
 
 /**
@@ -633,9 +673,14 @@ export function transformSegmentsV1ToV2(segments) {
  *
  * @param {Object} iabTaxonomyFilters Publisher's tier filter configuration using human-readable tier names.
  * @param {number} contentSegtax The segtax ID for content taxonomies (determined by iabContentTaxonomyVersion).
+ * @param {boolean} [enableOrtb25Fields=true] If true, also applies filters to IAB COntent Taxonomy 1.0 (segtax 1) for OpenRTB 2.5 category fields.
  * @returns {Object} Filter configuration in segtax-based structure.
  */
-export function buildIabFilterConfig(iabTaxonomyFilters, contentSegtax) {
+export function buildIabFilterConfig(
+  iabTaxonomyFilters,
+  contentSegtax,
+  enableOrtb25Fields = true
+) {
   const TIER_TO_SEGTAX = {
     ContentTier1: { segtax: contentSegtax, tier: "1" },
     ContentTier2: { segtax: contentSegtax, tier: "2" },
@@ -654,6 +699,28 @@ export function buildIabFilterConfig(iabTaxonomyFilters, contentSegtax) {
       body[segtaxKey][mapping.tier] = filter;
     }
   });
+
+  // Apply same filters to IAB 1.0 (segtax 1) for OpenRTB 2.5 fields
+  // Note: IAB 1.0 only has tiers 1 and 2 (tier 3 will be ignored if configured)
+  if (enableOrtb25Fields && iabTaxonomyFilters) {
+    const segtax1Config = {};
+
+    // Apply ContentTier1 filters to segtax 1, tier 1
+    if (iabTaxonomyFilters.ContentTier1) {
+      segtax1Config["1"] = iabTaxonomyFilters.ContentTier1;
+    }
+
+    // Apply ContentTier2 filters to segtax 1, tier 2
+    if (iabTaxonomyFilters.ContentTier2) {
+      segtax1Config["2"] = iabTaxonomyFilters.ContentTier2;
+    }
+
+    // Only add segtax 1 config if there are filters
+    if (Object.keys(segtax1Config).length > 0) {
+      body["1"] = segtax1Config;
+    }
+  }
+
   return body;
 }
 
@@ -664,17 +731,20 @@ export function buildIabFilterConfig(iabTaxonomyFilters, contentSegtax) {
  * Response format: { "6": { "1": [{id, name}], "2": [...] }, "4": { "3": [...], "4": [...] } }
  * - Content taxonomies are injected into ortb2.site.content.data
  * - Audience taxonomies are injected into ortb2.user.data
+ * - If enableOrtb25Fields is true, IAB 1.0 segments are injected into OpenRTB 2.5 category fields
  *
  * Only injects data if segments exist to avoid adding empty data structures.
  *
  * @param {Object} responseParsed The parsed API response.
  * @param {Object} reqBidsConfigObj The bid request configuration object to be enriched.
  * @param {string} iabContentTaxonomyVersion The IAB Content Taxonomy version for segtax mapping.
+ * @param {boolean} [enableOrtb25Fields=true] If true, populates OpenRTB 2.5 category fields with IAB Content Taxonomy 1.0 segments.
  */
 export function injectIabCategories(
   responseParsed,
   reqBidsConfigObj,
-  iabContentTaxonomyVersion
+  iabContentTaxonomyVersion,
+  enableOrtb25Fields = true
 ) {
   if (!responseParsed || typeof responseParsed !== "object") {
     logError(MODULE_NAME, "injectIabCategories():", "Invalid response format");
@@ -725,6 +795,33 @@ export function injectIabCategories(
       "No segments to inject, skipping data injection"
     );
   }
+
+  // Inject OpenRTB 2.5 category fields if feature enabled
+  if (enableOrtb25Fields) {
+    const iab10Tiers = responseParsed["1"] || {}; // Segtax 1 = IAB Content 1.0
+    const categoryIds = extractCategoryIds(iab10Tiers); // ["IAB12", "IAB12-3", ...]
+
+    if (categoryIds.length > 0) {
+      // Inject same array into all four OpenRTB 2.5 category fields
+      injectOrtbData(reqBidsConfigObj, "site.cat", categoryIds);
+      injectOrtbData(reqBidsConfigObj, "site.sectioncat", categoryIds);
+      injectOrtbData(reqBidsConfigObj, "site.pagecat", categoryIds);
+      injectOrtbData(reqBidsConfigObj, "site.content.cat", categoryIds);
+
+      logInfo(
+        MODULE_NAME,
+        "injectIabCategories():",
+        "Injected OpenRTB 2.5 category fields:",
+        categoryIds
+      );
+    } else {
+      logInfo(
+        MODULE_NAME,
+        "injectIabCategories():",
+        "No IAB 1.0 segments available for OpenRTB 2.5 fields"
+      );
+    }
+  }
 }
 
 export const neuwoRtdModule = {

From eaf4ed918db7c6c15e2e29cb51e3a4c067a1b49d Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 21 Jan 2026 18:48:26 +0100
Subject: [PATCH 20/24] ci: add OpenRTB 2.5 category fields support to
 integration example

Changes:
- Add checkbox UI control for `enableOrtb25Fields` option (default: checked)
- Add display section for OpenRTB 2.5 category fields data
- Extract and display `site.cat`, `site.sectioncat`, `site.pagecat`, and `site.content.cat` fields
- Update `bidRequested` event handler to capture category fields
- Add localStorage persistence for `enableOrtb25Fields` setting
- Pass `enableOrtb25Fields` parameter to module configuration
---
 .../gpt/neuwoRtdProvider_example.html         | 42 +++++++++++++++++--
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/integrationExamples/gpt/neuwoRtdProvider_example.html b/integrationExamples/gpt/neuwoRtdProvider_example.html
index 97e72562b86..68c95fe8b4f 100644
--- a/integrationExamples/gpt/neuwoRtdProvider_example.html
+++ b/integrationExamples/gpt/neuwoRtdProvider_example.html
@@ -125,6 +125,10 @@
             const inputEnableCache = document.getElementById("enable-cache");
             const enableCache = inputEnableCache ? inputEnableCache.checked : undefined;
 
+            // OpenRTB 2.5 Category Fields Option
+            const inputEnableOrtb25Fields = document.getElementById("enable-ortb25-fields");
+            const enableOrtb25Fields = inputEnableOrtb25Fields ? inputEnableOrtb25Fields.checked : true;
+
             // URL Stripping Options
             const inputStripAllQueryParams = document.getElementById("strip-all-query-params");
             const stripAllQueryParams = inputStripAllQueryParams ? inputStripAllQueryParams.checked : undefined;
@@ -169,6 +173,7 @@
                                     websiteToAnalyseUrl,
                                     iabContentTaxonomyVersion,
                                     enableCache,
+                                    enableOrtb25Fields,
                                     stripAllQueryParams,
                                     stripQueryParamsForDomains,
                                     stripQueryParams,
@@ -248,6 +253,14 @@ <h3>Cache Options</h3>
             </label>
         </div>
 
+        <h3>OpenRTB 2.5 Category Fields</h3>
+        <div style="margin-bottom: 10px;">
+            <label>
+                <input type="checkbox" id="enable-ortb25-fields" checked />
+                Enable OpenRTB 2.5 category fields (default: enabled)
+            </label>
+        </div>
+
         <h3>URL Cleaning Options</h3>
         <div style="margin-bottom: 5px;">
             <label>
@@ -334,6 +347,9 @@ <h3>Neuwo Site Content Data</h3>
         <h3>Neuwo User Data</h3>
         <pre id="neuwo-user-data"
             style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data.</pre>
+        <h3>Neuwo OpenRTB 2.5 Category Fields (IAB Content Taxonomy 1.0) Data</h3>
+        <pre id="neuwo-ortb25-fields"
+            style="background: #f4f4f4; padding: 10px; overflow-x: auto; max-height: 300px;">No data yet. Click "Update" to fetch data (requires enableOrtb25Fields and /v1/iab endpoint).</pre>
     </div>
 
     <div>
@@ -385,14 +401,23 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
                 const neuwoSiteData = siteContentData?.find(d => d.name === "www.neuwo.ai");
                 const neuwoUserData = userData?.find(d => d.name === "www.neuwo.ai");
 
+                // Extract OpenRTB 2.5 category fields
+                const ortb25Fields = {
+                    "site.cat": ortb2?.site?.cat,
+                    "site.sectioncat": ortb2?.site?.sectioncat,
+                    "site.pagecat": ortb2?.site?.pagecat,
+                    "site.content.cat": ortb2?.site?.content?.cat
+                };
+
                 // Store in global variable for later use
                 neuwoData = {
                     siteContent: neuwoSiteData,
-                    user: neuwoUserData
+                    user: neuwoUserData,
+                    ortb25Fields: ortb25Fields
                 };
                 console.log("Neuwo data stored in global \"neuwoData\" variable:", neuwoData);
 
-                updateDisplayElements(neuwoSiteData, neuwoUserData)
+                updateDisplayElements(neuwoSiteData, neuwoUserData, ortb25Fields)
             } else {
                 console.warn("No ortb2 data found in bidRequest. This may indicate the RTD module has not enriched the bid request yet.");
             }
@@ -400,9 +425,11 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
     });
 
     // Helper to update display elements
-    function updateDisplayElements(neuwoSiteData, neuwoUserData) {
+    function updateDisplayElements(neuwoSiteData, neuwoUserData, ortb25Fields) {
         const siteDataEl = document.getElementById("neuwo-site-data");
         const userDataEl = document.getElementById("neuwo-user-data");
+        const ortb25El = document.getElementById("neuwo-ortb25-fields");
+
         if (siteDataEl) {
             siteDataEl.textContent = neuwoSiteData
                 ? JSON.stringify(neuwoSiteData, null, 2)
@@ -413,6 +440,12 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
                 ? JSON.stringify(neuwoUserData, null, 2)
                 : "No Neuwo user data found in response.";
         }
+        if (ortb25El && ortb25Fields) {
+            const hasData = Object.values(ortb25Fields).some(val => val && val.length > 0);
+            ortb25El.textContent = hasData
+                ? JSON.stringify(ortb25Fields, null, 2)
+                : "No OpenRTB 2.5 category fields found (requires enableOrtb25Fields=true and /v1/iab endpoint).";
+        }
     }
 
     /*
@@ -564,6 +597,7 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
             websiteToAnalyseUrl: document.getElementById("website-to-analyse-url")?.value || "",
             iabContentTaxonomyVersion: document.getElementById("iab-content-taxonomy-version")?.value || "",
             enableCache: document.getElementById("enable-cache")?.checked !== false,
+            enableOrtb25Fields: document.getElementById("enable-ortb25-fields")?.checked !== false,
             stripAllQueryParams: document.getElementById("strip-all-query-params")?.checked || false,
             stripQueryParamsForDomains: document.getElementById("strip-query-params-for-domains")?.value || "",
             stripQueryParams: document.getElementById("strip-query-params")?.value || "",
@@ -590,6 +624,7 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
 
             // Restore checkboxes
             document.getElementById("enable-cache").checked = config.enableCache !== false;
+            document.getElementById("enable-ortb25-fields").checked = config.enableOrtb25Fields !== false;
             document.getElementById("strip-all-query-params").checked = config.stripAllQueryParams;
             document.getElementById("strip-fragments").checked = config.stripFragments;
             document.getElementById("enable-iab-filtering").checked = config.enableIabFiltering;
@@ -611,6 +646,7 @@ <h2>Accessing Neuwo Data in JavaScript</h2>
 
         const checkboxIds = [
             "enable-cache",
+            "enable-ortb25-fields",
             "strip-all-query-params",
             "strip-fragments",
             "enable-iab-filtering"

From 6c12ed4dc25c4b0e0d36a248eea75507645d75fd Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 21 Jan 2026 18:50:28 +0100
Subject: [PATCH 21/24] test: add unit tests for OpenRTB 2.5 category fields

Changes:
- Add 11 new `buildIabFilterConfig()` tests for OpenRTB 2.5 feature (enabled/disabled scenarios)
- Add 11 new `extractCategoryIds()` tests covering all edge cases
- Add 11 new `injectIabCategories()` tests for category field injection
- Update 5 existing `buildIabFilterConfig()` tests
- Add 6 new `getBidRequestData()` integration tests for V2 API with feature enabled/disabled
- Move legacy API compatibility tests from V2 section to V1 section
---
 test/spec/modules/neuwoRtdProvider_spec.js | 643 ++++++++++++++++++++-
 1 file changed, 635 insertions(+), 8 deletions(-)

diff --git a/test/spec/modules/neuwoRtdProvider_spec.js b/test/spec/modules/neuwoRtdProvider_spec.js
index 7c73d935519..f85beae180f 100644
--- a/test/spec/modules/neuwoRtdProvider_spec.js
+++ b/test/spec/modules/neuwoRtdProvider_spec.js
@@ -495,7 +495,7 @@ describe("neuwoRtdModule", function () {
         ContentTier3: { threshold: 0.7 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
 
       expect(result, "should have single segtax key").to.have.all.keys("6");
       expect(result["6"], "should have all three tier keys").to.have.all.keys("1", "2", "3");
@@ -527,7 +527,7 @@ describe("neuwoRtdModule", function () {
         AudienceTier4: { threshold: 0.8 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
 
       expect(result, "should have both segtax keys").to.have.all.keys("6", "4");
       expect(result["6"], "content segtax should have two tiers").to.have.all.keys("1", "2");
@@ -558,7 +558,7 @@ describe("neuwoRtdModule", function () {
         UnknownTier: { limit: 10 },
         InvalidTier99: { threshold: 0.5 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildIabFilterConfig(filters, 6, false);
 
       expect(result, "should only have segtax 6").to.have.all.keys("6");
       expect(result["6"], "should only have tier 1").to.have.all.keys("1");
@@ -603,7 +603,7 @@ describe("neuwoRtdModule", function () {
         ContentTier1: {},
         AudienceTier3: {}
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildIabFilterConfig(filters, 6, false);
 
       expect(result["6"]["1"], "should create empty object for content tier").to.deep.equal({});
       expect(result["4"]["3"], "should create empty object for audience tier").to.deep.equal({});
@@ -613,7 +613,7 @@ describe("neuwoRtdModule", function () {
       const filters = {
         ContentTier1: { limit: null, threshold: 0.5 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildIabFilterConfig(filters, 6, false);
 
       expect(result["6"]["1"], "should preserve null limit").to.have.property("limit", null);
       expect(result["6"]["1"], "should preserve threshold").to.have.property("threshold", 0.5);
@@ -623,7 +623,7 @@ describe("neuwoRtdModule", function () {
       const filters = {
         ContentTier1: { limit: undefined, threshold: 0.5 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildIabFilterConfig(filters, 6, false);
 
       expect(result["6"]["1"], "should preserve undefined limit").to.have.property("limit", undefined);
       expect(result["6"]["1"], "should preserve threshold").to.have.property("threshold", 0.5);
@@ -633,7 +633,7 @@ describe("neuwoRtdModule", function () {
       const filters = {
         AudienceTier3: { limit: 5, threshold: null }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildIabFilterConfig(filters, 6, false);
 
       expect(result["4"]["3"], "should preserve limit").to.have.property("limit", 5);
       expect(result["4"]["3"], "should preserve null threshold").to.have.property("threshold", null);
@@ -643,11 +643,261 @@ describe("neuwoRtdModule", function () {
       const filters = {
         AudienceTier3: { limit: 5, threshold: undefined }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildIabFilterConfig(filters, 6, false);
 
       expect(result["4"]["3"], "should preserve limit").to.have.property("limit", 5);
       expect(result["4"]["3"], "should preserve undefined threshold").to.have.property("threshold", undefined);
     });
+
+    // OpenRTB 2.5 Feature Tests
+    describe("with enableOrtb25Fields enabled (default)", function () {
+      it("should add IAB 1.0 filters when ContentTier1 filter is provided", function () {
+        const filters = {
+          ContentTier1: { limit: 3, threshold: 0.5 }
+        };
+        const contentSegtax = 6;
+        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+        expect(result, "should have both segtax 6 and segtax 1").to.have.all.keys("6", "1");
+        expect(result["6"]["1"], "segtax 6 tier 1 should be correct").to.deep.equal({ limit: 3, threshold: 0.5 });
+        expect(result["1"]["1"], "segtax 1 tier 1 should be correct").to.deep.equal({ limit: 3, threshold: 0.5 });
+      });
+
+      it("should add IAB 1.0 filters when ContentTier2 filter is provided", function () {
+        const filters = {
+          ContentTier2: { limit: 5, threshold: 0.6 }
+        };
+        const contentSegtax = 6;
+        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+        expect(result, "should have both segtax 6 and segtax 1").to.have.all.keys("6", "1");
+        expect(result["6"]["2"], "segtax 6 tier 2 should be correct").to.deep.equal({ limit: 5, threshold: 0.6 });
+        expect(result["1"]["2"], "segtax 1 tier 2 should be correct").to.deep.equal({ limit: 5, threshold: 0.6 });
+      });
+
+      it("should add IAB 1.0 filters for both ContentTier1 and ContentTier2", function () {
+        const filters = {
+          ContentTier1: { limit: 3 },
+          ContentTier2: { limit: 5 }
+        };
+        const contentSegtax = 6;
+        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+        expect(result, "should have both segtax 6 and segtax 1").to.have.all.keys("6", "1");
+        expect(result["6"], "segtax 6 should have tiers 1 and 2").to.have.all.keys("1", "2");
+        expect(result["1"], "segtax 1 should have tiers 1 and 2").to.have.all.keys("1", "2");
+        expect(result["1"]["1"]).to.deep.equal({ limit: 3 });
+        expect(result["1"]["2"]).to.deep.equal({ limit: 5 });
+      });
+
+      it("should NOT add ContentTier3 filter to IAB 1.0 (only tiers 1-2 exist)", function () {
+        const filters = {
+          ContentTier1: { limit: 3 },
+          ContentTier2: { limit: 5 },
+          ContentTier3: { threshold: 0.7 }
+        };
+        const contentSegtax = 6;
+        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+        expect(result["6"], "segtax 6 should have all three tiers").to.have.all.keys("1", "2", "3");
+        expect(result["1"], "segtax 1 should only have tiers 1 and 2").to.have.all.keys("1", "2");
+        expect(result["1"], "segtax 1 should NOT have tier 3").to.not.have.property("3");
+      });
+
+      it("should NOT add audience tier filters to IAB 1.0", function () {
+        const filters = {
+          AudienceTier3: { limit: 2 },
+          AudienceTier4: { limit: 4 }
+        };
+        const result = neuwo.buildIabFilterConfig(filters, 6);
+
+        expect(result, "should only have segtax 4 (no segtax 1)").to.have.all.keys("4");
+        expect(result, "should not have segtax 1 for audience filters").to.not.have.property("1");
+      });
+
+      it("should add IAB 1.0 filters alongside audience filters", function () {
+        const filters = {
+          ContentTier1: { limit: 3 },
+          AudienceTier3: { limit: 2 }
+        };
+        const contentSegtax = 6;
+        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+
+        expect(result, "should have segtax 6, 1, and 4").to.have.all.keys("6", "1", "4");
+        expect(result["6"]["1"]).to.deep.equal({ limit: 3 });
+        expect(result["1"]["1"]).to.deep.equal({ limit: 3 });
+        expect(result["4"]["3"]).to.deep.equal({ limit: 2 });
+      });
+
+      it("should not add segtax 1 when no content filters are provided", function () {
+        const filters = {
+          AudienceTier3: { limit: 2 }
+        };
+        const result = neuwo.buildIabFilterConfig(filters, 6);
+
+        expect(result, "should only have segtax 4").to.have.all.keys("4");
+        expect(result, "should not have segtax 1").to.not.have.property("1");
+      });
+
+      it("should not add segtax 1 when filters is empty", function () {
+        const result = neuwo.buildIabFilterConfig({}, 6);
+
+        expect(result, "should return empty object").to.deep.equal({});
+      });
+
+      it("should not add segtax 1 when filters is null", function () {
+        const result = neuwo.buildIabFilterConfig(null, 6);
+
+        expect(result, "should return empty object").to.deep.equal({});
+      });
+
+      it("should work with different content segtax values", function () {
+        const filters = {
+          ContentTier1: { limit: 3 }
+        };
+
+        // Test with segtax 7 (IAB 3.0)
+        const result7 = neuwo.buildIabFilterConfig(filters, 7);
+        expect(result7, "should have segtax 7 and 1").to.have.all.keys("7", "1");
+        expect(result7["7"]["1"]).to.deep.equal({ limit: 3 });
+        expect(result7["1"]["1"]).to.deep.equal({ limit: 3 });
+      });
+    });
+
+    describe("with enableOrtb25Fields disabled", function () {
+      it("should not add IAB 1.0 filters when disabled", function () {
+        const filters = {
+          ContentTier1: { limit: 3, threshold: 0.5 },
+          ContentTier2: { limit: 5 }
+        };
+        const contentSegtax = 6;
+        const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
+
+        expect(result, "should only have segtax 6").to.have.all.keys("6");
+        expect(result, "should not have segtax 1").to.not.have.property("1");
+        expect(result["6"], "segtax 6 should have tiers 1 and 2").to.have.all.keys("1", "2");
+      });
+
+      it("should work correctly with all tier types when disabled", function () {
+        const filters = {
+          ContentTier1: { limit: 3 },
+          ContentTier2: { limit: 5 },
+          ContentTier3: { threshold: 0.7 },
+          AudienceTier3: { limit: 2 }
+        };
+        const contentSegtax = 6;
+        const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
+
+        expect(result, "should have segtax 6 and 4 only").to.have.all.keys("6", "4");
+        expect(result, "should not have segtax 1").to.not.have.property("1");
+      });
+    });
+  });
+
+  describe("extractCategoryIds", function () {
+    it("should extract IDs from single tier", function () {
+      const tierData = {
+        "1": [
+          { id: "IAB12" },
+          { id: "IAB12-3" }
+        ]
+      };
+      const result = neuwo.extractCategoryIds(tierData);
+      expect(result, "should extract all IDs from tier 1").to.deep.equal(["IAB12", "IAB12-3"]);
+    });
+
+    it("should extract IDs from multiple tiers", function () {
+      const tierData = {
+        "1": [
+          { id: "IAB12" },
+          { id: "IAB12-3" }
+        ],
+        "2": [
+          { id: "IAB12-5" }
+        ]
+      };
+      const result = neuwo.extractCategoryIds(tierData);
+      expect(result, "should extract all IDs from all tiers").to.deep.equal(["IAB12", "IAB12-3", "IAB12-5"]);
+    });
+
+    it("should handle empty tier arrays", function () {
+      const tierData = {
+        "1": [],
+        "2": [
+          { id: "IAB12" }
+        ]
+      };
+      const result = neuwo.extractCategoryIds(tierData);
+      expect(result, "should only extract from non-empty tiers").to.deep.equal(["IAB12"]);
+    });
+
+    it("should skip items without id property", function () {
+      const tierData = {
+        "1": [
+          { id: "IAB12" },
+          { name: "No ID" },
+          { id: "IAB12-3" }
+        ]
+      };
+      const result = neuwo.extractCategoryIds(tierData);
+      expect(result, "should skip items without id").to.deep.equal(["IAB12", "IAB12-3"]);
+    });
+
+    it("should return empty array for null tierData", function () {
+      const result = neuwo.extractCategoryIds(null);
+      expect(result, "should return empty array for null").to.deep.equal([]);
+    });
+
+    it("should return empty array for undefined tierData", function () {
+      const result = neuwo.extractCategoryIds(undefined);
+      expect(result, "should return empty array for undefined").to.deep.equal([]);
+    });
+
+    it("should return empty array for empty object", function () {
+      const result = neuwo.extractCategoryIds({});
+      expect(result, "should return empty array for empty object").to.deep.equal([]);
+    });
+
+    it("should handle non-array tier values", function () {
+      const tierData = {
+        "1": { id: "IAB12" }, // Not an array
+        "2": [
+          { id: "IAB13" }
+        ]
+      };
+      const result = neuwo.extractCategoryIds(tierData);
+      expect(result, "should skip non-array values").to.deep.equal(["IAB13"]);
+    });
+
+    it("should handle null items in tier arrays", function () {
+      const tierData = {
+        "1": [
+          { id: "IAB12" },
+          null,
+          { id: "IAB12-3" }
+        ]
+      };
+      const result = neuwo.extractCategoryIds(tierData);
+      expect(result, "should skip null items").to.deep.equal(["IAB12", "IAB12-3"]);
+    });
+
+    it("should handle non-object tierData", function () {
+      expect(neuwo.extractCategoryIds("string"), "should handle string").to.deep.equal([]);
+      expect(neuwo.extractCategoryIds(123), "should handle number").to.deep.equal([]);
+      expect(neuwo.extractCategoryIds([]), "should handle array").to.deep.equal([]);
+    });
+
+    it("should extract from all tier numbers", function () {
+      const tierData = {
+        "1": [{ id: "IAB1" }],
+        "2": [{ id: "IAB2" }],
+        "3": [{ id: "IAB3" }],
+        "4": [{ id: "IAB4" }],
+        "5": [{ id: "IAB5" }]
+      };
+      const result = neuwo.extractCategoryIds(tierData);
+      expect(result, "should extract from all tiers").to.deep.equal(["IAB1", "IAB2", "IAB3", "IAB4", "IAB5"]);
+    });
   });
 
   describe("injectOrtbData", function () {
@@ -821,6 +1071,205 @@ describe("neuwoRtdModule", function () {
       expect(contentData, "should have content data").to.exist;
       expect(contentData.ext.segtax, "should default to segtax 6 (IAB 2.2)").to.equal(6);
     });
+
+    // OpenRTB 2.5 Category Fields Tests
+    describe("OpenRTB 2.5 category fields", function () {
+      describe("with enableOrtb25Fields enabled (default)", function () {
+        it("should inject category fields when IAB 1.0 data exists", function () {
+          const response = {
+            "1": {
+              "1": [{ id: "IAB12" }],
+              "2": [{ id: "IAB12-3" }, { id: "IAB12-5" }]
+            },
+            "6": {
+              "1": [{ id: "52" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          const siteSectioncat = bidsConfig.ortb2Fragments.global?.site?.sectioncat;
+          const sitePagecat = bidsConfig.ortb2Fragments.global?.site?.pagecat;
+          const contentCat = bidsConfig.ortb2Fragments.global?.site?.content?.cat;
+
+          expect(siteCat, "should have site.cat").to.deep.equal(["IAB12", "IAB12-3", "IAB12-5"]);
+          expect(siteSectioncat, "should have site.sectioncat").to.deep.equal(["IAB12", "IAB12-3", "IAB12-5"]);
+          expect(sitePagecat, "should have site.pagecat").to.deep.equal(["IAB12", "IAB12-3", "IAB12-5"]);
+          expect(contentCat, "should have site.content.cat").to.deep.equal(["IAB12", "IAB12-3", "IAB12-5"]);
+        });
+
+        it("should inject category fields with single IAB 1.0 segment", function () {
+          const response = {
+            "1": {
+              "1": [{ id: "IAB12" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          expect(siteCat, "should have single category").to.deep.equal(["IAB12"]);
+        });
+
+        it("should not inject category fields when IAB 1.0 data is missing", function () {
+          const response = {
+            "6": {
+              "1": [{ id: "52" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          const siteSectioncat = bidsConfig.ortb2Fragments.global?.site?.sectioncat;
+
+          expect(siteCat, "should not have site.cat").to.be.undefined;
+          expect(siteSectioncat, "should not have site.sectioncat").to.be.undefined;
+        });
+
+        it("should not inject category fields when IAB 1.0 data is empty", function () {
+          const response = {
+            "1": {},
+            "6": {
+              "1": [{ id: "52" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          expect(siteCat, "should not have site.cat with empty IAB 1.0").to.be.undefined;
+        });
+
+        it("should not inject category fields when IAB 1.0 tiers are empty arrays", function () {
+          const response = {
+            "1": {
+              "1": [],
+              "2": []
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          expect(siteCat, "should not have site.cat with empty tier arrays").to.be.undefined;
+        });
+
+        it("should handle IAB 1.0 data with malformed items", function () {
+          const response = {
+            "1": {
+              "1": [
+                { id: "IAB12" },
+                { name: "No ID" },
+                null,
+                { id: "IAB12-3" }
+              ]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          expect(siteCat, "should skip malformed items").to.deep.equal(["IAB12", "IAB12-3"]);
+        });
+
+        it("should inject both content data and category fields", function () {
+          const response = {
+            "1": {
+              "1": [{ id: "IAB12" }]
+            },
+            "6": {
+              "1": [{ id: "52", name: "Food & Drink" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+
+          expect(contentData, "should have content data").to.exist;
+          expect(contentData.ext.segtax, "should have segtax 6").to.equal(6);
+          expect(siteCat, "should have category fields").to.deep.equal(["IAB12"]);
+        });
+
+        it("should merge category fields with existing data", function () {
+          const response = {
+            "1": {
+              "1": [{ id: "IAB12" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+          // Pre-populate with existing category data
+          bidsConfig.ortb2Fragments.global = {
+            site: {
+              cat: ["EXISTING1"]
+            }
+          };
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2");
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          // mergeDeep should deduplicate and merge arrays
+          expect(siteCat, "should merge with existing data").to.include("IAB12");
+          expect(siteCat, "should preserve existing data").to.include("EXISTING1");
+        });
+      });
+
+      describe("with enableOrtb25Fields disabled", function () {
+        it("should not inject category fields when disabled", function () {
+          const response = {
+            "1": {
+              "1": [{ id: "IAB12" }],
+              "2": [{ id: "IAB12-3" }]
+            },
+            "6": {
+              "1": [{ id: "52" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2", false);
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          const siteSectioncat = bidsConfig.ortb2Fragments.global?.site?.sectioncat;
+          const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+
+          expect(siteCat, "should not have site.cat").to.be.undefined;
+          expect(siteSectioncat, "should not have site.sectioncat").to.be.undefined;
+          expect(contentData, "should still have content data (segtax 6)").to.exist;
+        });
+
+        it("should inject content data but not category fields when disabled", function () {
+          const response = {
+            "1": {
+              "1": [{ id: "IAB12" }]
+            },
+            "6": {
+              "1": [{ id: "52", name: "Food & Drink" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+
+          neuwo.injectIabCategories(response, bidsConfig, "2.2", false);
+
+          const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+
+          expect(contentData, "should have content data").to.exist;
+          expect(contentData.ext.segtax).to.equal(6);
+          expect(siteCat, "should not have category fields").to.be.undefined;
+        });
+      });
+    });
   });
 
   describe("getBidRequestData", function () {
@@ -1057,6 +1506,154 @@ describe("neuwoRtdModule", function () {
         "The bids config object should remain unmodified after a failed API call"
       ).to.deep.equal(bidsConfigCopy);
     });
+
+    // OpenRTB 2.5 Feature Tests
+    describe("OpenRTB 2.5 category fields", function () {
+      describe("with enableOrtb25Fields enabled (default)", function () {
+        it("should include iabVersions=1 parameter in API request", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "should include iabVersions=1").to.include("iabVersions=1");
+          expect(request.url, "should include iabVersions=6").to.include("iabVersions=6");
+          expect(request.url, "should include iabVersions=4").to.include("iabVersions=4");
+        });
+
+        it("should inject category fields when API returns IAB 1.0 data", function () {
+          const apiResponse = {
+            "1": {
+              "1": [{ id: "IAB12" }],
+              "2": [{ id: "IAB12-3" }]
+            },
+            "6": {
+              "1": [{ id: "52" }]
+            },
+            "4": {
+              "3": [{ id: "49" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+          request.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(apiResponse)
+          );
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+
+          expect(siteCat, "should have site.cat").to.deep.equal(["IAB12", "IAB12-3"]);
+          expect(contentData, "should have content data").to.exist;
+        });
+
+        it("should send IAB 1.0 filter configuration in request body", function () {
+          const apiResponse = {
+            "1": {
+              "1": [{ id: "IAB12" }],
+              "2": [{ id: "IAB12-3" }]
+            },
+            "6": {
+              "1": [{ id: "52" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
+          conf.params.iabTaxonomyFilters = {
+            ContentTier1: { limit: 2 }
+          };
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+
+          const request = server.requests[0];
+          const requestBody = JSON.parse(request.requestBody);
+          expect(requestBody, "should have filter for segtax 1").to.have.property("1");
+          expect(requestBody["1"], "should have tier 1 filter").to.deep.equal({ "1": { limit: 2 } });
+          expect(requestBody, "should have filter for segtax 6").to.have.property("6");
+          expect(requestBody["6"], "should have tier 1 filter for segtax 6").to.deep.equal({ "1": { limit: 2 } });
+
+          request.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(apiResponse)
+          );
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          expect(siteCat, "should inject category fields").to.deep.equal(["IAB12", "IAB12-3"]);
+        });
+      });
+
+      describe("with enableOrtb25Fields disabled", function () {
+        it("should not include iabVersions=1 parameter in API request", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
+          conf.params.enableOrtb25Fields = false;
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+
+          expect(request.url, "should not include iabVersions=1").to.not.include("iabVersions=1");
+          expect(request.url, "should still include iabVersions=6").to.include("iabVersions=6");
+        });
+
+        it("should not inject category fields even if API returns IAB 1.0 data", function () {
+          const apiResponse = {
+            "1": {
+              "1": [{ id: "IAB12" }]
+            },
+            "6": {
+              "1": [{ id: "52" }]
+            }
+          };
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
+          conf.params.enableOrtb25Fields = false;
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+          request.respond(
+            200,
+            { "Content-Type": "application/json; encoding=UTF-8" },
+            JSON.stringify(apiResponse)
+          );
+
+          const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+          const contentData = bidsConfig.ortb2Fragments.global?.site?.content?.data?.[0];
+
+          expect(siteCat, "should not have site.cat").to.be.undefined;
+          expect(contentData, "should still have content data").to.exist;
+        });
+
+        it("should not send IAB 1.0 filters in request body", function () {
+          const bidsConfig = bidsConfiglike();
+          const conf = config();
+          conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
+          conf.params.enableOrtb25Fields = false;
+          conf.params.iabTaxonomyFilters = {
+            ContentTier1: { limit: 3 },
+            ContentTier2: { limit: 5 }
+          };
+
+          neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+          const request = server.requests[0];
+          const requestBody = JSON.parse(request.requestBody);
+
+          expect(requestBody, "should not have segtax 1 filters").to.not.have.property("1");
+          expect(requestBody, "should have segtax 6 filters").to.have.property("6");
+        });
+      });
+    });
   });
 
   describe("cleanUrl", function () {
@@ -2428,6 +3025,36 @@ describe("neuwoRtdModule", function () {
       });
     });
 
+    describe("OpenRTB 2.5 category fields (V1 API compatibility)", function () {
+      it("should not include iabVersions parameter with legacy API", function () {
+        const bidsConfig = bidsConfiglike();
+        const conf = configV1();
+        conf.params.enableOrtb25Fields = true;
+
+        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+
+        const request = server.requests[0];
+        expect(request.url, "should not include iabVersions parameter").to.not.include("iabVersions");
+      });
+
+      it("should not inject category fields with legacy API", function () {
+        const bidsConfig = bidsConfiglike();
+        const conf = configV1();
+        conf.params.enableOrtb25Fields = true;
+
+        neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
+        const request = server.requests[0];
+        request.respond(
+          200,
+          { "Content-Type": "application/json; encoding=UTF-8" },
+          JSON.stringify(getNeuwoApiResponseV1())
+        );
+
+        const siteCat = bidsConfig.ortb2Fragments.global?.site?.cat;
+        expect(siteCat, "should not have site.cat with legacy API").to.be.undefined;
+      });
+    });
+
     describe("filterIabTaxonomyTier", function () {
       it("should return original array when no filter is provided", function () {
         const taxonomies = [

From 1d5e0e27c956f0355ca4e21f1ad0928e6fa5d308 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Wed, 21 Jan 2026 18:54:56 +0100
Subject: [PATCH 22/24] docs: add OpenRTB 2.5 category fields support
 documentation to Neuwo RTD Module
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Changes:
- Add OpenRTB 2.5 feature description to module overview
- Add `enableOrtb25Fields` parameter to parameters table
- Add dedicated "OpenRTB 2.5 Category Fields" section with examples
- Update ORTB2 data structure examples to show category fields
- Add filtering section explaining IAB 1.0 filter application
- Update "Accessing Neuwo Data" section with category field extraction example
- Add "Building for Production" section with build command
- Update segtax value in example (7 → 6)
- Update version to 2.1.0
---
 modules/neuwoRtdProvider.md | 100 ++++++++++++++++++++++++++++++------
 1 file changed, 85 insertions(+), 15 deletions(-)

diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index c49cdb69ef7..9ce9af2b98a 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -10,12 +10,20 @@ The Neuwo RTD provider fetches real-time contextual data from the Neuwo API. Whe
 
 This data is then added to the bid request by populating the OpenRTB 2.x objects `ortb2.site.content.data` (for IAB Content Taxonomy) and `ortb2.user.data` (for IAB Audience Taxonomy). This enrichment allows bidders to leverage Neuwo's contextual analysis for more precise targeting and decision-making.
 
+Additionally, when enabled, the module populates OpenRTB 2.5 category fields (`ortb2.site.cat`, `ortb2.site.sectioncat`, `ortb2.site.pagecat`, `ortb2.site.content.cat`) with IAB Content Taxonomy 1.0 segments.
+
 Here is an example scheme of the data injected into the `ortb2` object by our module:
 
 ```javascript
 ortb2: {
   site: {
+    // OpenRTB 2.5 category fields (IAB Content Taxonomy 1.0)
+    cat: ["IAB12", "IAB12-3", "IAB12-5"],
+    sectioncat: ["IAB12", "IAB12-3", "IAB12-5"],
+    pagecat: ["IAB12", "IAB12-3", "IAB12-5"],
     content: {
+      // OpenRTB 2.5 category field (IAB Content Taxonomy 1.0)
+      cat: ["IAB12", "IAB12-3", "IAB12-5"],
       // IAB Content Taxonomy data is injected here
       data: [{
         name: "www.neuwo.ai",
@@ -25,7 +33,7 @@ ortb2: {
           { id: "210" },
         ],
         ext: {
-          segtax: 7,
+          segtax: 6,
         },
       }],
     },
@@ -68,6 +76,7 @@ pbjs.setConfig({
           neuwoApiToken: "<Your Neuwo API Token>",
           iabContentTaxonomyVersion: "2.2",
           enableCache: true, // Default: true. Caches API responses to avoid redundant requests
+          enableOrtb25Fields: true, // Default: true.
         },
       },
     ],
@@ -77,24 +86,61 @@ pbjs.setConfig({
 
 **Parameters**
 
-| Name                                | Type     | Required | Default | Description                                                                                                                                                                                                                                                                                                                |
-| :---------------------------------- | :------- | :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `name`                              | String   | Yes      |         | The name of the module, which is `NeuwoRTDModule`.                                                                                                                                                                                                                                                                         |
-| `params`                            | Object   | Yes      |         | Container for module-specific parameters.                                                                                                                                                                                                                                                                                  |
-| `params.neuwoApiUrl`                | String   | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                                                                                                                                                                                                                                                   |
-| `params.neuwoApiToken`              | String   | Yes      |         | Your unique API token provided by Neuwo.                                                                                                                                                                                                                                                                                   |
-| `params.iabContentTaxonomyVersion`  | String   | No       | `'2.2'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'1.0'`, `'2.2'`, `'3.0'`.                                                                                                                                                                                                                 |
-| `params.enableCache`                | Boolean  | No       | `true`  | If `true`, caches API responses to avoid redundant requests for the same page during the session. Set to `false` to disable caching and make a fresh API call on every bid request.                                                                                                                                        |
-| `params.stripAllQueryParams`        | Boolean  | No       | `false` | If `true`, strips all query parameters from the URL before analysis. Takes precedence over other stripping options.                                                                                                                                                                                                        |
-| `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains. |
-| `params.stripQueryParams`           | String[] | No       | `[]`    | List of specific query parameter names to strip from the URL (e.g., `['utm_source', 'fbclid']`). Other parameters are preserved. Only applies when the domain does not match `stripQueryParamsForDomains`.                                                                                                                 |
-| `params.stripFragments`             | Boolean  | No       | `false` | If `true`, strips URL fragments (hash, e.g., `#section`) from the URL before analysis.                                                                                                                                                                                                                                     |
-| `params.iabTaxonomyFilters`         | Object   | No       |         | Per-tier filtering configuration for IAB taxonomies. Allows filtering by relevance threshold and limiting the count of categories per tier. See [IAB Taxonomy Filtering](#iab-taxonomy-filtering) section below for details.                                                                                               |
+| Name                                | Type     | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                |
+| :---------------------------------- | :------- | :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`                              | String   | Yes      |         | The name of the module, which is `NeuwoRTDModule`.                                                                                                                                                                                                                                                                                                                         |
+| `params`                            | Object   | Yes      |         | Container for module-specific parameters.                                                                                                                                                                                                                                                                                                                                  |
+| `params.neuwoApiUrl`                | String   | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                                                                                                                                                                                                                                                                                                   |
+| `params.neuwoApiToken`              | String   | Yes      |         | Your unique API token provided by Neuwo.                                                                                                                                                                                                                                                                                                                                   |
+| `params.iabContentTaxonomyVersion`  | String   | No       | `'2.2'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'1.0'`, `'2.2'`, `'3.0'`.                                                                                                                                                                                                                                                                 |
+| `params.enableCache`                | Boolean  | No       | `true`  | If `true`, caches API responses to avoid redundant requests for the same page during the session. Set to `false` to disable caching and make a fresh API call on every bid request.                                                                                                                                                                                        |
+| `params.enableOrtb25Fields`         | Boolean  | No       | `true`  | If `true`, populates OpenRTB 2.5 category fields (`ortb2.site.cat`, `ortb2.site.sectioncat`, `ortb2.site.pagecat`, `ortb2.site.content.cat`) with IAB Content Taxonomy 1.0 segments. See [OpenRTB 2.5 Category Fields](#openrtb-25-category-fields) section below for details.                                                                                             |
+| `params.stripAllQueryParams`        | Boolean  | No       | `false` | If `true`, strips all query parameters from the URL before analysis. Takes precedence over other stripping options.                                                                                                                                                                                                                                                        |
+| `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains.                                                 |
+| `params.stripQueryParams`           | String[] | No       | `[]`    | List of specific query parameter names to strip from the URL (e.g., `['utm_source', 'fbclid']`). Other parameters are preserved. Only applies when the domain does not match `stripQueryParamsForDomains`.                                                                                                                                                                 |
+| `params.stripFragments`             | Boolean  | No       | `false` | If `true`, strips URL fragments (hash, e.g., `#section`) from the URL before analysis.                                                                                                                                                                                                                                                                                     |
+| `params.iabTaxonomyFilters`         | Object   | No       |         | Per-tier filtering configuration for IAB taxonomies. Allows filtering by relevance threshold and limiting the count of categories per tier. Filters configured for `ContentTier1` and `ContentTier2` are automatically applied to IAB Content Taxonomy 1.0 when `enableOrtb25Fields` is `true`. See [IAB Taxonomy Filtering](#iab-taxonomy-filtering) section for details. |
 
 ### API Response Caching
 
 By default, the module caches API responses during the page session to optimise performance and reduce redundant API calls. This behaviour can be disabled by setting `enableCache: false` if needed for dynamic content scenarios.
 
+### OpenRTB 2.5 Category Fields
+
+The module supports populating OpenRTB 2.5 category fields with IAB Content Taxonomy 1.0 segments. This feature is enabled by default and provides additional contextual signals to bidders through standard OpenRTB fields.
+
+**Category Fields Populated:**
+
+- `ortb2.site.cat` - Array of IAB Content Taxonomy 1.0 category IDs
+- `ortb2.site.sectioncat` - Array of IAB Content Taxonomy 1.0 category IDs
+- `ortb2.site.pagecat` - Array of IAB Content Taxonomy 1.0 category IDs
+- `ortb2.site.content.cat` - Array of IAB Content Taxonomy 1.0 category IDs
+
+**Result Example:**
+
+With `enableOrtb25Fields: true`, the module injects:
+
+```javascript
+ortb2: {
+  site: {
+    // OpenRTB 2.5 category fields
+    cat: ["IAB12", "IAB12-3", "IAB12-5"],
+    sectioncat: ["IAB12", "IAB12-3", "IAB12-5"],
+    pagecat: ["IAB12", "IAB12-3", "IAB12-5"],
+    content: {
+      // OpenRTB 2.5 category field
+      cat: ["IAB12", "IAB12-3", "IAB12-5"],
+      // Standard content data
+      data: [{
+        name: "www.neuwo.ai",
+        segment: [{ id: "274" }, { id: "42" }],
+        ext: { segtax: 6 }
+      }]
+    }
+  }
+}
+```
+
 ### URL Cleaning Options
 
 The module provides optional URL cleaning capabilities to strip query parameters and/or fragments from the analysed URL before sending it to the Neuwo API. This can be useful for privacy, caching, or analytics purposes.
@@ -196,6 +242,10 @@ pbjs.setConfig({
 });
 ```
 
+**OpenRTB 2.5 Category Fields Filtering**
+
+When `iabTaxonomyFilters` are configured, the same filters applied to `ContentTier1` and `ContentTier2` are automatically applied to IAB Content Taxonomy 1.0 data used for these fields. Note that IAB Content Taxonomy 1.0 only has tiers 1 and 2, so `ContentTier3` filters are ignored for these fields.
+
 ## Accessing Neuwo Data Outside Prebid.js
 
 The Neuwo RTD module enriches bid requests with contextual data that can be accessed in application code for analytics, targeting, integration with Google Ad Manager as [Publisher Provided Signals (PPS)](https://support.google.com/admanager/answer/15287325) or other purposes. The enriched data is available through Prebid.js events.
@@ -218,14 +268,24 @@ pbjs.que.push(function () {
       (d) => d.name === "www.neuwo.ai"
     );
 
+    // Extract OpenRTB 2.5 category fields (if enableOrtb25Fields is true)
+    const categoryFields = {
+      siteCat: ortb2?.site?.cat,
+      siteSectioncat: ortb2?.site?.sectioncat,
+      sitePagecat: ortb2?.site?.pagecat,
+      contentCat: ortb2?.site?.content?.cat,
+    };
+
     // Use the data in the application
     console.log("Neuwo Site Content:", neuwoSiteData);
     console.log("Neuwo User Data:", neuwoUserData);
+    console.log("OpenRTB 2.5 Category Fields:", categoryFields);
 
     // Example: Store in a global variable for later use
     window.neuwoData = {
       siteContent: neuwoSiteData,
       user: neuwoUserData,
+      categoryFields: categoryFields,
     };
   });
 });
@@ -318,4 +378,14 @@ google-chrome build/coverage/lcov-report/index.html
 
 Navigate to `modules/neuwoRtdProvider.js` in the report to see detailed line-by-line coverage with highlighted covered/uncovered lines.
 
-> Version **2.0.0**
+## Building for Production
+
+To generate minified code for production use:
+
+```bash
+npx gulp build --modules=rtdModule,neuwoRtdProvider
+```
+
+This command creates optimised, minified code typically used on websites.
+
+> Version **2.1.0**

From 79f1a3b004eb1ee909f41df599cf7ac2ced88c15 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Fri, 23 Jan 2026 14:29:58 +0100
Subject: [PATCH 23/24] perf: change Content-Type to text/plain to avoid CORS
 preflight

---
 modules/neuwoRtdProvider.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index d7a593e1790..f69680d7e68 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -298,7 +298,7 @@ export function getBidRequestData(
         },
         isV2Api ? JSON.stringify(iabFilterConfig) : null,
         isV2Api
-          ? { method: "POST", contentType: "application/json" }
+          ? { method: "POST", contentType: "text/plain" }
           : undefined
       );
     });

From d752bf89a5ba6b53379c2b9469021703f1576415 Mon Sep 17 00:00:00 2001
From: grzgm <125459798+grzgm@users.noreply.github.com>
Date: Tue, 27 Jan 2026 13:50:40 +0100
Subject: [PATCH 24/24] refactor: change /v1/iab endpoint from POST to GET with
 flattened query params
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace POST request with GET and send IAB taxonomy filters as flattened URL query parameters instead of JSON body to avoid CORS preflight requests.

Changes:
- Replace `buildIabFilterConfig()` with `buildFilterQueryParams()` function
- Change output from nested object to array of query parameter strings (e.g., `["filter_6_1_limit=3"]`)
- Remove POST method and request body from ajax call
- Add filter parameters directly to URL for /v1/iab endpoint
- Maintain OpenRTB 2.5 filter application (ContentTier1/2 → segtax 1)
- Update all unit tests to test `buildFilterQueryParams()` instead of `buildIabFilterConfig()`
- Update tests expecting POST requests to expect GET requests
- Update tests checking request body to check URL parameters
- Update version to 2.2.0
---
 modules/neuwoRtdProvider.js                |  97 +++---
 modules/neuwoRtdProvider.md                |   2 +-
 test/spec/modules/neuwoRtdProvider_spec.js | 339 +++++++++++----------
 3 files changed, 228 insertions(+), 210 deletions(-)

diff --git a/modules/neuwoRtdProvider.js b/modules/neuwoRtdProvider.js
index f69680d7e68..e6e616904c5 100644
--- a/modules/neuwoRtdProvider.js
+++ b/modules/neuwoRtdProvider.js
@@ -1,6 +1,6 @@
 /**
  * @module neuwoRtdProvider
- * @version 2.1.0
+ * @version 2.2.0
  * @author Grzegorz Malisz
  * @see {project-root-directory}/integrationExamples/gpt/neuwoRtdProvider_example.html for an example/testing page.
  * @see {project-root-directory}/test/spec/modules/neuwoRtdProvider_spec.js for unit tests.
@@ -157,13 +157,6 @@ export function getBidRequestData(
     );
   }
 
-  // Build IAB filter configuration
-  const iabFilterConfig = buildIabFilterConfig(
-    iabTaxonomyFilters,
-    contentSegtax,
-    enableOrtb25Fields
-  );
-
   const joiner = neuwoApiUrl.indexOf("?") < 0 ? "?" : "&";
   const urlParams = [
     "token=" + neuwoApiToken,
@@ -180,6 +173,16 @@ export function getBidRequestData(
     if (enableOrtb25Fields) {
       urlParams.push("iabVersions=1"); // IAB Content 1.0
     }
+
+    // Add flattened filter parameters to URL for GET request
+    const filterParams = buildFilterQueryParams(
+      iabTaxonomyFilters,
+      contentSegtax,
+      enableOrtb25Fields
+    );
+    if (filterParams.length > 0) {
+      urlParams.push(...filterParams);
+    }
   }
 
   const neuwoApiUrlFull = neuwoApiUrl + joiner + urlParams.join("&");
@@ -229,8 +232,7 @@ export function getBidRequestData(
       "getBidRequestData():",
       "Cache System:",
       "Calling Neuwo API Endpoint:",
-      neuwoApiUrlFull,
-      ...(isV2Api ? ["Body:", iabFilterConfig] : [])
+      neuwoApiUrlFull
     );
 
     const requestPromise = new Promise((resolve) => {
@@ -295,11 +297,7 @@ export function getBidRequestData(
             );
             resolve(null);
           },
-        },
-        isV2Api ? JSON.stringify(iabFilterConfig) : null,
-        isV2Api
-          ? { method: "POST", contentType: "text/plain" }
-          : undefined
+        }
       );
     });
 
@@ -665,22 +663,29 @@ export function transformSegmentsV1ToV2(segments) {
 }
 
 /**
- * Builds IAB filter configuration from publisher settings.
- * Converts human-readable tier names to segtax-based structure for API communication.
- *
- * Input format:  { ContentTier1: { limit: 3, threshold: 0.5 }, AudienceTier3: { limit: 5 } }
- * Output format: { "6": { "1": { limit: 3, threshold: 0.5 } }, "4": { "3": { limit: 5 } } }
+ * Builds flattened query parameters from IAB taxonomy filters.
+ * Converts human-readable tier names directly to query parameter format for GET requests.
  *
  * @param {Object} iabTaxonomyFilters Publisher's tier filter configuration using human-readable tier names.
  * @param {number} contentSegtax The segtax ID for content taxonomies (determined by iabContentTaxonomyVersion).
- * @param {boolean} [enableOrtb25Fields=true] If true, also applies filters to IAB COntent Taxonomy 1.0 (segtax 1) for OpenRTB 2.5 category fields.
- * @returns {Object} Filter configuration in segtax-based structure.
+ * @param {boolean} [enableOrtb25Fields=true] If true, also applies filters to IAB Content Taxonomy 1.0 (segtax 1) for OpenRTB 2.5 category fields.
+ * @returns {Array<string>} Array of query parameter strings (e.g., ["filter_6_1_limit=3", "filter_6_1_threshold=0.5"]).
+ *
+ * @example
+ * Input:  { ContentTier1: { limit: 3, threshold: 0.5 }, AudienceTier3: { limit: 2 } }, contentSegtax=6
+ * Output: ["filter_6_1_limit=3", "filter_6_1_threshold=0.5", "filter_4_3_limit=2"]
  */
-export function buildIabFilterConfig(
+export function buildFilterQueryParams(
   iabTaxonomyFilters,
   contentSegtax,
   enableOrtb25Fields = true
 ) {
+  const params = [];
+
+  if (!iabTaxonomyFilters || typeof iabTaxonomyFilters !== "object") {
+    return params;
+  }
+
   const TIER_TO_SEGTAX = {
     ContentTier1: { segtax: contentSegtax, tier: "1" },
     ContentTier2: { segtax: contentSegtax, tier: "2" },
@@ -690,38 +695,46 @@ export function buildIabFilterConfig(
     AudienceTier5: { segtax: 4, tier: "5" },
   };
 
-  const body = {};
-  Object.entries(iabTaxonomyFilters || {}).forEach(([tierName, filter]) => {
+  // Build query params from tier mappings
+  Object.entries(iabTaxonomyFilters).forEach(([tierName, filter]) => {
     const mapping = TIER_TO_SEGTAX[tierName];
-    if (mapping) {
-      const segtaxKey = String(mapping.segtax);
-      if (!body[segtaxKey]) body[segtaxKey] = {};
-      body[segtaxKey][mapping.tier] = filter;
+    if (mapping && filter && typeof filter === "object") {
+      const segtax = mapping.segtax;
+      const tier = mapping.tier;
+
+      // Add each filter property (limit, threshold) as a query parameter
+      Object.keys(filter).forEach((prop) => {
+        const value = filter[prop];
+        if (value !== undefined && value !== null) {
+          params.push(`filter_${segtax}_${tier}_${prop}=${value}`);
+        }
+      });
     }
   });
 
   // Apply same filters to IAB 1.0 (segtax 1) for OpenRTB 2.5 fields
   // Note: IAB 1.0 only has tiers 1 and 2 (tier 3 will be ignored if configured)
-  if (enableOrtb25Fields && iabTaxonomyFilters) {
-    const segtax1Config = {};
-
-    // Apply ContentTier1 filters to segtax 1, tier 1
+  if (enableOrtb25Fields) {
     if (iabTaxonomyFilters.ContentTier1) {
-      segtax1Config["1"] = iabTaxonomyFilters.ContentTier1;
+      Object.keys(iabTaxonomyFilters.ContentTier1).forEach((prop) => {
+        const value = iabTaxonomyFilters.ContentTier1[prop];
+        if (value !== undefined && value !== null) {
+          params.push(`filter_1_1_${prop}=${value}`);
+        }
+      });
     }
 
-    // Apply ContentTier2 filters to segtax 1, tier 2
     if (iabTaxonomyFilters.ContentTier2) {
-      segtax1Config["2"] = iabTaxonomyFilters.ContentTier2;
-    }
-
-    // Only add segtax 1 config if there are filters
-    if (Object.keys(segtax1Config).length > 0) {
-      body["1"] = segtax1Config;
+      Object.keys(iabTaxonomyFilters.ContentTier2).forEach((prop) => {
+        const value = iabTaxonomyFilters.ContentTier2[prop];
+        if (value !== undefined && value !== null) {
+          params.push(`filter_1_2_${prop}=${value}`);
+        }
+      });
     }
   }
 
-  return body;
+  return params;
 }
 
 /**
diff --git a/modules/neuwoRtdProvider.md b/modules/neuwoRtdProvider.md
index 9ce9af2b98a..fbf995f8241 100644
--- a/modules/neuwoRtdProvider.md
+++ b/modules/neuwoRtdProvider.md
@@ -388,4 +388,4 @@ npx gulp build --modules=rtdModule,neuwoRtdProvider
 
 This command creates optimised, minified code typically used on websites.
 
-> Version **2.1.0**
+> Version **2.2.0**
diff --git a/test/spec/modules/neuwoRtdProvider_spec.js b/test/spec/modules/neuwoRtdProvider_spec.js
index f85beae180f..d74dbd387b7 100644
--- a/test/spec/modules/neuwoRtdProvider_spec.js
+++ b/test/spec/modules/neuwoRtdProvider_spec.js
@@ -392,20 +392,20 @@ describe("neuwoRtdModule", function () {
     });
   });
 
-  describe("buildIabFilterConfig", function () {
-    it("should return empty object when no filters provided", function () {
-      const result = neuwo.buildIabFilterConfig(null, 6);
-      expect(result, "should return empty object for null filters").to.deep.equal({});
+  describe("buildFilterQueryParams", function () {
+    it("should return empty array when no filters provided", function () {
+      const result = neuwo.buildFilterQueryParams(null, 6);
+      expect(result, "should return empty array for null filters").to.deep.equal([]);
     });
 
-    it("should return empty object when filters parameter is undefined", function () {
-      const result = neuwo.buildIabFilterConfig(undefined, 6);
-      expect(result, "should return empty object for undefined filters").to.deep.equal({});
+    it("should return empty array when filters parameter is undefined", function () {
+      const result = neuwo.buildFilterQueryParams(undefined, 6);
+      expect(result, "should return empty array for undefined filters").to.deep.equal([]);
     });
 
-    it("should return empty object when filters is empty object", function () {
-      const result = neuwo.buildIabFilterConfig({}, 6);
-      expect(result, "should return empty object for empty filters").to.deep.equal({});
+    it("should return empty array when filters is empty object", function () {
+      const result = neuwo.buildFilterQueryParams({}, 6);
+      expect(result, "should return empty array for empty filters").to.deep.equal([]);
     });
 
     it("should convert ContentTier1 filter correctly", function () {
@@ -413,14 +413,11 @@ describe("neuwoRtdModule", function () {
         ContentTier1: { limit: 3, threshold: 0.5 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should have segtax key").to.have.property("6");
-      expect(result["6"], "should have tier key").to.have.property("1");
-      expect(result["6"]["1"], "should preserve filter properties").to.deep.equal({
-        limit: 3,
-        threshold: 0.5
-      });
+      expect(result).to.include("filter_6_1_limit=3");
+      expect(result).to.include("filter_6_1_threshold=0.5");
+      expect(result).to.have.lengthOf(2);
     });
 
     it("should convert ContentTier2 filter correctly", function () {
@@ -428,12 +425,11 @@ describe("neuwoRtdModule", function () {
         ContentTier2: { limit: 5, threshold: 0.6 }
       };
       const contentSegtax = 7;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should have segtax key").to.have.property("7");
-      expect(result["7"], "should have tier key").to.have.property("2");
-      expect(result["7"]["2"], "should have limit property").to.have.property("limit", 5);
-      expect(result["7"]["2"], "should have threshold property").to.have.property("threshold", 0.6);
+      expect(result).to.include("filter_7_2_limit=5");
+      expect(result).to.include("filter_7_2_threshold=0.6");
+      expect(result).to.have.lengthOf(2);
     });
 
     it("should convert ContentTier3 filter correctly", function () {
@@ -441,12 +437,11 @@ describe("neuwoRtdModule", function () {
         ContentTier3: { limit: 4, threshold: 0.8 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should have segtax key").to.have.property("6");
-      expect(result["6"], "should have tier key").to.have.property("3");
-      expect(result["6"]["3"], "should have limit property").to.have.property("limit", 4);
-      expect(result["6"]["3"], "should have threshold property").to.have.property("threshold", 0.8);
+      expect(result).to.include("filter_6_3_limit=4");
+      expect(result).to.include("filter_6_3_threshold=0.8");
+      expect(result).to.have.lengthOf(2);
     });
 
     it("should convert AudienceTier3 filter correctly", function () {
@@ -454,12 +449,11 @@ describe("neuwoRtdModule", function () {
         AudienceTier3: { limit: 2, threshold: 0.9 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should use segtax 4 for audience").to.have.property("4");
-      expect(result["4"], "should have tier key").to.have.property("3");
-      expect(result["4"]["3"], "should have limit property").to.have.property("limit", 2);
-      expect(result["4"]["3"], "should have threshold property").to.have.property("threshold", 0.9);
+      expect(result).to.include("filter_4_3_limit=2");
+      expect(result).to.include("filter_4_3_threshold=0.9");
+      expect(result).to.have.lengthOf(2);
     });
 
     it("should convert AudienceTier4 filter correctly", function () {
@@ -467,12 +461,11 @@ describe("neuwoRtdModule", function () {
         AudienceTier4: { limit: 10, threshold: 0.85 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should use segtax 4 for audience").to.have.property("4");
-      expect(result["4"], "should have tier key").to.have.property("4");
-      expect(result["4"]["4"], "should have limit property").to.have.property("limit", 10);
-      expect(result["4"]["4"], "should have threshold property").to.have.property("threshold", 0.85);
+      expect(result).to.include("filter_4_4_limit=10");
+      expect(result).to.include("filter_4_4_threshold=0.85");
+      expect(result).to.have.lengthOf(2);
     });
 
     it("should convert AudienceTier5 filter correctly", function () {
@@ -480,12 +473,11 @@ describe("neuwoRtdModule", function () {
         AudienceTier5: { limit: 7, threshold: 0.95 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should use segtax 4 for audience").to.have.property("4");
-      expect(result["4"], "should have tier key").to.have.property("5");
-      expect(result["4"]["5"], "should have limit property").to.have.property("limit", 7);
-      expect(result["4"]["5"], "should have threshold property").to.have.property("threshold", 0.95);
+      expect(result).to.include("filter_4_5_limit=7");
+      expect(result).to.include("filter_4_5_threshold=0.95");
+      expect(result).to.have.lengthOf(2);
     });
 
     it("should handle multiple content tiers with same segtax", function () {
@@ -495,13 +487,12 @@ describe("neuwoRtdModule", function () {
         ContentTier3: { threshold: 0.7 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should have single segtax key").to.have.all.keys("6");
-      expect(result["6"], "should have all three tier keys").to.have.all.keys("1", "2", "3");
-      expect(result["6"]["1"], "tier 1 should be correct").to.deep.equal({ limit: 3 });
-      expect(result["6"]["2"], "tier 2 should be correct").to.deep.equal({ limit: 5 });
-      expect(result["6"]["3"], "tier 3 should be correct").to.deep.equal({ threshold: 0.7 });
+      expect(result).to.include("filter_6_1_limit=3");
+      expect(result).to.include("filter_6_2_limit=5");
+      expect(result).to.include("filter_6_3_threshold=0.7");
+      expect(result).to.have.lengthOf(3);
     });
 
     it("should handle multiple audience tiers", function () {
@@ -510,13 +501,12 @@ describe("neuwoRtdModule", function () {
         AudienceTier4: { limit: 4 },
         AudienceTier5: { threshold: 0.85 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result, "should have segtax 4 key").to.have.all.keys("4");
-      expect(result["4"], "should have all three tier keys").to.have.all.keys("3", "4", "5");
-      expect(result["4"]["3"], "tier 3 should be correct").to.deep.equal({ limit: 2 });
-      expect(result["4"]["4"], "tier 4 should be correct").to.deep.equal({ limit: 4 });
-      expect(result["4"]["5"], "tier 5 should be correct").to.deep.equal({ threshold: 0.85 });
+      expect(result).to.include("filter_4_3_limit=2");
+      expect(result).to.include("filter_4_4_limit=4");
+      expect(result).to.include("filter_4_5_threshold=0.85");
+      expect(result).to.have.lengthOf(3);
     });
 
     it("should handle both content and audience tiers together", function () {
@@ -527,13 +517,15 @@ describe("neuwoRtdModule", function () {
         AudienceTier4: { threshold: 0.8 }
       };
       const contentSegtax = 6;
-      const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
+      const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-      expect(result, "should have both segtax keys").to.have.all.keys("6", "4");
-      expect(result["6"], "content segtax should have two tiers").to.have.all.keys("1", "2");
-      expect(result["4"], "audience segtax should have two tiers").to.have.all.keys("3", "4");
-      expect(result["6"]["1"]).to.deep.equal({ limit: 3, threshold: 0.5 });
-      expect(result["4"]["3"]).to.deep.equal({ limit: 2, threshold: 0.9 });
+      expect(result).to.include("filter_6_1_limit=3");
+      expect(result).to.include("filter_6_1_threshold=0.5");
+      expect(result).to.include("filter_6_2_limit=5");
+      expect(result).to.include("filter_4_3_limit=2");
+      expect(result).to.include("filter_4_3_threshold=0.9");
+      expect(result).to.include("filter_4_4_threshold=0.8");
+      expect(result).to.have.lengthOf(6);
     });
 
     it("should use different content segtax values correctly", function () {
@@ -542,14 +534,14 @@ describe("neuwoRtdModule", function () {
       };
 
       // Test with segtax 6 (IAB 2.2)
-      const result6 = neuwo.buildIabFilterConfig(filters, 6);
-      expect(result6, "should use segtax 6").to.have.property("6");
-      expect(result6, "should not have segtax 7").to.not.have.property("7");
+      const result6 = neuwo.buildFilterQueryParams(filters, 6, false);
+      expect(result6).to.include("filter_6_1_limit=3");
+      expect(result6).to.not.include("filter_7_1_limit=3");
 
       // Test with segtax 7 (IAB 3.0)
-      const result7 = neuwo.buildIabFilterConfig(filters, 7);
-      expect(result7, "should use segtax 7").to.have.property("7");
-      expect(result7, "should not have segtax 6").to.not.have.property("6");
+      const result7 = neuwo.buildFilterQueryParams(filters, 7, false);
+      expect(result7).to.include("filter_7_1_limit=3");
+      expect(result7).to.not.include("filter_6_1_limit=3");
     });
 
     it("should ignore unknown tier names", function () {
@@ -558,44 +550,44 @@ describe("neuwoRtdModule", function () {
         UnknownTier: { limit: 10 },
         InvalidTier99: { threshold: 0.5 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6, false);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result, "should only have segtax 6").to.have.all.keys("6");
-      expect(result["6"], "should only have tier 1").to.have.all.keys("1");
-      expect(result["6"]["1"]).to.deep.equal({ limit: 3 });
+      expect(result).to.include("filter_6_1_limit=3");
+      expect(result).to.have.lengthOf(1);
     });
 
     it("should handle filters with only limit property", function () {
       const filters = {
         ContentTier1: { limit: 5 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["6"]["1"], "should only have limit property").to.deep.equal({ limit: 5 });
-      expect(result["6"]["1"], "should not have threshold").to.not.have.property("threshold");
+      expect(result).to.include("filter_6_1_limit=5");
+      expect(result).to.not.include.match(/filter_6_1_threshold/);
+      expect(result).to.have.lengthOf(1);
     });
 
     it("should handle filters with only threshold property", function () {
       const filters = {
         AudienceTier3: { threshold: 0.75 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["4"]["3"], "should only have threshold property").to.deep.equal({ threshold: 0.75 });
-      expect(result["4"]["3"], "should not have limit").to.not.have.property("limit");
+      expect(result).to.include("filter_4_3_threshold=0.75");
+      expect(result).to.not.include.match(/filter_4_3_limit/);
+      expect(result).to.have.lengthOf(1);
     });
 
     it("should handle filters with additional custom properties", function () {
       const filters = {
         ContentTier1: { limit: 3, threshold: 0.5, customProp: "value" }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["6"]["1"], "should preserve all properties").to.deep.equal({
-        limit: 3,
-        threshold: 0.5,
-        customProp: "value"
-      });
+      expect(result).to.include("filter_6_1_limit=3");
+      expect(result).to.include("filter_6_1_threshold=0.5");
+      expect(result).to.include("filter_6_1_customProp=value");
+      expect(result).to.have.lengthOf(3);
     });
 
     it("should handle empty filter objects for tiers", function () {
@@ -603,91 +595,94 @@ describe("neuwoRtdModule", function () {
         ContentTier1: {},
         AudienceTier3: {}
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6, false);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["6"]["1"], "should create empty object for content tier").to.deep.equal({});
-      expect(result["4"]["3"], "should create empty object for audience tier").to.deep.equal({});
+      expect(result).to.have.lengthOf(0);
     });
 
-    it("should handle null limit value", function () {
+    it("should not include null limit value", function () {
       const filters = {
         ContentTier1: { limit: null, threshold: 0.5 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6, false);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["6"]["1"], "should preserve null limit").to.have.property("limit", null);
-      expect(result["6"]["1"], "should preserve threshold").to.have.property("threshold", 0.5);
+      expect(result).to.include("filter_6_1_threshold=0.5");
+      expect(result).to.have.lengthOf(1);
     });
 
-    it("should handle undefined limit value", function () {
+    it("should not include undefined limit value", function () {
       const filters = {
         ContentTier1: { limit: undefined, threshold: 0.5 }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6, false);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["6"]["1"], "should preserve undefined limit").to.have.property("limit", undefined);
-      expect(result["6"]["1"], "should preserve threshold").to.have.property("threshold", 0.5);
+      expect(result).to.include("filter_6_1_threshold=0.5");
+      expect(result).to.have.lengthOf(1);
     });
 
-    it("should handle null threshold value", function () {
+    it("should not include null threshold value", function () {
       const filters = {
         AudienceTier3: { limit: 5, threshold: null }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6, false);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["4"]["3"], "should preserve limit").to.have.property("limit", 5);
-      expect(result["4"]["3"], "should preserve null threshold").to.have.property("threshold", null);
+      expect(result).to.include("filter_4_3_limit=5");
+      expect(result).to.have.lengthOf(1);
     });
 
-    it("should handle undefined threshold value", function () {
+    it("should not include undefined threshold value", function () {
       const filters = {
         AudienceTier3: { limit: 5, threshold: undefined }
       };
-      const result = neuwo.buildIabFilterConfig(filters, 6, false);
+      const result = neuwo.buildFilterQueryParams(filters, 6, false);
 
-      expect(result["4"]["3"], "should preserve limit").to.have.property("limit", 5);
-      expect(result["4"]["3"], "should preserve undefined threshold").to.have.property("threshold", undefined);
+      expect(result).to.include("filter_4_3_limit=5");
+      expect(result).to.have.lengthOf(1);
     });
 
     // OpenRTB 2.5 Feature Tests
     describe("with enableOrtb25Fields enabled (default)", function () {
-      it("should add IAB 1.0 filters when ContentTier1 filter is provided", function () {
+      it("should add IAB 1.0 filter params when ContentTier1 filter is provided", function () {
         const filters = {
           ContentTier1: { limit: 3, threshold: 0.5 }
         };
         const contentSegtax = 6;
-        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+        const result = neuwo.buildFilterQueryParams(filters, contentSegtax);
 
-        expect(result, "should have both segtax 6 and segtax 1").to.have.all.keys("6", "1");
-        expect(result["6"]["1"], "segtax 6 tier 1 should be correct").to.deep.equal({ limit: 3, threshold: 0.5 });
-        expect(result["1"]["1"], "segtax 1 tier 1 should be correct").to.deep.equal({ limit: 3, threshold: 0.5 });
+        expect(result).to.include("filter_6_1_limit=3");
+        expect(result).to.include("filter_6_1_threshold=0.5");
+        expect(result).to.include("filter_1_1_limit=3");
+        expect(result).to.include("filter_1_1_threshold=0.5");
+        expect(result).to.have.lengthOf(4);
       });
 
-      it("should add IAB 1.0 filters when ContentTier2 filter is provided", function () {
+      it("should add IAB 1.0 filter params when ContentTier2 filter is provided", function () {
         const filters = {
           ContentTier2: { limit: 5, threshold: 0.6 }
         };
         const contentSegtax = 6;
-        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+        const result = neuwo.buildFilterQueryParams(filters, contentSegtax);
 
-        expect(result, "should have both segtax 6 and segtax 1").to.have.all.keys("6", "1");
-        expect(result["6"]["2"], "segtax 6 tier 2 should be correct").to.deep.equal({ limit: 5, threshold: 0.6 });
-        expect(result["1"]["2"], "segtax 1 tier 2 should be correct").to.deep.equal({ limit: 5, threshold: 0.6 });
+        expect(result).to.include("filter_6_2_limit=5");
+        expect(result).to.include("filter_6_2_threshold=0.6");
+        expect(result).to.include("filter_1_2_limit=5");
+        expect(result).to.include("filter_1_2_threshold=0.6");
+        expect(result).to.have.lengthOf(4);
       });
 
-      it("should add IAB 1.0 filters for both ContentTier1 and ContentTier2", function () {
+      it("should add IAB 1.0 filter params for both ContentTier1 and ContentTier2", function () {
         const filters = {
           ContentTier1: { limit: 3 },
           ContentTier2: { limit: 5 }
         };
         const contentSegtax = 6;
-        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+        const result = neuwo.buildFilterQueryParams(filters, contentSegtax);
 
-        expect(result, "should have both segtax 6 and segtax 1").to.have.all.keys("6", "1");
-        expect(result["6"], "segtax 6 should have tiers 1 and 2").to.have.all.keys("1", "2");
-        expect(result["1"], "segtax 1 should have tiers 1 and 2").to.have.all.keys("1", "2");
-        expect(result["1"]["1"]).to.deep.equal({ limit: 3 });
-        expect(result["1"]["2"]).to.deep.equal({ limit: 5 });
+        expect(result).to.include("filter_6_1_limit=3");
+        expect(result).to.include("filter_6_2_limit=5");
+        expect(result).to.include("filter_1_1_limit=3");
+        expect(result).to.include("filter_1_2_limit=5");
+        expect(result).to.have.lengthOf(4);
       });
 
       it("should NOT add ContentTier3 filter to IAB 1.0 (only tiers 1-2 exist)", function () {
@@ -697,11 +692,15 @@ describe("neuwoRtdModule", function () {
           ContentTier3: { threshold: 0.7 }
         };
         const contentSegtax = 6;
-        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+        const result = neuwo.buildFilterQueryParams(filters, contentSegtax);
 
-        expect(result["6"], "segtax 6 should have all three tiers").to.have.all.keys("1", "2", "3");
-        expect(result["1"], "segtax 1 should only have tiers 1 and 2").to.have.all.keys("1", "2");
-        expect(result["1"], "segtax 1 should NOT have tier 3").to.not.have.property("3");
+        expect(result).to.include("filter_6_1_limit=3");
+        expect(result).to.include("filter_6_2_limit=5");
+        expect(result).to.include("filter_6_3_threshold=0.7");
+        expect(result).to.include("filter_1_1_limit=3");
+        expect(result).to.include("filter_1_2_limit=5");
+        expect(result).to.not.include.match(/filter_1_3/);
+        expect(result).to.have.lengthOf(5);
       });
 
       it("should NOT add audience tier filters to IAB 1.0", function () {
@@ -709,46 +708,49 @@ describe("neuwoRtdModule", function () {
           AudienceTier3: { limit: 2 },
           AudienceTier4: { limit: 4 }
         };
-        const result = neuwo.buildIabFilterConfig(filters, 6);
+        const result = neuwo.buildFilterQueryParams(filters, 6);
 
-        expect(result, "should only have segtax 4 (no segtax 1)").to.have.all.keys("4");
-        expect(result, "should not have segtax 1 for audience filters").to.not.have.property("1");
+        expect(result).to.include("filter_4_3_limit=2");
+        expect(result).to.include("filter_4_4_limit=4");
+        expect(result).to.not.include.match(/filter_1/);
+        expect(result).to.have.lengthOf(2);
       });
 
-      it("should add IAB 1.0 filters alongside audience filters", function () {
+      it("should add IAB 1.0 filter params alongside audience filters", function () {
         const filters = {
           ContentTier1: { limit: 3 },
           AudienceTier3: { limit: 2 }
         };
         const contentSegtax = 6;
-        const result = neuwo.buildIabFilterConfig(filters, contentSegtax);
+        const result = neuwo.buildFilterQueryParams(filters, contentSegtax);
 
-        expect(result, "should have segtax 6, 1, and 4").to.have.all.keys("6", "1", "4");
-        expect(result["6"]["1"]).to.deep.equal({ limit: 3 });
-        expect(result["1"]["1"]).to.deep.equal({ limit: 3 });
-        expect(result["4"]["3"]).to.deep.equal({ limit: 2 });
+        expect(result).to.include("filter_6_1_limit=3");
+        expect(result).to.include("filter_1_1_limit=3");
+        expect(result).to.include("filter_4_3_limit=2");
+        expect(result).to.have.lengthOf(3);
       });
 
-      it("should not add segtax 1 when no content filters are provided", function () {
+      it("should not add segtax 1 params when no content filters are provided", function () {
         const filters = {
           AudienceTier3: { limit: 2 }
         };
-        const result = neuwo.buildIabFilterConfig(filters, 6);
+        const result = neuwo.buildFilterQueryParams(filters, 6);
 
-        expect(result, "should only have segtax 4").to.have.all.keys("4");
-        expect(result, "should not have segtax 1").to.not.have.property("1");
+        expect(result).to.include("filter_4_3_limit=2");
+        expect(result).to.not.include.match(/filter_1/);
+        expect(result).to.have.lengthOf(1);
       });
 
-      it("should not add segtax 1 when filters is empty", function () {
-        const result = neuwo.buildIabFilterConfig({}, 6);
+      it("should not add segtax 1 params when filters is empty", function () {
+        const result = neuwo.buildFilterQueryParams({}, 6);
 
-        expect(result, "should return empty object").to.deep.equal({});
+        expect(result).to.deep.equal([]);
       });
 
-      it("should not add segtax 1 when filters is null", function () {
-        const result = neuwo.buildIabFilterConfig(null, 6);
+      it("should not add segtax 1 params when filters is null", function () {
+        const result = neuwo.buildFilterQueryParams(null, 6);
 
-        expect(result, "should return empty object").to.deep.equal({});
+        expect(result).to.deep.equal([]);
       });
 
       it("should work with different content segtax values", function () {
@@ -757,25 +759,27 @@ describe("neuwoRtdModule", function () {
         };
 
         // Test with segtax 7 (IAB 3.0)
-        const result7 = neuwo.buildIabFilterConfig(filters, 7);
-        expect(result7, "should have segtax 7 and 1").to.have.all.keys("7", "1");
-        expect(result7["7"]["1"]).to.deep.equal({ limit: 3 });
-        expect(result7["1"]["1"]).to.deep.equal({ limit: 3 });
+        const result7 = neuwo.buildFilterQueryParams(filters, 7);
+        expect(result7).to.include("filter_7_1_limit=3");
+        expect(result7).to.include("filter_1_1_limit=3");
+        expect(result7).to.have.lengthOf(2);
       });
     });
 
     describe("with enableOrtb25Fields disabled", function () {
-      it("should not add IAB 1.0 filters when disabled", function () {
+      it("should not add IAB 1.0 filter params when disabled", function () {
         const filters = {
           ContentTier1: { limit: 3, threshold: 0.5 },
           ContentTier2: { limit: 5 }
         };
         const contentSegtax = 6;
-        const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
+        const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-        expect(result, "should only have segtax 6").to.have.all.keys("6");
-        expect(result, "should not have segtax 1").to.not.have.property("1");
-        expect(result["6"], "segtax 6 should have tiers 1 and 2").to.have.all.keys("1", "2");
+        expect(result).to.include("filter_6_1_limit=3");
+        expect(result).to.include("filter_6_1_threshold=0.5");
+        expect(result).to.include("filter_6_2_limit=5");
+        expect(result).to.not.include.match(/filter_1/);
+        expect(result).to.have.lengthOf(3);
       });
 
       it("should work correctly with all tier types when disabled", function () {
@@ -786,10 +790,14 @@ describe("neuwoRtdModule", function () {
           AudienceTier3: { limit: 2 }
         };
         const contentSegtax = 6;
-        const result = neuwo.buildIabFilterConfig(filters, contentSegtax, false);
+        const result = neuwo.buildFilterQueryParams(filters, contentSegtax, false);
 
-        expect(result, "should have segtax 6 and 4 only").to.have.all.keys("6", "4");
-        expect(result, "should not have segtax 1").to.not.have.property("1");
+        expect(result).to.include("filter_6_1_limit=3");
+        expect(result).to.include("filter_6_2_limit=5");
+        expect(result).to.include("filter_6_3_threshold=0.7");
+        expect(result).to.include("filter_4_3_limit=2");
+        expect(result).to.not.include.match(/filter_1/);
+        expect(result).to.have.lengthOf(4);
       });
     });
   });
@@ -1301,7 +1309,7 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "PI should include iabVersions parameter for segtax 4").to.include(
           "iabVersions=4"
         );
-        expect(request.method, "API should use POST method").to.equal("POST");
+        expect(request.method, "API should use GET method").to.equal("GET");
 
         request.respond(
           200,
@@ -1359,7 +1367,7 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "API should include iabVersions parameter for segtax 4").to.include(
           "iabVersions=4"
         );
-        expect(request.method, "API should use POST method").to.equal("POST");
+        expect(request.method, "API should use GET method").to.equal("GET");
 
         request.respond(
           200,
@@ -1417,7 +1425,7 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "API should include iabVersions parameter for segtax 4").to.include(
           "iabVersions=4"
         );
-        expect(request.method, "API should use POST method").to.equal("POST");
+        expect(request.method, "API should use GET method").to.equal("GET");
 
         request.respond(
           200,
@@ -1463,7 +1471,7 @@ describe("neuwoRtdModule", function () {
         expect(request.url, "The request URL should include the encoded website URL").to.include(
           encodeURIComponent(conf.params.websiteToAnalyseUrl)
         );
-        expect(request.method, "API should use POST method").to.equal("POST");
+        expect(request.method, "API should use GET method").to.equal("GET");
 
         request.respond(
           200,
@@ -1555,7 +1563,7 @@ describe("neuwoRtdModule", function () {
           expect(contentData, "should have content data").to.exist;
         });
 
-        it("should send IAB 1.0 filter configuration in request body", function () {
+        it("should send IAB 1.0 filter configuration in URL parameters", function () {
           const apiResponse = {
             "1": {
               "1": [{ id: "IAB12" }],
@@ -1575,11 +1583,8 @@ describe("neuwoRtdModule", function () {
           neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
 
           const request = server.requests[0];
-          const requestBody = JSON.parse(request.requestBody);
-          expect(requestBody, "should have filter for segtax 1").to.have.property("1");
-          expect(requestBody["1"], "should have tier 1 filter").to.deep.equal({ "1": { limit: 2 } });
-          expect(requestBody, "should have filter for segtax 6").to.have.property("6");
-          expect(requestBody["6"], "should have tier 1 filter for segtax 6").to.deep.equal({ "1": { limit: 2 } });
+          expect(request.url, "should have filter for segtax 1 tier 1").to.include("filter_1_1_limit=2");
+          expect(request.url, "should have filter for segtax 6 tier 1").to.include("filter_6_1_limit=2");
 
           request.respond(
             200,
@@ -1635,7 +1640,7 @@ describe("neuwoRtdModule", function () {
           expect(contentData, "should still have content data").to.exist;
         });
 
-        it("should not send IAB 1.0 filters in request body", function () {
+        it("should not send IAB 1.0 filters in URL parameters", function () {
           const bidsConfig = bidsConfiglike();
           const conf = config();
           conf.params.websiteToAnalyseUrl = "https://publisher.works/article.php?id=5";
@@ -1647,10 +1652,10 @@ describe("neuwoRtdModule", function () {
 
           neuwo.getBidRequestData(bidsConfig, () => {}, conf, "consent data");
           const request = server.requests[0];
-          const requestBody = JSON.parse(request.requestBody);
 
-          expect(requestBody, "should not have segtax 1 filters").to.not.have.property("1");
-          expect(requestBody, "should have segtax 6 filters").to.have.property("6");
+          expect(request.url, "should not have segtax 1 filters").to.not.match(/filter_1_/);
+          expect(request.url, "should have segtax 6 filters").to.include("filter_6_1_limit=3");
+          expect(request.url, "should have segtax 6 tier 2 filters").to.include("filter_6_2_limit=5");
         });
       });
     });