DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Vollbild

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für den Player Status „Vollbild​behandelt. Siehe Vom Vollbildmodus betroffene Streams, Vollbildanzahl und Gesamtdauer des Vollbildmodus für die entsprechenden Berichtsmetriken.

style
shade-box

Der Status des Vollbild-Players verfolgt, wann der Viewer die Vollbild-Wiedergabe betritt und verlässt. Löst ein Statusstartereignis aus, wenn der Viewer in den Vollbildmodus wechselt, und löst ein Statusendereignis aus, wenn der Viewer beendet wird. Das Backend berechnet drei Metriken aus diesen Ereignissen: betroffene Streams, Anzahl der Statuseinträge und Gesamtzeit im Status.

Eigenschaft
Wert
Kontextdatenvariablen
a.media.states.fullscreen.set, a.media.states.fullscreen.count, a.media.states.fullscreen.time
XDM-Sammlungsfeld
xdm.mediaCollection.statesStart[] und xdm.mediaCollection.statesEnd[] (Einträge mit name: "fullscreen")
Audience Manager-Eigenschaften
c_contextdata.a.media.states.fullscreen.set, c_contextdata.a.media.states.fullscreen.count, c_contextdata.a.media.states.fullscreen.time
Erforderlich
Nein
Gesendet mit
State start, state end

Empfohlene Implementierungsarten

Web SDK

Verwenden Sie sendEvent , um ein media.statesUpdate-Ereignis mit dem Status zu senden, der statesStart hinzugefügt wurde:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.statesUpdate",
    mediaCollection: {
      statesStart: [{ name: "fullscreen" }],
      sessionID: "{sid}",
      playhead: 60
    }
  }
});

Wenn der Viewer den Vollbildmodus beendet, senden Sie ein weiteres Ereignis mit dem Status in statesEnd:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.statesUpdate",
    mediaCollection: {
      statesEnd: [{ name: "fullscreen" }],
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Verwenden Sie tracker.trackPlayerStateStart() und tracker.trackPlayerStateEnd() mit der MediaConstants.PlayerState.FULLSCREEN.

code language-swift 
let stateObject = Media.createStateObjectWith(stateName: MediaConstants.PlayerState.FULLSCREEN)

tracker.trackPlayerStateStart(info: stateObject)
// ...later, when the user exits full-screen:
tracker.trackPlayerStateEnd(info: stateObject)
Android

Verwenden Sie tracker.trackPlayerStateStart() und tracker.trackPlayerStateEnd() mit der MediaConstants.PlayerState.FULLSCREEN.

code language-kotlin 
val stateObject = Media.createStateObject(MediaConstants.PlayerState.FULLSCREEN)

tracker.trackPlayerStateStart(stateObject)
// ...later, when the user exits full-screen:
tracker.trackPlayerStateEnd(stateObject)
Roku

Verwenden Sie sendMediaEvent , um ein media.statesUpdate-Ereignis mit dem Status zu senden, der statesStart hinzugefügt wurde:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.statesUpdate",
        "mediaCollection": {
            "statesStart": [{ "name": "fullscreen" }],
            "playhead": 60
        }
    }
})

Wenn der Viewer den Vollbildmodus beendet, senden Sie ein weiteres Ereignis mit dem Status in statesEnd:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.statesUpdate",
        "mediaCollection": {
            "statesEnd": [{ "name": "fullscreen" }],
            "playhead": 90
        }
    }
})
Media Edge-API

Rufen Sie den statesUpdate-Endpunkt mit fullscreen in statesStart auf (oder statesEnd, wenn der Viewer beendet wird):

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.statesUpdate",
      "mediaCollection": {
        "statesStart": [{ "name": "fullscreen" }],
        "sessionID": "{sid}",
        "playhead": 60
      }
    }
  }]
}

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Verwenden Sie ADB.Media.createStateObject und die ADB.Media.PlayerState.FullScreen Konstante:

code language-javascript 
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.FullScreen);

tracker.trackPlayerStateStart(stateObject);
// ...later, when the user exits full-screen:
tracker.trackPlayerStateEnd(stateObject);
Chromecast

Verwenden Sie ADBMobile.media.createStateObject direkt mit der "fullscreen" Zeichenfolge, da Chromecast keine benannten PlayerState enthält:

code language-javascript 
var stateObject = ADBMobile.media.createStateObject("fullscreen");
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateStart, stateObject);
// When the user exits full-screen:
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateEnd, stateObject);
Media Collection API

Senden Sie eine stateStart POST-Anfrage, wenn der Betrachter in den Vollbildmodus wechselt, und einen stateEnd POST, wenn er den Vorgang beendet:

code language-json 
{
  "playerTime": { "playhead": 60, "ts": 1699523820000 },
  "eventType": "stateStart",
  "params": {
    "media.state.name": "fullscreen"
  }
}
code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523850000 },
  "eventType": "stateEnd",
  "params": {
    "media.state.name": "fullscreen"
  }
}

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

recommendation-more-help
media-analytics-help