Skip to content

Trustx bidder adapter #6355

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Trustx bidder adapter #6355

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
012a881
TrustX Adapter: Update documentation
trustXops Nov 26, 2025
e50af81
Update required fields/notes
trustXops Nov 26, 2025
296af10
Update uid/secid notes
trustXops Nov 26, 2025
90deeeb
Define uid/secid as integer
trustXops Nov 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 18 additions & 27 deletions dev-docs/bidders/trustx.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
---

Expand All @@ -28,16 +23,21 @@ sidebarType: 1
- [Bidder Config](#bidder-config)
- [First Party Data](#first-party-data)

<a name="trustx-bid-params"></a>

### 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` |
| `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` |
| `test` | optional | Enable test mode to receive test creatives without real Ad Slots. | `true` | `boolean` |

\* Either `uid` or `secid` is required (one of them must be provided).

**Note:** The adapter also supports Prebid's Floor Module via `getFloor()` function.

Parameter `keywords` must have following format:

Expand All @@ -63,8 +63,6 @@ Parameter `keywords` must have following format:
}
```

<a name="trustx-bidder-config"></a>

### Bidder Config

You can allow writing in localStorage `pbjs.setBidderConfig` for the bidder `trustx`
Expand All @@ -78,20 +76,7 @@ pbjs.setBidderConfig({
})
```

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'
}
})
```

<a name="trustx-first-party"></a>
If it will be "true" this allows TRUSTX Bid Adapter to write userId in first party localStorage

### First Party Data

Expand All @@ -106,6 +91,12 @@ Global site or user data using `setConfig()`, or Bidder-specific using `setBidde
- `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.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:

Expand Down