Imp.tagid
The seller's identifier for the ad placement or tag that started the auction. Unlike Imp.id it stays the same across requests, so buyers can learn how a placement performs over time.
Field facts
- Path
imp.tagid- Object
- Imp
- Type
- string
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 3.2.4
How it is used
Publishers and exchanges also use it to trace delivery problems back to one slot. Keep it stable and opaque: renaming placements wipes out every buyer's history for them.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"imp": [
{
"tagid": "homepage-top-leaderboard"
}
]
}Common mistakes
- Putting a per-request value such as a timestamp or random token in tagid, which destroys its use as a placement key.
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.1 | string | No | No |
| 2.2 | string | No | No |
| 2.3 to 2.4 | string | No | No |
| 2.5 to 2.6-202606 | string | No | No |
Related fields
Other Imp fields
audiobannerbidfloorbidfloorcurclickbrowserdisplaymanagerdisplaymanagerverdtexpextidiframebusterinstlmetricnativepmpqtyrefreshrwddsecuressaivideo
For a walkthrough of the whole object, read Bid request anatomy.