Audio.startdelay
Where the audio ad plays relative to the content, in seconds: 0 for pre-roll, a positive number for a mid-roll at that offset, -1 for a generic mid-roll, and -2 for a generic post-roll. Recommended.
Field facts
- Path
imp.audio.startdelay- Object
- Audio
- Type
- integer
- Requirement
- Recommended
- Added
- OpenRTB 2.4
- Values
- AdCOM list Start Delay Modes
- Spec section
- 3.2.8
How it is used
Podcast and streaming rate cards often price pre-roll, mid-roll, and post-roll differently. With dynamic insertion the exact offset is rarely fixed in advance, so -1 is usually the accurate mid-roll value.
Allowed values
| Value | Meaning |
|---|---|
>0 | Mid-Roll (the value is the start delay in seconds): Any positive integer: a mid-roll that starts that many seconds into the content, such as 600 for a break at ten minutes. |
0 | Pre-Roll: Pre-roll: the ad plays before the content starts. |
-1 | Generic Mid-Roll: Generic mid-roll: the ad plays during the content at an offset the seller does not state. |
-2 | Generic Post-Roll: Generic post-roll: the ad plays after the content ends. |
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"imp": [
{
"audio": {
"startdelay": -1
}
}
]
}Common mistakes
- Sending -1 for a pre-roll, which is 0.
Version history
Added in OpenRTB 2.4, 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.4 | integer | Recommended | No |
| 2.5 | integer | Recommended | No |
| 2.6-202210 to 2.6-202606 | integer | Recommended | No |
Related fields
Other Audio fields
apibattrcompanionadcompaniontypedeliverydurfloorsextfeedmaxbitratemaxdurationmaxextendedmaxseqmimesminbitratemincpmpersecmindurationnvolpoddurpodidpodseqprotocolsrqddurssequenceslotinpodstitched
For a walkthrough of the whole object, read Audio object guide.