DocumentationAnalyticsStreaming media services guide

Session end

Last update: June 8, 2026

CREATED FOR:

  • Developer

The session end event immediately and irreversibly closes a media tracking session. Session end is a hard close; once sent, the session is terminated and no further events can be tracked under it. Only use Session end when you are certain that no additional events will follow, such as when the player is destroyed or the page is unloaded. In most cases it is safer to allow the session to expire naturally rather than risk cutting off events that might still arrive. If the viewer finishes the content, call Session complete instead.

Without an explicit session end, a session closes automatically after 10 minutes of no events or 30 minutes of no playhead movement.

NOTE
You can safely call Session end more than once for the same session. The backend closes the session on the first event and silently drops all subsequent events for that session ID, including a second Session end. You do not need to guard against duplicate calls in race conditions such as a 30-minute timeout expiring at the same moment the viewer closes the player.
Web SDK

Call sendEvent with eventType: "media.sessionEnd":

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

Call trackSessionEnd when the viewer closes the player or navigates away.

code language-swift 
tracker.trackSessionEnd()
Android

Call trackSessionEnd when the viewer closes the player or navigates away.

code language-kotlin 
tracker.trackSessionEnd()
Roku Edge

Call sendMediaEvent with eventType: "media.sessionEnd":

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

Call the sessionEnd endpoint:

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

Legacy implementation types (Analytics-only)

Media SDK JS 3.x

Call trackSessionEnd when the viewer closes the player or navigates away:

code language-javascript 
tracker.trackSessionEnd();
Chromecast

Call trackSessionEnd when the viewer closes the player or navigates away:

code language-javascript 
ADBMobile.media.trackSessionEnd();
Roku 2.x

Call mediaTrackSessionEnd when the viewer closes the player or navigates away:

code language-brightscript 
ADBMobile().mediaTrackSessionEnd()
Media Collection API

Send a sessionEnd POST to the events endpoint:

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