DocumentaciónExperience PlatformRecopilación de datos

createMediaSession

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador

El comando createMediaSession forma parte del componente streamingMedia de Web SDK. Puede utilizar este componente para recopilar datos relacionados con las sesiones de contenido en el sitio web. Consulte la streamingMedia documentación para obtener información sobre cómo configurar este componente.

Los datos recopilados pueden incluir información sobre reproducciones de contenido, pausas, finalizaciones y otros eventos relacionados. Una vez recopilados, puede enviar estos datos a Adobe Analytics para medios de streaming para agregar métricas. Esta función proporciona una solución completa para realizar el seguimiento y comprender el comportamiento del consumo de medios en el sitio web.

Puede crear sesiones de contenido en Web SDK de dos formas:

  • Las sesiones multimedia rastreadas automáticamente permiten que Web SDK administre el envío de eventos de ping de medios a Adobe Analytics para medios de streaming. La frecuencia de estos pings está determinada por la configuración del componente streamingMedia.
  • Las sesiones de medios rastreadas manualmente le proporcionan más control sobre el envío de eventos de ping de sesión a Adobe Analytics para medios de streaming. Además, tiene la capacidad de almacenar sessionID para sesiones multimedia.

Crear una sesión multimedia rastreada automáticamente automatic

Para iniciar el seguimiento de una sesión multimedia automáticamente, llame al método createMediaSession con las opciones que se describen a continuación:

    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: {
                    ...
                }
            }
        }
    });
Propiedad
Tipo
Requerido
Descripción
playerId
Cadena
Sí
El ID del reproductor, un identificador único que representa la sesión de contenido.
getPlayerDetails
Función
Sí
Una función que devuelve los detalles del reproductor. Web SDK llamará a esta función de devolución de llamada antes de cada evento multimedia para playerId proporcionado.
xdm.eventType
Objeto
No
El tipo de evento de medios. Si no se proporciona, este campo se establece automáticamente en media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
Sí
Contiene propiedades de detalles de la sesión. Consulte Esquema de recopilación de medios para obtener más información.

Creación de una sesión multimedia rastreada manualmente manual

Para iniciar el seguimiento de una sesión multimedia manualmente, llame al método createMediaSession con las opciones que se describen a continuación:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});
Propiedad
Tipo
Obligatorio
Descripción
xdm.eventType
Objeto
No
El tipo de evento de medios. Si no se proporciona, se establece automáticamente en media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
Sí
Contiene propiedades de detalles de la sesión. Consulte Esquema de recopilación de medios para obtener más información.
xdm.mediaCollection.playhead
Entero
Sí
El cabezal de reproducción actual.
xdm.mediaCollection.qoeDataDetails
Objeto
No
La calidad de los detalles de los datos de experiencia. Consulte la documentación del esquema de recopilación de medios para obtener más información.

Creación de una sesión de medios con la extensión de etiquetas Web SDK

La extensión de etiquetas Web SDK equivalente a este comando es el tipo de evento Session start dentro de la acción 'Send media event'.

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