diff --git a/dev-docs/bidders/trustx.md b/dev-docs/bidders/trustx.md index 05ac4e2976..dd89ded096 100644 --- a/dev-docs/bidders/trustx.md +++ b/dev-docs/bidders/trustx.md @@ -1,23 +1,18 @@ --- layout: bidder -title: TrustX -description: Prebid TrustX Bidder Adaptor +title: TRUSTX +description: Prebid TRUSTX Bidder Adapter pbjs: true pbs: true biddercode: trustx -aliasCode: grid media_types: banner, video multiformat_supported: will-bid-on-any -gvl_id: 686 (grid) -tcfeu_supported: true usp_supported: true schain_supported: true floors_supported: true userIds: all -tcf2_supported: true coppa_supported: true fpd_supported: true -pbjs_version_notes: 7.0 and after sidebarType: 1 --- @@ -25,73 +20,22 @@ sidebarType: 1 - [Table of Contents](#table-of-contents) - [Bid Params](#bid-params) -- [Bidder Config](#bidder-config) - [First Party Data](#first-party-data) - - ### Bid Params {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type | |----------------|-----------|----------------------------------------------------------------------------------------------------------|-------------------------------------------|-----------| -| `uid` | required | Represents the TrustX bidder system Ad Slot ID associated with the respective div id from the site page. | `42` | `integer` | -| `keywords` | optional | A set of key-value pairs applied to all ad slots on the page. Values can be empty. | `keywords: { topic: ['stress', 'fear'] }` | `object` | +| `uid` | required* | Represents the TRUSTX bidder system Ad Slot ID. Alternative to `secid`. | `42` | `integer` | +| `secid` | required* | Alternative to `uid`. Represents the TRUSTX bidder system Ad Slot ID. | `42` | `integer` | | `bidFloor` | optional | Floor of the impression opportunity. If present in the request overrides XML info. | `0.8` | `float` | +| `currency` | optional | Currency for bid floor. Defaults to `USD`. | `USD` | `string` | +| `test` | optional | Enable test mode to receive test creatives without real Ad Slots. | `true` | `boolean` | -Parameter `keywords` must have following format: - -```javascript -{ - "site":{ - "publisher1":[ - { - "name":"SomeKeywordsBlockName", - "segment1Name":[ - "segment2Value" - ], - "segment2Name":[ - "segment2Value1", - "segment2Value2", - ... - ], - ... - } - ], - ... - } -} -``` - - - -### Bidder Config - -You can allow writing in localStorage `pbjs.setBidderConfig` for the bidder `trustx` - -```javascript -pbjs.setBidderConfig({ - bidders: ["trustx"], - config: { - localStorageWriteAllowed: true - } -}) -``` - -If it will be "true" this allow TheMediaGrid Bid Adapter to write userId in first party localStorage - -If you want to make alias on TrustX Bid Adapter, you must set `forceBidderName` in bidderConfig as `"trustx"`. - -```javascript -pbjs.setBidderConfig({ - bidders: ["aliasName"], - config: { - forceBidderName: 'trustx' - } -}) -``` +\* Either `uid` or `secid` is required (one of them must be provided). - +**Note:** The adapter also supports Prebid's Floor Module via `getFloor()` function. ### First Party Data @@ -101,11 +45,17 @@ Global site or user data using `setConfig()`, or Bidder-specific using `setBidde - `ortb2.user.data[]`: Standard IAB segment taxonomy user data - `ortb2.user.ext.device`: Non standard arbitrary user device -- `ortb2.user.keywords`: Standard IAB OpenRTB 2.5 user.keywords field. It will be included in ext.keywords.user.ortb2 -- `ortb2.site.keywords`: Standard IAB OpenRTB 2.5 site.keywords field. It will be included in ext.keywords.site.ortb2 -- `ortb2.site.cat[]`: Standard IAB OpenRTB 2.5 site.cat field. It will be sent as part of site.cat array -- `ortb2.site.pagecat[]`: Standard IAB OpenRTB 2.5 site.pagecat field. It will be sent as part of site.cat array +- `ortb2.user.keywords`: Standard IAB OpenRTB 2.5 user.keywords field +- `ortb2.site.keywords`: Standard IAB OpenRTB 2.5 site.keywords field +- `ortb2.site.cat[]`: Standard IAB OpenRTB 2.5 site.cat field +- `ortb2.site.pagecat[]`: Standard IAB OpenRTB 2.5 site.pagecat field - `ortb2.site.content.genre`: Standard IAB OpenRTB 2.5 site.content.genre field +- `ortb2.site.content.data[]`: Standard IAB OpenRTB 2.5 site.content.data field +- `ortb2.site.content.id`: Standard IAB OpenRTB 2.5 site.content.id field +- `ortb2.site.content.title`: Standard IAB OpenRTB 2.5 site.content.title field +- `ortb2.source.tid`: Transaction ID from source +- `ortb2.source.ext.schain`: Supply chain object +- `ortb2.regs.ext.dsa`: Digital Services Act (DSA) data AdUnit-specific data using `AdUnit.ortb2Imp` supports following fields: