DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Folge

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für die Variable Episode​behandelt. Siehe Folge für die entsprechende Reporting-Dimension.

style
shade-box

Die Episodenvariable ist die Episodennummer innerhalb der Staffel (in der Regel eine ganze Zahl wie "13"). Kombinieren Sie mit Show und Staffel, damit die Interaktion nach einzelnen Episoden unterbrochen werden kann.

Eigenschaft
Wert
Kontextdatenvariable
a.media.episode
XDM-Sammlungsfeld
xdm.mediaCollection.sessionDetails.episode
Audience Manager-Eigenschaft
c_contextdata.a.media.episode
Erforderlich
Nein
Gesendet mit
Sitzungsstart, Sitzung schließen

Empfohlene Implementierungsarten

Web SDK

episode in xdm.mediaCollection.sessionDetails festlegen, wenn sendEvent aufgerufen wird:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        episode: "13"
      },
      playhead: 0
    }
  }
});
iOS

Übergeben Sie die Folgenummer als Metadatenschlüssel im HashMap-Argument an trackSessionStart. Verwenden Sie MediaConstants.VideoMetadataKeys.EPISODE.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.EPISODE] = "13"

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

Übergeben Sie die Folgenummer als Metadatenschlüssel im HashMap-Argument an trackSessionStart. Verwenden Sie MediaConstants.VideoMetadataKeys.EPISODE.

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.EPISODE] = "13"

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Verwenden Sie createMediaSession, um episode in sessionDetails festzulegen:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "episode": "13"
            },
            "playhead": 0
        }
    }
})
Media Edge-API

Rufen Sie den sessionStart-Endpunkt mit episode in xdm.mediaCollection.sessionDetails auf:

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie die Folge mithilfe von ADB.Media.VideoMetadataKeys.Episode an das contextData:

code language-javascript 
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.Episode] = "13";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Verwenden Sie ADBMobile.media.VideoMetadataKeys.EPISODE , um die Folgenummer in der StandardMediaMetadata-Eigenschaft des Medienobjekts festzulegen, 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);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.EPISODE] = "13";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
Media Collection API

media.episode in das params einschließen:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.episode": "13"
  }
}

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

recommendation-more-help
media-analytics-help