DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Staffel

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

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

style
shade-box

Die Staffelvariable ist die Staffelnummer für die Sendung (normalerweise eine ganze Zahl wie "2"). Legen Sie ihn für Inhalte fest, die Teil einer Serie sind, damit die Interaktion nach Saison unterbrochen werden kann. Kombinieren Sie mit Sendung und Episode für vollen episodischen Kontext.

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

Empfohlene Implementierungsarten

Web SDK

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

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

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

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.SEASON] = "2"

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

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

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

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Verwenden Sie createMediaSession, um season in sessionDetails festzulegen:

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

Rufen Sie den sessionStart-Endpunkt mit season 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",
          "season": "2"
        },
        "playhead": 0
      }
    }
  }]
}

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie die Saison im contextData mit ADB.Media.VideoMetadataKeys.Season:

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

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Verwenden Sie ADBMobile.media.VideoMetadataKeys.SEASON, um die Saisonnummer 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.SEASON] = "2";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
Media Collection API

media.season in das params einschließen:

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

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

recommendation-more-help
media-analytics-help