createMediaSession

Kommandot createMediaSession är en del av Web SDK streamingMedia -komponenten. Du kan använda den här komponenten för att samla in data relaterade till mediesessioner på din webbplats. Mer information om hur du konfigurerar den här komponenten finns i streamingMedia documentation.

De insamlade data kan innehålla information om medieuppspelningar, pauser, slutföranden och andra relaterade händelser. När de har samlats in kan du skicka dessa data till Adobe Analytics per contenuti in streaming för att samla in mätvärden. Den här funktionen är en heltäckande lösning för att spåra och förstå hur medieanvändningen fungerar på din webbplats.

Du kan skapa mediesessioner i Web SDK på två sätt:

Skapa en automatiskt spårad mediesession automatic

Om du vill börja spåra en mediesession automatiskt anropar du metoden createMediaSession med alternativen som beskrivs nedan:

    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: {
                    ...
                }
            }
        }
    });
Egenskap
Typ
Obligatoriskt
Beskrivning
playerId
Sträng
Ja
Spelar-ID, en unik identifierare som representerar mediesessionen.
getPlayerDetails
Funktion
Ja
En funktion som returnerar spelarinformationen. Den här återanropsfunktionen anropas av Web SDK innan varje mediahändelse för playerId som anges.
xdm.eventType
Objekt
Nej
Mediehändelsetypen. Om det inte anges ställs den automatiskt in på media.sessionStart.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Sessionsinformationsobjektet. Objektet sessionDetails ska innehålla egenskaper för sessionsinformation. Mer information finns i dokumentationen för Media Collection-schemat.

Skapa en manuellt spårad mediesession manual

Om du vill börja spåra en mediesession manuellt anropar du metoden createMediaSession med alternativen som beskrivs nedan:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});
Egenskap
Typ
Begärd
Beskrivning
xdm.eventType
Objekt
Nej
Mediehändelsetypen. Om den inte anges anges den automatiskt till media.sessionStart.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Sessionsinformationsobjektet. Objektet sessionDetails ska innehålla egenskaper för sessionsinformation. Mer information finns i dokumentationen för Media Collection-schemat.
xdm.mediaCollection.playhead
Heltal
Ja
Aktuellt spelhuvud.
xdm.mediaCollection.qoeDataDetails
Objekt
Nej
Kvaliteten på upplevelsedatainformationen. Mer information finns i dokumentationen för Media Collection-schemat.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636