VAST tracking events / Linear
VAST progress tracking event
Short answer: Fires at a declared offset. The only tracking event that takes a parameter. Introduced in VAST 3.0.
When it fires
Playback reached the offset attribute. Offset must be HH:MM:SS or n%. A bare number of seconds is invalid. An offset past Duration can never fire, which looks like a dead tracker.
Where it is valid
| 2.0 | 3.0 | 4.0 | 4.1+ |
|---|---|---|---|
| No | Yes | Yes | Yes |
Legal containers: Linear. An event in the wrong container is not a player error. It is a URL nobody calls.
Using it in a tag
<TrackingEvents>
<Tracking event="progress" offset="00:00:15">
<![CDATA[https://track.example.com/progress]]>
</Tracking>
</TrackingEvents>VAST XML fragment only. This excerpt belongs inside a complete VAST document, so standalone validation will fail until it is wrapped in a full <VAST>response.
Related vastlint rules
- VAST-3.0-progress-offset: <Tracking event="progress"> requires an offset attribute
- VAST-3.0-progress-offset-format: Tracking progress offset does not match required format
- VAST-4.1-tracking-event-value: Tracking event attribute not in the valid set for this VAST version
Related events
- start: Fires when linear playback actually begins, first frame rendered.
- firstQuartile: Fires when linear playback reaches 25 percent of Duration.
- complete: Fires when linear playback reaches the end of Duration.
Check the XML, then confirm the beacons fire
Validate the event names and containers on the document. Test a live URL when the XML is clean and reporting is still empty.