Nativo
Features
| Bidder Code | nativo | Prebid.org Member | no |
|---|---|---|---|
| Prebid.js Adapter | yes | Prebid Server Adapter | yes |
| Media Types | display, video, native | Multi Format Support | will-bid-on-one |
| TCF-EU Support | yes | IAB GVL ID | 263 |
| GPP Support | some (check with bidder) | DSA Support | no |
| USP/CCPA Support | yes | COPPA Support | no |
| Supply Chain Support | yes | Demand Chain Support | check with bidder |
| Safeframes OK | check with bidder | Supports Deals | check with bidder |
| Floors Module Support | yes | First Party Data Support | no |
| Endpoint Compression | check with bidder | ORTB Blocking Support | yes |
| User IDs | all | Privacy Sandbox | check with bidder |
| Prebid Server App Support | yes |
Note
The Nativo Bidder adapter requires setup before beginning. Please contact us at prebiddev@nativo.com beforehand.
Adapter Behavior
The Nativo Prebid Server adapter (both PBS-Go and PBS-Java) is a pure pass-through adapter. It forwards the full OpenRTB bid request to Nativo’s endpoint without transformation. The only modification made by Prebid Server core is rewriting imp[].ext — stripping the ext.prebid.bidder.nativo routing wrapper so the bidder receives ext.bidder directly.
The Java implementation uses the shared GenericBidder class, making it functionally identical to the Go adapter.
Media type detection (banner, video, native) is determined at response time by inspecting the matched imp object.
Bid Params
Prebid Server
The Prebid Server adapter requires at least one of the following identifiers on each impression. They are passed through in imp[].ext.bidder and imp[].tagid as standard OpenRTB fields.
imp[].tagid is the preferred integration method. This allows Nativo to set up a single catchall placement that will auto-create new placements based on a configurable request threshold on unique tagids (20k is default).
placementId should be reserved for unique use cases.
At least one of tagid, placementId, or gpid must be provided.
| Name | Scope | Description | Example | Type |
|---|---|---|---|---|
imp.tagid |
optional (preferred) | The Ad Slot Tag ID — a standard OpenRTB field and the recommended identifier. See OpenRTB 2.6 imp.tagid. | homepage_infeed_atf |
string |
placementId |
optional | The unique Placement ID assigned by the Nativo platform. Set by the publisher in imp[].ext.prebid.bidder.nativo.placementId — Prebid Server translates this to imp[].ext.bidder.placementId before forwarding the request to Nativo. Reserved for unique use cases. |
12345678 |
integer |
imp.ext.gpid |
optional (standard Prebid field) | The Global Placement ID (GPID). Used as a fallback if neither tagid nor placementId is present. See GPID docs. |
/22888152279/publication/placement/gpid_example |
string |
Example OpenRTB request to Prebid Server (banner)
{
"id": "request-1",
"site": {
"page": "https://example.com/article",
"publisher": { "id": "pub-123" }
},
"imp": [{
"id": "imp-1",
"tagid": "homepage_infeed_atf",
"banner": {
"format": [{ "w": 300, "h": 250 }]
},
"ext": {
"gpid": "/123456/homepage_infeed_atf_1",
"prebid": {
"bidder": {
"nativo": {
"placementId": 12345678
}
}
}
}
}],
"tmax": 1000
}
What Nativo’s endpoint receives
Prebid Server rewrites imp[].ext, stripping the ext.prebid.bidder.nativo routing wrapper. placementId is promoted from imp[].ext.prebid.bidder.nativo.placementId → imp[].ext.bidder.placementId:
{
"id": "request-1",
"site": {
"page": "https://example.com/article",
"publisher": { "id": "pub-123" }
},
"imp": [{
"id": "imp-1",
"tagid": "homepage_infeed_atf",
"banner": {
"format": [{ "w": 300, "h": 250 }]
},
"ext": {
"gpid": "/123456/homepage_infeed_atf_1",
"bidder": {
"placementId": 12345678
}
}
}],
"tmax": 1000
}
If no params are provided, Nativo receives "ext": { "bidder": {} } and relies on imp.tagid or imp.ext.gpid for placement matching.
Example with native format
{
"imp": [{
"id": "imp-1",
"tagid": "homepage_infeed_atf",
"native": {
"request": "{\"ver\":\"1.1\",\"layout\":1,\"adunit\":2,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":90}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"wmin\":300,\"hmin\":200}}]}"
},
"ext": {
"gpid": "/123456/homepage_infeed_atf_1",
"prebid": {
"bidder": {
"nativo": {
"placementId": 12345678
}
}
}
}
}]
}
Prebid.js
| Name | Scope | Description | Example | Type |
|---|---|---|---|---|
placementId |
required | Publication placement ID value from the Nativo Platform | 13144370 |
integer |
url |
optional | Publication URL associated with the placement ID in the Nativo Platform | https://example.com/article |
string |
"Send All Bids" Ad Server Keys
These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.hb_pb_nativo |
hb_bidder_nativo |
hb_adid_nativo |
hb_size_nativo |
hb_source_nativo |
hb_format_nativo |
hb_cache_host_nativo |
hb_cache_id_nativo |
hb_uuid_nativo |
hb_cache_path_nativo |
hb_deal_nativo |