Bid.nurl
The win notice URL, which the exchange calls when this bid wins the auction. A win does not necessarily mean the ad was delivered, viewed, or billable. The response to this call can also carry the ad markup.
Field facts
- Path
seatbid.bid.nurl- Object
- Bid
- Type
- string
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 4.2.3
How it is used
Include ${AUCTION_PRICE} so the notice reports the clearing price, plus other macros such as ${AUCTION_ID} as needed. When markup is served on the win notice, the call's response body must contain only the markup and Bid.adm must be left out; if both supply markup, adm wins. Since 2.5, Bid.burl is the better place to count billable events.
Example
Where the field sits in a payload, with everything else left out:
{
"seatbid": [
{
"bid": [
{
"nurl": "https://win.dsp.example/w?auction=${AUCTION_ID}&price=${AUCTION_PRICE}"
}
]
}
]
}Common mistakes
- A win URL without
${AUCTION_PRICE}, so the bidder never learns what it paid (openrtb.bid.price_macro_missing). - Counting win notices as impressions. Exchanges may send them for wins that never render.
Version history
Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.
| Versions | Type in the spec | Required | Deprecated |
|---|---|---|---|
| 2.0 to 2.2 | string | No | No |
| 2.3 to 2.6-202606 | string | No | No |
Related fields
Other Bid fields
adidadmadomainapiapisattrbundleburlcatcattaxcidcriddealiddurexpexthhratioidimpidiurllangblanguagelurlmtypepriceprotocolqagmediaratingslotinpodtacticwwratio
For a walkthrough of the whole object, read Bid response anatomy.