DocumentationAnalyticsStreaming media services guide

Chapter skip

Last update: May 28, 2026

CREATED FOR:

  • Developer

The chapter skip event signals that the viewer skipped a chapter before it finished. Send it when the viewer navigates past the chapter boundary without watching it to completion. Send Chapter complete if the chapter plays to its end.

Web SDK

Call sendEvent with eventType: "media.chapterSkip":

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.chapterSkip",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 60
    }
  }
});
iOS

Call trackEvent with the ChapterSkip event type.

code language-swift 
tracker.trackEvent(event: MediaEvent.ChapterSkip, info: nil, metadata: nil)
Android

Call trackEvent with the ChapterSkip event type.

code language-kotlin 
tracker.trackEvent(Media.Event.ChapterSkip, null, null)
Roku

Call sendMediaEvent with eventType: "media.chapterSkip":

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.chapterSkip",
        "mediaCollection": {
            "playhead": 60
        }
    }
})
Media Edge API

Call the chapterSkip endpoint:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/chapterSkip?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.chapterSkip",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 60
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Legacy implementation types (Analytics-only)

Media SDK JS 3.x

Call trackEvent with the ChapterSkip event type:

code language-javascript 
tracker.trackEvent(ADB.Media.Event.ChapterSkip, null, null);
Chromecast

Call trackEvent with the ChapterSkip event type:

code language-javascript 
ADBMobile.media.trackEvent(ADBMobile.media.Event.ChapterSkip);
Media Collection API

Send a chapterSkip POST to the events endpoint:

code language-json 
{
  "playerTime": { "playhead": 60, "ts": 1699523820000 },
  "eventType": "chapterSkip"
}
recommendation-more-help
media-analytics-help