OpenRTB Bid Response
HTTP 200 BidResponse from POST /openrtb/{PublisherKey}. price is USD earnings per click, not CPM. HTTP 204 is an empty no-bid and is not this object.
Fields
id
string
Copied from the bid request id.
bidid
string
UUID for this response. Same value as seatbid[0].bid[0].id.
cur
string
Always USD.
seatbid
array
One seat object containing one bid for imp[0].
seatbid[].seat
string
Assigned seat id, or the Publisher Identity when no seat id is assigned.
seatbid[].bid[].id
string
Same UUID as bidid.
seatbid[].bid[].impid
string
imp.id of the first impression.
seatbid[].bid[].price
float
USD earnings per click. Not CPM. Rounded to 4 decimal places.
seatbid[].bid[].adm
string
JSON string. After parsing, native.link.url is the click URL.
seatbid[].bid[].adomain
array of strings
Advertiser host, or an empty array when no domain was sent.
seatbid[].bid[].ext.final_url
string
Deeplink, otherwise site.page, otherwise the advertiser domain. Can be empty.
seatbid[].bid[].ext.altered
boolean
true only when imp.native.ext.alt is 1 or true.
seatbid[].bid[].ext.advertiser_name
string
Advertiser host. Empty string when no domain was on the request.
seatbid[].bid[].ext.advertiser_id
string
Internal advertiser id for the brand that was bid.
| ATTRIBUTE | TYPE | DESCRIPTION |
|---|---|---|
| id | string | Copied from the bid request id. |
| bidid | string | UUID for this response. Same value as seatbid[0].bid[0].id. |
| cur | string | Always USD. |
| seatbid | array | One seat object containing one bid for imp[0]. |
| seatbid[].seat | string | Assigned seat id, or the Publisher Identity when no seat id is assigned. |
| seatbid[].bid[].id | string | Same UUID as bidid. |
| seatbid[].bid[].impid | string | imp.id of the first impression. |
| seatbid[].bid[].price | float | USD earnings per click. Not CPM. Rounded to 4 decimal places. |
| seatbid[].bid[].adm | string | JSON string. After parsing, native.link.url is the click URL. |
| seatbid[].bid[].adomain | array of strings | Advertiser host, or an empty array when no domain was sent. |
| seatbid[].bid[].ext.final_url | string | Deeplink, otherwise site.page, otherwise the advertiser domain. Can be empty. |
| seatbid[].bid[].ext.altered | boolean | true only when imp.native.ext.alt is 1 or true. |
| seatbid[].bid[].ext.advertiser_name | string | Advertiser host. Empty string when no domain was on the request. |
| seatbid[].bid[].ext.advertiser_id | string | Internal advertiser id for the brand that was bid. |
Example Payload
{
"id": "auction-123",
"bidid": "7c1e4b2a-9f08-4d6e-a1b3-2e5f8c0d4a61",
"cur": "USD",
"seatbid": [
{
"seat": "YOUR_SEAT_OR_PUBLISHER_KEY",
"bid": [
{
"id": "7c1e4b2a-9f08-4d6e-a1b3-2e5f8c0d4a61",
"impid": "1",
"price": 0.2,
"adomain": [
"advertiser.example"
],
"adm": "{\"native\":{\"link\":{\"url\":\"https://click.example/track?encyp=ENCRYPTED&rtuli=9f3c2a1b0e8d7c6a5b4f3e2d1c0b9a87&clickid=click-123\"}}}",
"ext": {
"altered": false,
"final_url": "https://advertiser.example/",
"advertiser_name": "advertiser.example",
"advertiser_id": "BRAND-ID"
}
}
]
}
]
}