DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Abgelegte Frames

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für die Variable Dropped Frames​behandelt. Siehe Abgelegte Frames für die entsprechende Reporting-Dimension und -Metrik.

style
shade-box

Die Variable Abgelegte Frames ist die laufende Anzahl an Frames, die der Player während der Sitzung abgelegt hat. Legen Sie ihn auf das QoE-Objekt fest und aktualisieren Sie den Wert, wenn der Player neue Abbrüche meldet. Das Backend meldet den neuesten Wert zum Sitzungsende.

NOTE
Übergeben Sie immer die kumulative Summe der ausgelassenen Frames für die gesamte Sitzung bis zu diesem Punkt, nicht pro Intervall-Delta. Wenn Sie den Wert zwischen Aktualisierungen auf 0 zurücksetzen, erhält das Backend 0 als endgültigen Wert und meldet null abgelegte Frames für die Sitzung, unabhängig davon, was zuvor tatsächlich abgelegt wurde.
Eigenschaft
Wert
Kontextdatenvariable
a.media.qoe.droppedFrameCount
XDM-Sammlungsfeld
xdm.mediaCollection.qoeDataDetails.droppedFrames
Audience Manager-Eigenschaft
c_contextdata.a.media.qoe.droppedFrameCount
Erforderlich
Nein
Gesendet mit
Qualitätsereignisse (Bitratenänderung, Pufferstart, Fehler), Sitzungsschluss

Empfohlene Implementierungsarten

Web SDK

droppedFrames in xdm.mediaCollection.qoeDataDetails festlegen, wenn sendEvent aufgerufen wird:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.bitrateChange",
    mediaCollection: {
      qoeDataDetails: {
        bitrate: 3200,
        droppedFrames: 3
      },
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Übergeben Sie abgelegte Frames als viertes Argument an createQoEObject. Aktualisieren Sie den Tracker, bevor ein Qualitätsereignis ausgelöst wird.

code language-swift 
let qoeObject = Media.createQoEObjectWith(bitrate: 3200,
                                       startupTime: 0,
                                               fps: 24,
                                     droppedFrames: 3)

tracker.updateQoEObject(qoe: qoeObject)
Android

Übergeben Sie abgelegte Frames als viertes Argument an createQoEObject. Aktualisieren Sie den Tracker, bevor ein Qualitätsereignis ausgelöst wird.

code language-kotlin 
val qoeObject = Media.createQoEObject(3200L,
                                      0.0,
                                      24.0,
                                      3L)

tracker.updateQoEObject(qoeObject)
Roku

droppedFrames in xdm.mediaCollection.qoeDataDetails festlegen, wenn sendMediaEvent aufgerufen wird:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.bitrateChange",
        "mediaCollection": {
            "qoeDataDetails": {
                "bitrate": 3200,
                "droppedFrames": 3
            },
            "playhead": 90
        }
    }
})
Media Edge-API

Rufen Sie den bitrateChange-Endpunkt mit droppedFrames in xdm.mediaCollection.qoeDataDetails auf:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.bitrateChange",
      "mediaCollection": {
        "qoeDataDetails": {
          "droppedFrames": 3
        },
        "sessionID": "{sid}",
        "playhead": 90
      }
    }
  }]
}

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie abgelegte Frames als viertes Argument an ADB.Media.createQoEObject:

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(3200, 0, 24, 3);
tracker.updateQoEObject(qoeObject);
Chromecast

Übergeben Sie die kumulative Dropped-Frame-Anzahl als viertes Argument, um den Tracker zu ADBMobile.media.createQoSObject und zu aktualisieren:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate
  0,     // startupTime
  24,    // fps
  0      // droppedFrames (cumulative total)
);
ADBMobile.media.updateQoSObject(qosInfo);
Media Collection API

media.qoe.droppedFrames in das params einschließen:

code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523820000 },
  "eventType": "bitrateChange",
  "params": {
    "media.qoe.droppedFrames": 3
  }
}

Die vollständige Anfragestruktur ​ Sie in der ​ zur Mediensammlungs-API-Ereignisreferenz .

recommendation-more-help
media-analytics-help