createMediaSession

Der Befehl createMediaSession ist Teil der Web SDK-streamingMedia. Sie können diese Komponente verwenden, um Daten zu Mediensitzungen auf Ihrer Website zu erfassen. Informationen zum Konfigurieren dieser Komponente finden streamingMedia in der ​ ​Dokumentation).

Die erfassten Daten können Informationen zu Medienwiedergaben, Pausen, Beendigungen und anderen zugehörigen Ereignissen enthalten. Nach der Erfassung können Sie diese Daten zur Aggregation von Metriken an Adobe Analytics for Streaming Media senden. Diese Funktion bietet eine umfassende Lösung zum Tracking und zum Verständnis des Medienkonsumverhaltens auf Ihrer Website.

Sie können Mediensitzungen in Web SDK auf zwei Arten erstellen:

  • Automatisch verfolgte Mediensitzungen ermöglichen es der Web-SDK, den Versand von Medien-Ping-Ereignissen an (Adobe ​ für Streaming-Medien) ​ verwalten. Die Häufigkeit dieser Pings wird durch die Konfigurationseinstellungen der Komponente StreamingMedia bestimmt.
  • Manuell verfolgte Mediensitzungen ermöglichen Ihnen mehr Kontrolle über den Versand von Sitzungs-Ping-Ereignissen an Adobe Analytics für Streaming-Medien. Darüber hinaus haben Sie die Möglichkeit, die sessionID für Mediensitzungen zu speichern.

Erstellen einer automatisch verfolgten Mediensitzung automatic

Um das automatische Tracking einer Mediensitzung zu starten, rufen Sie die createMediaSession-Methode mit den unten beschriebenen Optionen auf:

    alloy("createMediaSession", {
        playerId: "movie-test",
        getPlayerDetails: () => {
            return {
                playhead: document.getElementById("movie-test").currentTime,
                qoeDataDetails: {
                    bitrate: 1000,
                    startupTime: 1000,
                    fps: 30,
                    droppedFrames: 10
                }
            };
        },
        xdm: {
            eventType: "media.sessionStart",
            mediaCollection: {
                sessionDetails: {
                    ...
                }
            }
        }
    });
Eigenschaft
Typ
Erforderlich
Beschreibung
playerId
Zeichenfolge
Ja
Die Player-ID, eine eindeutige Kennung, die die Mediensitzung darstellt.
getPlayerDetails
Funktion
Ja
Eine Funktion, die die Player-Details zurückgibt. Diese Rückruffunktion wird von der Web-SDK vor jedem Medienereignis für die angegebene playerId aufgerufen.
xdm.eventType
Objekt
Nein
Der Medienereignistyp. Wenn dieses Feld nicht angegeben wird, wird es automatisch auf media.sessionStart gesetzt.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Enthält Sitzungsdetaileigenschaften. Weitere Informationen finden ​ unter ​Mediensammlungsschema“.

Erstellen einer manuell verfolgten Mediensitzung manual

Um das Tracking einer Mediensitzung manuell zu starten, rufen Sie die createMediaSession-Methode mit den unten beschriebenen Optionen auf:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});
Eigenschaft
Typ
Erforderlich
Beschreibung
xdm.eventType
Objekt
Nein
Der Medienereignistyp. Wenn er nicht angegeben wird, wird er automatisch auf media.sessionStart gesetzt.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Enthält Sitzungsdetaileigenschaften. Weitere Informationen finden ​ unter ​Mediensammlungsschema“.
xdm.mediaCollection.playhead
Ganzzahl
Ja
Der aktuelle Abspielkopf.
xdm.mediaCollection.qoeDataDetails
Objekt
Nein
Details zur Qualität der Erlebnisdaten. Weitere Informationen finden ​ in der Dokumentation ​Mediensammlungsschema“.

Erstellen einer Mediensitzung mit der Tag-Erweiterung „Web SDK"

Die diesem Befehl entsprechende Web SDK-Tag-Erweiterung ist der Session start Ereignistyp innerhalb der Aktion "Send media event".

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1