DocumentaciónAnalyticsGuía de servicios de medios de streaming

Tiempo para el inicio

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Tiempo para el inicio. Ver Tiempo para el inicio para la dimensión y métrica de informes correspondiente.

style
shade-box

La variable tiempo para el inicio es el tiempo, en milisegundos, transcurrido entre el momento en que el reproductor inicia la reproducción y el primer procesamiento del fotograma. Configúrelo en el objeto QoE antes de que se active el evento de inicio de sesión. Adobe almacena e informa del valor en segundos; pasa milisegundos y Adobe se convierte en el momento de la ingesta.

IMPORTANT
Una vez que el reproductor comience a procesar fotogramas de contenido, deje de actualizar timeToStart. El valor puede aumentar durante la fase inicial de almacenamiento en búfer o de carga, pero debe tratarse como fijo desde el momento en que comienza la reproducción. Si continúa actualizándolo después de que el primer fotograma se procese, se producirá una métrica Tiempo para el inicio inflada o incorrecta.
Propiedad
Valor
Variable de datos de contexto
a.media.qoe.timeToStart
Campo de colección XDM
xdm.mediaCollection.qoeDataDetails.timeToStart
rasgo de Audience Manager
c_contextdata.a.media.qoe.timeToStart
Requerido
No
Enviado con
Inicio de sesión, cierre de sesión

Tipos de implementación recomendados

SDK web

Establecer timeToStart dentro de xdm.mediaCollection.qoeDataDetails en media.sessionStart al llamar a sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      qoeDataDetails: {
        timeToStart: 30000
      },
      playhead: 0
    }
  }
});
iOS

Pasar el tiempo de inicio como segundo argumento (startupTime) a createQoEObject.

code language-swift 
let qoeObject = Media.createQoEObjectWith(bitrate: 3200,
                                       startupTime: 30000,
                                               fps: 24,
                                     droppedFrames: 0)

tracker.updateQoEObject(qoe: qoeObject)
Android

Pasar el tiempo de inicio como segundo argumento (startupTime) a createQoEObject.

code language-kotlin 
val qoeObject = Media.createQoEObject(3200L,
                                      30000.0,
                                      24.0,
                                      0L)

tracker.updateQoEObject(qoeObject)
Roku

Establecer timeToStart dentro de xdm.mediaCollection.qoeDataDetails en media.sessionStart al llamar a createMediaSession:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "qoeDataDetails": {
                "timeToStart": 30000
            },
            "playhead": 0
        }
    }
})
API de Media Edge

Llame al extremo sessionStart con timeToStart dentro de xdm.mediaCollection.qoeDataDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports"
        },
        "qoeDataDetails": {
          "timeToStart": 30000
        },
        "playhead": 0
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase el tiempo para comenzar como el segundo argumento a ADB.Media.createQoEObject:

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(3200, 30000, 24, 0);
tracker.updateQoEObject(qoeObject);
Chromecast

Pase el tiempo de inicio en milisegundos como segundo argumento (startupTime) a ADBMobile.media.createQoSObject y actualice el rastreador:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,   // bitrate
  0,      // startupTime (ms)
  24,     // fps
  0       // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
API de recopilación de medios

Incluir media.qoe.timeToStart en el objeto params en sessionStart:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.qoe.timeToStart": 30000
  }
}

Consulte la referencia de sesiones de la API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help