DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Sitzungsende

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Das Sitzungsende-Ereignis schließt eine Medienverfolgungssitzung sofort und unwiderruflich. Sitzungsende ist ein harter Abschluss. Nach dem Versand wird die Sitzung beendet und es können keine weiteren Ereignisse darunter verfolgt werden. Verwenden Sie Sitzungsende nur, wenn Sie sicher sind, dass keine zusätzlichen Ereignisse folgen werden, z. B. wenn der Player zerstört oder die Seite entladen wird. In den meisten Fällen ist es sicherer, die Sitzung auf natürliche Weise ablaufen zu lassen, anstatt zu riskieren, Ereignisse abzuschneiden, die noch eintreffen könnten. Wenn der Viewer den Inhalt fertig gestellt hat, rufen Sie stattdessen Sitzung abgeschlossen auf.

Ohne explizites Sitzungsende wird eine Sitzung automatisch nach 10 Minuten ohne Ereignisse oder 30 Minuten ohne Abspielkopfbewegung geschlossen.

NOTE
Sie können Sitzungsende sicher mehrmals für dieselbe Sitzung aufrufen. Das Backend schließt die Sitzung beim ersten Ereignis und löscht alle nachfolgenden Ereignisse für diese Sitzungs-ID, einschließlich eines zweiten Sitzungsendes, im Hintergrund. Sie müssen sich nicht vor doppelten Aufrufen in Race-Bedingungen schützen, wie z. B. einem 30-Minuten-Timeout, das in dem Moment abläuft, in dem der Viewer den Player schließt.

Empfohlene Implementierungsarten

Web SDK

sendEvent mit eventType: "media.sessionEnd":

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

Rufen Sie trackSessionEnd auf, wenn der Viewer den Player schließt oder wegnavigiert.

code language-swift 
tracker.trackSessionEnd()
Android

Rufen Sie trackSessionEnd auf, wenn der Viewer den Player schließt oder wegnavigiert.

code language-kotlin 
tracker.trackSessionEnd()
Roku

sendMediaEvent mit eventType: "media.sessionEnd":

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

Rufen Sie den sessionEnd-Endpunkt auf:

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

Media SDK JS 3.x

Rufen Sie trackSessionEnd auf, wenn der Viewer den Player schließt oder wegnavigiert:

code language-javascript 
tracker.trackSessionEnd();
Chromecast

Rufen Sie trackSessionEnd auf, wenn der Viewer den Player schließt oder wegnavigiert:

code language-javascript 
ADBMobile.media.trackSessionEnd();
Media Collection API

Senden Sie einen sessionEnd POST an den events-Endpunkt:

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