DocumentationAnalyticsStreaming media services guide

Error

Last update: June 8, 2026

CREATED FOR:

  • Developer

The error event signals that the media player encountered an error. Tracking an error does not close the session. If the error prevents playback from continuing, call Session end after the error event.

The errorDetails.source property accepts only two values: player (errors originating in the media player) and external (errors from an outside source such as a CDN or network).

Web SDK

Call sendEvent with eventType: "media.error" and the required errorDetails:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.error",
    mediaCollection: {
      errorDetails: {
        name: "media-error-001",
        source: "player"
      },
      sessionID: "{sid}",
      playhead: 45
    }
  }
});
iOS

Call trackError with an error ID string.

code language-swift 
tracker.trackError(errorId: "media-error-001")
Android

Call trackError with an error ID string.

code language-kotlin 
tracker.trackError("media-error-001")
Roku Edge

Call sendMediaEvent with eventType: "media.error" and the required errorDetails:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.error",
        "mediaCollection": {
            "errorDetails": {
                "name": "media-error-001",
                "source": "player"
            },
            "playhead": 45
        }
    }
})
Media Edge API

Call the error endpoint with the required errorDetails:

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

Legacy implementation types (Analytics-only)

Media SDK JS 3.x

Call trackError with an error ID string:

code language-javascript 
tracker.trackError("media-error-001");
Chromecast

Call trackError with an error ID string:

code language-javascript 
ADBMobile.media.trackError("media-error-001");
Roku 2.x

Call mediaTrackError with an error ID and the error source. Use the ERROR_SOURCE_PLAYER constant for player errors:

code language-brightscript 
adb = ADBMobile()
adb.mediaTrackError("media-error-001", adb.ERROR_SOURCE_PLAYER)
Media Collection API

Send an error POST to the events endpoint:

code language-json 
{
  "playerTime": { "playhead": 45, "ts": 1699523820000 },
  "eventType": "error",
  "params": {
    "media.errorId": "media-error-001",
    "media.errorSource": "player"
  }
}
recommendation-more-help
media-analytics-help