DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Stream-Format

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

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

style
shade-box

Die Variable „stream format“ identifiziert die Qualitätsstufe des Streams (normalerweise "HD" oder "SD", aber jede Zeichenfolge wird akzeptiert). Legen Sie ihn fest, wenn Sie Interaktionen, den Abschluss oder die Qualität nach Versandqualitätsstufe unterbrechen möchten.

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

Empfohlene Implementierungsarten

Web SDK

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

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

Übergeben Sie das Stream-Format als Metadatenschlüssel im HashMap-Argument an trackSessionStart. Verwenden Sie MediaConstants.VideoMetadataKeys.STREAM_FORMAT.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.STREAM_FORMAT] = "HD"

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

Übergeben Sie das Stream-Format als Metadatenschlüssel im HashMap-Argument an trackSessionStart. Verwenden Sie MediaConstants.VideoMetadataKeys.STREAM_FORMAT.

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

tracker.trackSessionStart(mediaInfo, metadata)
Roku Edge

Verwenden Sie createMediaSession, um streamFormat in sessionDetails festzulegen:

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

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie das Stream-Format mithilfe von ADB.Media.VideoMetadataKeys.StreamFormat in das contextData-Objekt:

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

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Verwenden Sie ADBMobile.media.VideoMetadataKeys.STREAM_FORMAT , um das Stream-Format 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.STREAM_FORMAT] = "HD";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
Roku 2.x

Verwenden Sie MEDIA_VideoMetadataKeySTREAM_FORMAT , um das Stream-Format in den Standardmetadaten des Medienobjekts festzulegen, bevor Sie mediaTrackSessionStart aufrufen:

code language-brightscript 
adb = ADBMobile()
mediaInfo = adb_media_init_mediainfo("My Video", "video-123", 128.0, adb.MEDIA_STREAM_TYPE_VOD, adb.MEDIA_TYPE_VIDEO)

standardMetadata = {}
standardMetadata[adb.MEDIA_VideoMetadataKeySTREAM_FORMAT] = "HD"
mediaInfo[adb.MEDIA_STANDARD_MEDIA_METADATA] = standardMetadata

adb.mediaTrackSessionStart(mediaInfo, invalid)
Media Collection API

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

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

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

recommendation-more-help
media-analytics-help