DocumentaciónAnalyticsGuía de servicios de medios de streaming

Velocidad de bits

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Velocidad de bits. Vea Velocidad de bits promedio (dimensión) y Velocidad de bits promedio (métrica) para las variables de informes correspondientes.

style
shade-box

La variable de velocidad de bits es la velocidad de bits de reproducción actual, en kilobits por segundo. Configúrelo en el objeto QoE siempre que el reproductor negocie una velocidad de bits y actualice el objeto QoE cuando esta cambie. El servidor usa valores de velocidad de bits para calcular Velocidad de bits promedio, la dimensión por bloque de velocidad de bits y la métrica Cambios de velocidad de bits.

Propiedad
Valor
Variable de datos de contexto
a.media.qoe.bitrateAverageBucket
Campo de colección XDM
xdm.mediaCollection.qoeDataDetails.bitrate
rasgo de Audience Manager
c_contextdata.a.media.qoe.bitrateAverageBucket
Requerido
No
Enviado con
Eventos de calidad (cambio de velocidad de bits, inicio del búfer, error), cierre de sesión

Tipos de implementación recomendados

SDK web

Establecer bitrate dentro de xdm.mediaCollection.qoeDataDetails en media.bitrateChange (o cualquier evento relacionado con la calidad) al llamar a sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.bitrateChange",
    mediaCollection: {
      qoeDataDetails: {
        bitrate: 3200,
        droppedFrames: 0,
        framesPerSecond: 24,
        timeToStart: 0
      },
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Pase la velocidad de bits como primer argumento a createQoEObject. Actualice el objeto QoE en el rastreador antes de que se active cualquier evento de calidad.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Pase la velocidad de bits como primer argumento a createQoEObject. Actualice el objeto QoE en el rastreador antes de que se active cualquier evento de calidad.

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

tracker.updateQoEObject(qoeObject)
Roku

Establecer bitrate dentro de xdm.mediaCollection.qoeDataDetails al llamar a sendMediaEvent para eventos de calidad como media.bitrateChange:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.bitrateChange",
        "mediaCollection": {
            "qoeDataDetails": {
                "bitrate": 3200,
                "droppedFrames": 0,
                "framesPerSecond": 24,
                "timeToStart": 0
            },
            "playhead": 90
        }
    }
})
API de Media Edge

Llame al extremo bitrateChange con bitrate dentro de xdm.mediaCollection.qoeDataDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.bitrateChange",
      "mediaCollection": {
        "qoeDataDetails": {
          "bitrate": 3200
        },
        "sessionID": "{sid}",
        "playhead": 90
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase la velocidad de bits como primer argumento a ADB.Media.createQoEObject y actualice el rastreador:

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(
  3200,  // bitrate (kbps)
  0,     // startup time (ms)
  24,    // fps
  0      // dropped frames
);

tracker.updateQoEObject(qoeObject);
Chromecast

Pase la velocidad de bits en kbps como primer argumento a ADBMobile.media.createQoSObject y actualice el rastreador:

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

Incluir media.qoe.bitrate en el objeto params de su solicitud POST de bitrateChange:

code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523820000 },
  "eventType": "bitrateChange",
  "params": {
    "media.qoe.bitrate": 3200
  }
}

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

recommendation-more-help
media-analytics-help