Consider the scenario of a pre-roll ad playing before main VOD content. Which scenario should events be fired? Should TrackPlay come before TrackAdStartBreak or after the ad break is over? In one spot the docs say TrackPlay comes on the users 'intent' to play the video, and another place it says that TrackPlay should be fired on the first rendered frame of the main content. Which is it?
When should the trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo); and trackEvent(MediaHeartbeat.Event.AdStart, adObject, adCustomMetadata); be sent? Should they be sent only on successful AD playback starting, i.e. the firstFrame of the ad being played? Or when the ad request goes out, response returned, etc. The JW player has events for the entire lifecycle of ads, Ad Break Started, Ad Request, Ad Response Received, AdPlaying, AdComplete, AdBreakComplete and I'm trying to figure out how to map the JW Player Ad events to the Adobe Heartbeat events.
Outside of what the docs say (Measuring video in Analytics), You are welcome to be the judge on when certain events are called. What would be more valuable in tracking an event going in one place or another?
Whatever you decide, you'll simply want to make sure your decision is documented so users will be able to distinguish any potential discrepancies.