From a9fa4e34b9265850608a7a4926db6ebaeeafb124 Mon Sep 17 00:00:00 2001 From: Samonin Date: Mon, 27 Jul 2026 16:26:10 +0300 Subject: [PATCH 1/6] updated ntvagents.md according to code --- dev-docs/bidders/ntvagents.md | 327 ++++++++++++++++++++++++++++++++-- 1 file changed, 314 insertions(+), 13 deletions(-) diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md index 2f45839851..9b04466cfa 100644 --- a/dev-docs/bidders/ntvagents.md +++ b/dev-docs/bidders/ntvagents.md @@ -1,35 +1,336 @@ --- layout: bidder title: Native Agents -description: Prebid Native Agents Bidder Adapter +description: Native Agents Prebid Bidder Adapter biddercode: ntvagents +gpp_supported: true gpp_sids: usstate_all tcfeu_supported: false +dsa_supported: false usp_supported: true coppa_supported: true -schain_supported: true -deals_supported: false -floors_supported: true -fpd_supported: false -ortb_blocking_supported: false +schain_supported:true +dchain_supported:false +deals_supported:false +floors_supported:true +fpd_supported:false +ortb_blocking_supported:false media_types: banner, video, native multiformat_supported: will-bid-on-one userIds: all pbjs: true pbs: true pbs_app_supported: true +prebid_member: false safeframes_ok: true sidebarType: 1 --- -## Bid Params +# Native Agents Bidder Adapter + +The Native Agents bidder enables publishers to monetize their inventory through the Native Agents advertising platform using either **Prebid.js** or **Prebid Server**. + +The adapter supports: + +- Banner +- Native (OpenRTB Native) +- Video (Instream & Outstream) + +Native Agents receives bid requests from Prebid, converts them into OpenRTB requests, executes an auction across eligible demand partners, and returns the highest qualifying bid to Prebid. + +--- + +# Registration + +Before integrating the Native Agents bidder, your inventory must be configured within the Native Agents platform. + +During onboarding, Native Agents creates: + +- A **Supply Source** representing your website or mobile application. +- One or more **Placements** representing individual ad locations on your inventory. + +Each Placement receives a unique **placementId**, which is used by the bidder to identify the inventory during bidding. + +Depending on your account configuration, Native Agents may instead provide an **endpointId**. + +Only **one** identifier is required when configuring the bidder. + +For onboarding and production credentials, contact your Native Agents account representative. + +--- + +# Supported Features + +| Feature | Supported | +|----------|-----------| +| Banner | ✓ | +| Native | ✓ | +| Video (Instream & Outstream) | ✓ | +| Prebid.js | ✓ | +| Prebid Server | ✓ | +| Floors | ✓ | +| Supply Chain (schain) | ✓ | +| USP / CCPA | ✓ | +| COPPA | ✓ | + +--- + +# Bid Parameters + +Specify **either** `placementId` **or** `endpointId`. + +Do **not** provide both. {: .table .table-bordered .table-striped } -| Name | Scope | Description | Example | Type | -|---------------|----------|--------------|---------------------------------|------------| -| `placementId` | optional | Placement Id | `'0'` | `'string'` | -| `endpointId` | optional | Endpoint Id | `'0'` | `'string'` | -## Note +| Name | Required | Description | Type | Example | +|------|----------|-------------|------|---------| +| placementId | No* | Unique identifier for a Placement configured within the Native Agents platform. | String | `"100001"` | +| endpointId | No* | Unique identifier for an Endpoint configured for your account. | String | `"200001"` | + +\*One of `placementId` or `endpointId` is required. + +--- + +# Banner Example + +```javascript +var adUnits = [{ + code: "banner-div", + + mediaTypes: { + banner: { + sizes: [ + [300,250], + [300,600] + ] + } + }, + + bids: [{ + bidder: "ntvagents", + + params: { + placementId: "100001" + } + }] +}]; +``` + +--- + +# Native Example + +```javascript +var adUnits = [{ + code: "native-div", + + mediaTypes: { + native: { + ortb: { + assets: [ + { + id: 1, + required: 1, + title: { + len: 100 + } + }, + { + id: 2, + required: 1, + img: { + type: 3, + w: 300, + h: 250 + } + }, + { + id: 3, + required: 1, + data: { + type: 1 + } + } + ] + } + } + }, + + bids: [{ + bidder: "ntvagents", + + params: { + placementId: "100001" + } + }] +}]; +``` + +--- + +# Video Example + +Both **Instream** and **Outstream** video contexts are supported. + +```javascript +var adUnits = [{ + code: "video-div-instream", + + mediaTypes: { + video: { + context: "instream", + playerSize: [640,480], + mimes: ["video/mp4"], + protocols: [2,3,5,6], + api: [2], + minduration: 5, + maxduration: 30, + linearity: 1 + } + }, + + bids: [{ + bidder: "ntvagents", + + params: { + placementId: "100001" + } + }] +}]; +``` + +```javascript +var adUnits = [{ + code: "video-div-outstream", + + mediaTypes: { + video: { + context: "outstream", + playerSize: [640,480], + mimes: ["video/mp4"], + protocols: [2,3,5,6], + api: [2], + maxduration: 30, + linearity: 1 + } + }, + + bids: [{ + bidder: "ntvagents", + + params: { + placementId: "100001" + } + }] +}]; +``` + +--- + +# OpenRTB Support + +The Native Agents bidder converts Prebid bid requests into OpenRTB bid requests before forwarding them to the Native Agents bidding platform. + +The adapter supports OpenRTB requests for: + +- Banner +- Native +- Video (Instream & Outstream) + +using the corresponding OpenRTB object definitions. + +--- + +# Creative Rendering + +The Native Agents bidder returns creatives compatible with standard Prebid rendering workflows. + +Supported creative formats include: + +| Media Type | Response | +|------------|----------| +| Banner | HTML Markup | +| Native | OpenRTB Native Assets | +| Video (Instream & Outstream) | VAST XML / VAST URL | + +Banner and Native creatives are rendered using Prebid's standard rendering pipeline. + +Video responses return VAST-compatible creatives suitable for both instream video players and supported outstream video players. + +--- + +# User Sync + +Native Agents supports both iframe and image user synchronization. + +```javascript +pbjs.setConfig({ + userSync: { + filterSettings: { + iframe: { + bidders: ["ntvagents"], + filter: "include" + }, + image: { + bidders: ["ntvagents"], + filter: "include" + } + } + } +}); +``` + +User synchronization is performed only when permitted by applicable privacy regulations. + +--- + +# Privacy + +The Native Agents bidder supports the following privacy frameworks: + +- USP / CCPA +- COPPA +- Supply Chain Object (schain) + +When available, the adapter automatically forwards privacy signals received from Prebid to the Native Agents bidding platform. + +--- + +# Bidder Aliasing + +The Native Agents bidder supports Prebid bidder aliasing. + +```javascript +pbjs.aliasBidder("ntvagents", "ntvagentsAlias"); +``` + +Aliasing allows multiple Native Agents bidder instances to participate in the same auction using different configurations. + +--- + +# Test Parameters + +Native Agents provides test placements during onboarding. + +Replace the example values below with the test identifiers supplied by your Native Agents account representative. + +```javascript +{ + bidder: "ntvagents", + + params: { + placementId: "100001" + } +} +``` + +--- + +# Notes -For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId +- Configure **either** `placementId` **or** `endpointId`. +- Banner, Native, and Video (Instream & Outstream) are supported. +- Compatible with both **Prebid.js** and **Prebid Server**. +- Inventory must be configured within the Native Agents platform before bid requests can be made. +- Native Agents also supports Direct Tag and JavaScript tag integrations outside of Prebid. Refer to the Native Agents integration documentation for those integration methods. \ No newline at end of file From ffa9dffe5b0f054304f84977fad72ce62267e4d4 Mon Sep 17 00:00:00 2001 From: Samonin Date: Mon, 27 Jul 2026 16:42:33 +0300 Subject: [PATCH 2/6] fix(docs): resolve markdownlint MD060/MD047 issues in ntvagents.md Align table column pipes to satisfy MD060 table-column-style and add missing trailing newline for MD047. --- dev-docs/bidders/ntvagents.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md index 9b04466cfa..f91d874389 100644 --- a/dev-docs/bidders/ntvagents.md +++ b/dev-docs/bidders/ntvagents.md @@ -62,7 +62,7 @@ For onboarding and production credentials, contact your Native Agents account re # Supported Features | Feature | Supported | -|----------|-----------| +| ---------- | ----------- | | Banner | ✓ | | Native | ✓ | | Video (Instream & Outstream) | ✓ | @@ -83,10 +83,10 @@ Do **not** provide both. {: .table .table-bordered .table-striped } -| Name | Required | Description | Type | Example | -|------|----------|-------------|------|---------| -| placementId | No* | Unique identifier for a Placement configured within the Native Agents platform. | String | `"100001"` | -| endpointId | No* | Unique identifier for an Endpoint configured for your account. | String | `"200001"` | +| Name | Required | Description | Type | Example | +|-------------|----------|---------------------------------------------------------------------------------|--------|------------| +| placementId | No* | Unique identifier for a Placement configured within the Native Agents platform. | String | `"100001"` | +| endpointId | No* | Unique identifier for an Endpoint configured for your account. | String | `"200001"` | \*One of `placementId` or `endpointId` is required. @@ -249,7 +249,7 @@ The Native Agents bidder returns creatives compatible with standard Prebid rende Supported creative formats include: | Media Type | Response | -|------------|----------| +| ------------ | ---------- | | Banner | HTML Markup | | Native | OpenRTB Native Assets | | Video (Instream & Outstream) | VAST XML / VAST URL | @@ -333,4 +333,4 @@ Replace the example values below with the test identifiers supplied by your Nati - Banner, Native, and Video (Instream & Outstream) are supported. - Compatible with both **Prebid.js** and **Prebid Server**. - Inventory must be configured within the Native Agents platform before bid requests can be made. -- Native Agents also supports Direct Tag and JavaScript tag integrations outside of Prebid. Refer to the Native Agents integration documentation for those integration methods. \ No newline at end of file +- Native Agents also supports Direct Tag and JavaScript tag integrations outside of Prebid. Refer to the Native Agents integration documentation for those integration methods. From 4330496d07539a89c79d63899d18766903cc52b7 Mon Sep 17 00:00:00 2001 From: Samonin Date: Wed, 29 Jul 2026 13:20:07 +0300 Subject: [PATCH 3/6] address review feedback on ntvagents.md - Remove horizontal rule separators - Remove Supported Features and Privacy sections (duplicate front-matter metadata already rendered by the bidder layout) - Remove Bidder Aliasing section (aliasing is a Prebid.js core feature, not adapter-specific) --- dev-docs/bidders/ntvagents.md | 70 +++-------------------------------- 1 file changed, 5 insertions(+), 65 deletions(-) diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md index f91d874389..41f7314818 100644 --- a/dev-docs/bidders/ntvagents.md +++ b/dev-docs/bidders/ntvagents.md @@ -38,8 +38,6 @@ The adapter supports: Native Agents receives bid requests from Prebid, converts them into OpenRTB requests, executes an auction across eligible demand partners, and returns the highest qualifying bid to Prebid. ---- - # Registration Before integrating the Native Agents bidder, your inventory must be configured within the Native Agents platform. @@ -57,24 +55,6 @@ Only **one** identifier is required when configuring the bidder. For onboarding and production credentials, contact your Native Agents account representative. ---- - -# Supported Features - -| Feature | Supported | -| ---------- | ----------- | -| Banner | ✓ | -| Native | ✓ | -| Video (Instream & Outstream) | ✓ | -| Prebid.js | ✓ | -| Prebid Server | ✓ | -| Floors | ✓ | -| Supply Chain (schain) | ✓ | -| USP / CCPA | ✓ | -| COPPA | ✓ | - ---- - # Bid Parameters Specify **either** `placementId` **or** `endpointId`. @@ -90,8 +70,6 @@ Do **not** provide both. \*One of `placementId` or `endpointId` is required. ---- - # Banner Example ```javascript @@ -117,8 +95,6 @@ var adUnits = [{ }]; ``` ---- - # Native Example ```javascript @@ -167,8 +143,6 @@ var adUnits = [{ }]; ``` ---- - # Video Example Both **Instream** and **Outstream** video contexts are supported. @@ -226,8 +200,6 @@ var adUnits = [{ }]; ``` ---- - # OpenRTB Support The Native Agents bidder converts Prebid bid requests into OpenRTB bid requests before forwarding them to the Native Agents bidding platform. @@ -240,26 +212,22 @@ The adapter supports OpenRTB requests for: using the corresponding OpenRTB object definitions. ---- - # Creative Rendering The Native Agents bidder returns creatives compatible with standard Prebid rendering workflows. Supported creative formats include: -| Media Type | Response | -| ------------ | ---------- | -| Banner | HTML Markup | -| Native | OpenRTB Native Assets | -| Video (Instream & Outstream) | VAST XML / VAST URL | +| Media Type | Response | +|------------------------------|-----------------------| +| Banner | HTML Markup | +| Native | OpenRTB Native Assets | +| Video (Instream & Outstream) | VAST XML / VAST URL | Banner and Native creatives are rendered using Prebid's standard rendering pipeline. Video responses return VAST-compatible creatives suitable for both instream video players and supported outstream video players. ---- - # User Sync Native Agents supports both iframe and image user synchronization. @@ -283,32 +251,6 @@ pbjs.setConfig({ User synchronization is performed only when permitted by applicable privacy regulations. ---- - -# Privacy - -The Native Agents bidder supports the following privacy frameworks: - -- USP / CCPA -- COPPA -- Supply Chain Object (schain) - -When available, the adapter automatically forwards privacy signals received from Prebid to the Native Agents bidding platform. - ---- - -# Bidder Aliasing - -The Native Agents bidder supports Prebid bidder aliasing. - -```javascript -pbjs.aliasBidder("ntvagents", "ntvagentsAlias"); -``` - -Aliasing allows multiple Native Agents bidder instances to participate in the same auction using different configurations. - ---- - # Test Parameters Native Agents provides test placements during onboarding. @@ -325,8 +267,6 @@ Replace the example values below with the test identifiers supplied by your Nati } ``` ---- - # Notes - Configure **either** `placementId` **or** `endpointId`. From f6d412f0f2dcb057a4e2a859b186d6a26cc8da88 Mon Sep 17 00:00:00 2001 From: Muki Seiler Date: Thu, 30 Jul 2026 15:20:37 +0200 Subject: [PATCH 4/6] Update dev-docs/bidders/ntvagents.md --- dev-docs/bidders/ntvagents.md | 1 - 1 file changed, 1 deletion(-) diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md index 41f7314818..ca43eeee7f 100644 --- a/dev-docs/bidders/ntvagents.md +++ b/dev-docs/bidders/ntvagents.md @@ -3,7 +3,6 @@ layout: bidder title: Native Agents description: Native Agents Prebid Bidder Adapter biddercode: ntvagents -gpp_supported: true gpp_sids: usstate_all tcfeu_supported: false dsa_supported: false From e1aa9561aaccba29c13d2390903e92ce7127fa6e Mon Sep 17 00:00:00 2001 From: Muki Seiler Date: Thu, 30 Jul 2026 15:20:44 +0200 Subject: [PATCH 5/6] Update dev-docs/bidders/ntvagents.md --- dev-docs/bidders/ntvagents.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md index ca43eeee7f..9f675d7dd3 100644 --- a/dev-docs/bidders/ntvagents.md +++ b/dev-docs/bidders/ntvagents.md @@ -8,12 +8,12 @@ tcfeu_supported: false dsa_supported: false usp_supported: true coppa_supported: true -schain_supported:true -dchain_supported:false -deals_supported:false -floors_supported:true -fpd_supported:false -ortb_blocking_supported:false +schain_supported: true +dchain_supported: false +deals_supported: false +floors_supported: true +fpd_supported: false +ortb_blocking_supported: false media_types: banner, video, native multiformat_supported: will-bid-on-one userIds: all From 7501b6bf01fab6abb9cb025518167bbb598cfbaf Mon Sep 17 00:00:00 2001 From: Muki Seiler Date: Thu, 30 Jul 2026 15:20:51 +0200 Subject: [PATCH 6/6] Update dev-docs/bidders/ntvagents.md --- dev-docs/bidders/ntvagents.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md index 9f675d7dd3..cc7fe2e47c 100644 --- a/dev-docs/bidders/ntvagents.md +++ b/dev-docs/bidders/ntvagents.md @@ -29,13 +29,6 @@ sidebarType: 1 The Native Agents bidder enables publishers to monetize their inventory through the Native Agents advertising platform using either **Prebid.js** or **Prebid Server**. -The adapter supports: - -- Banner -- Native (OpenRTB Native) -- Video (Instream & Outstream) - -Native Agents receives bid requests from Prebid, converts them into OpenRTB requests, executes an auction across eligible demand partners, and returns the highest qualifying bid to Prebid. # Registration