Documentazione Experience Platform Guida di SDK Web

`createMediaSession`

Ultimo aggiornamento: 16 luglio 2024

Argomenti:

Creato per:

Sviluppatore

Il comando createMediaSession fa parte del componente Web SDK streamingMedia. Puoi utilizzare questo componente per raccogliere i dati relativi alle sessioni multimediali sul tuo sito web. Per informazioni su come configurare questo componente, consulta la streamingMedia documentazione.

I dati raccolti possono includere informazioni su riproduzioni multimediali, pause, completamenti e altri eventi correlati. Una volta raccolti, puoi inviare questi dati a 适用于流媒体的 Adobe Analytics per aggregare le metriche. Questa funzione fornisce una soluzione completa per il tracciamento e la comprensione del comportamento di consumo dei contenuti multimediali sul sito web.

Puoi creare sessioni multimediali in Web SDK in due modi:

Le sessioni multimediali con tracciamento automatico consentono a Web SDK di gestire l'invio di eventi ping multimediali a 适用于流媒体的 Adobe Analytics. La frequenza di questi ping è determinata dalle impostazioni di configurazione del componente streamingMedia.
Le sessioni multimediali con tracciamento manuale offrono maggiore controllo sull'invio di eventi ping di sessione a 适用于流媒体的 Adobe Analytics. È inoltre possibile archiviare sessionID per le sessioni multimediali.

Creare una sessione multimediale con tracciamento automatico

Per avviare automaticamente il tracciamento di una sessione multimediale, chiamare il metodo createMediaSession con le opzioni descritte di seguito:

    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: {
                    ...
                }
            }
        }
    });

Proprietà	Tipo	Obbligatorio	Descrizione
`playerId`	Stringa	Sì	L’ID del lettore, un identificatore univoco che rappresenta la sessione multimediale.
`getPlayerDetails`	Funzione	Sì	Funzione che restituisce i dettagli del lettore. Questa funzione di callback verrà chiamata dall'SDK Web prima di ogni evento multimediale per `playerId` fornito.
`xdm.eventType`	Oggetto	No	Il tipo di evento multimediale. Se non specificato, viene impostato automaticamente su `media.sessionStart`.
`xdm.mediaCollection.sessionDetails`	Oggetto	Sì	L’oggetto dei dettagli della sessione. L'oggetto `sessionDetails` deve contenere le proprietà dei dettagli della sessione. Per ulteriori informazioni, consulta la documentazione dello schema Media Collection.

Creare una sessione multimediale tracciata manualmente

Per avviare manualmente il tracciamento di una sessione multimediale, chiamare il metodo createMediaSession con le opzioni descritte di seguito:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});

Proprietà	Tipo	Obbligatorio	Descrizione
`xdm.eventType`	Oggetto	No	Il tipo di evento multimediale. Se non specificato, viene automaticamente impostato su `media.sessionStart`.
`xdm.mediaCollection.sessionDetails`	Oggetto	Sì	L’oggetto dei dettagli della sessione. L'oggetto `sessionDetails` deve contenere le proprietà dei dettagli della sessione. Per ulteriori informazioni, consulta la documentazione dello schema Media Collection.
`xdm.mediaCollection.playhead`	Intero	Sì	La testina di riproduzione corrente.
`xdm.mediaCollection.qoeDataDetails`	Oggetto	No	La qualità dei dettagli dei dati sull’esperienza. Per ulteriori informazioni, consulta la documentazione dello schema Media Collection.

recommendation-more-help