DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Fehler

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Das Fehlerereignis signalisiert, dass der Media Player auf einen Fehler gestoßen ist. Beim Verfolgen eines Fehlers wird die Sitzung nicht geschlossen. Wenn der Fehler verhindert, dass die Wiedergabe fortgesetzt wird, rufen ​ nach dem ​ „Sitzungsende“ auf.

Die errorDetails.source-Eigenschaft akzeptiert nur zwei Werte: player (Fehler, die vom Media-Player stammen) und external (Fehler von einer externen Quelle wie einem CDN oder Netzwerk).

Empfohlene Implementierungsarten

Web SDK

Rufen Sie sendEvent mit eventType: "media.error" und den erforderlichen errorDetails auf:

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

trackError mit einer Fehler-ID-Zeichenfolge aufrufen.

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

trackError mit einer Fehler-ID-Zeichenfolge aufrufen.

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

Rufen Sie sendMediaEvent mit eventType: "media.error" und den erforderlichen errorDetails auf:

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

Rufen Sie den error-Endpunkt mit dem erforderlichen errorDetails auf:

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-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

trackError mit einer Fehler-ID-Zeichenfolge aufrufen:

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

trackError mit einer Fehler-ID-Zeichenfolge aufrufen:

code language-javascript 
ADBMobile.media.trackError("media-error-001");
Media Collection API

Senden eines error POST an den events-Endpunkt:

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