Errors
The ad tag validator will report errors, including:
- All VAST/VPAID-specific errors:
- Events firing out of sequence, for example, in VPAID, when the AdVideoStart event fires before the AdStarted event, or when the AdImpression event fires before the AdStarted event.
- Play/Pause events not being handled properly
- Video progress events (for example, in VPAID, AdVideoFirstQuartile) not firing or firing out of order.
- All player-specific errors
- All ad tag-specific errors
Note that the ad tag validator can throw multiple errors that reflect the same violation as reported by the tag and the player.
About VAST/VPAID Sequence Errors
In addition to checking out the presence or absence of expected events, you also want to check that ad events and function calls are firing in the appropriate order.
VAST Sequences
In general, VAST function calls and events should occur in the following sequence:
- handshakeVersion (method called by the player)
- initAd: "AdLoaded" (an ad event)
- startAd: "AdStarted" (an ad event)
- "AdImpression" (an ad event)
- "AdVideoStart" (an ad event)
- "AdVideoFirstQuartile" (an ad event)
- "AdVideoMidpoint" (an ad event)
- "AdVideoThirdQuartile" (an ad event)
- "AdVideoComplete"(an ad event)
- stopAd: "AdStopped" (an ad event)
For more information about VAST ad event sequencing, see page 7 of the IAB Digital Video Ad Serving Template (VAST)
VPAID Sequences
In general, VPAID function calls and events should occur in the following sequence:
- handshakeVersion (method called by the player)
- initAd: "AdLoaded" (an ad event)
- startAd: "AdStarted" (an ad event)
- "AdImpression" (an ad event)
- "AdVideoStart" (an ad event)
- "AdVideoFirstQuartile" (an ad event)
- "AdVideoMidpoint" (an ad event)
- "AdVideoThirdQuartile" (an ad event)
- "AdVideoComplete"(an ad event)
- stopAd: "AdStopped" (an ad event)
For more information about VPAID ad event sequencing, see section 4.10 (page 17) of the IAB Video Player-Ad Interface Definition (VPAID)