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 in der streamingMediaDokumentation).

Die erfassten Daten können Informationen zu Medienwiedergaben, Pausen, Beendigungen und anderen zugehörigen Ereignissen enthalten. Nach der Erfassung können Sie diese Daten an Adobe Analytics für Streaming-Medien senden, um Metriken zu aggregieren. 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:

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 dies nicht angegeben wird, wird dies automatisch auf media.sessionStart gesetzt.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Das Sitzungsdetailobjekt. Das sessionDetails-Objekt sollte die Eigenschaften der Sitzungsdetails enthalten. Weitere Informationen finden in der DokumentationMediensammlungsschema“.

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
Das Sitzungsdetailobjekt. Das sessionDetails-Objekt sollte die Eigenschaften der Sitzungsdetails enthalten. Weitere Informationen finden in der DokumentationMediensammlungsschema“.
xdm.mediaCollection.playhead
Ganzzahl
Ja
Der aktuelle Abspielkopf.
xdm.mediaCollection.qoeDataDetails
Objekt
Nein
Details zur Qualität der Erlebnisdaten. Weitere Informationen finden in der DokumentationMediensammlungsschema“.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636