DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Inhaltswiederaufnahmen

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für die Variable Inhaltswiederaufnahmen​behandelt. Siehe Inhaltswiederaufnahmen für die entsprechende Berichtsmetrik.

style
shade-box

Die Variable „Inhalt wird fortgesetzt“ kennzeichnet eine Sitzung, durch die eine zuvor unterbrochene Wiedergabe fortgesetzt wird. Legen Sie sie auf media.sessionStart fest, damit das Backend ein Ereignis Inhalt wird fortgesetzt für die Sitzung zählt und es aus den Zählungen für neue Streams ausschließt. Bei direkten API- und Edge-API-Implementierungen ist der Client dafür verantwortlich, wiederaufgenommene Sitzungen zu erkennen (z. B. nach einem Puffer, einer Pause oder einem Anhalten von mehr als 30 Minuten) und dieses Flag entsprechend festzulegen.

Eigenschaft
Wert
Kontextdatenvariable
a.media.resume
XDM-Sammlungsfeld
xdm.mediaCollection.sessionDetails.hasResume
Audience Manager-Eigenschaft
nicht angegeben
Erforderlich
Nein
Gesendet mit
Sitzungsstart

Empfohlene Implementierungsarten

Web SDK

Setzen Sie hasResume auf true in xdm.mediaCollection.sessionDetails, wenn Sie sendEvent für die wiederaufgenommene Sitzung aufrufen:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video",
        hasResume: true
      },
      playhead: 60
    }
  }
});
iOS

Übergeben Sie das Wiederaufnahme-Flag als Teil des optionalen Konfigurations-Bundles des Medienobjekts auf trackSessionStart. Verwenden Sie die MediaConstants.MediaObjectKey.RESUMED.

code language-swift 
var mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)
mediaObject?[MediaConstants.MediaObjectKey.RESUMED] = true

tracker.trackSessionStart(info: mediaObject, metadata: nil)
Android

Übergeben Sie das Wiederaufnahme-Flag als Teil des optionalen Konfigurations-Bundles des Medienobjekts auf trackSessionStart. Verwenden Sie die MediaConstants.MediaObjectKey.RESUMED.

code language-kotlin 
val mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)
mediaInfo[MediaConstants.MediaObjectKey.RESUMED] = true

tracker.trackSessionStart(mediaInfo, null)
Roku

Setzen Sie hasResume auf true in xdm.mediaCollection.sessionDetails, wenn Sie createMediaSession für die wiederaufgenommene Sitzung aufrufen:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video",
                "hasResume": true
            },
            "playhead": 60
        }
    }
})
Media Edge-API

Rufen Sie den sessionStart-Endpunkt auf, wobei hasResume auf true in xdm.mediaCollection.sessionDetails festgelegt ist:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "hasResume": true
        },
        "playhead": 60
      }
    }
  }]
}

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Legen Sie den RESUMED Schlüssel für das Medieninformationsobjekt fest, bevor Sie trackSessionStart aufrufen:

code language-javascript 
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);
mediaInfo[ADB.Media.MediaObjectKey.Resumed] = true;

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Legen Sie MediaResumed für das Medieninformationsobjekt fest, bevor Sie trackSessionStart aufrufen:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
mediaInfo[ADBMobile.media.MediaObjectKey.MediaResumed] = true;
ADBMobile.media.trackSessionStart(mediaInfo, null);
Media Collection API

Fügen Sie media.resume in das params Ihrer sessionStart POST-Anfrage ein:

code language-json 
{
  "playerTime": { "playhead": 60, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.resume": true
  }
}

Die vollständige Anfragestruktur finden Sie Referenz zur ​-API für Mediensammlungs-Sitzungen).

recommendation-more-help
media-analytics-help