DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Taxa de bits

Última atualização: 29 de maio de 2026

Criado para:

  • Developer

Esta página aborda a coleta de dados da variável Taxa de bits. Consulte Taxa média de bits (dimensão) e Taxa média de bits (métrica) para as variáveis de relatório correspondentes.

style
shade-box

A variável bitrate é a taxa de bits de reprodução atual, em kilobits por segundo. Defina-o no objeto de QoE sempre que o player negociar uma taxa de bits e atualize o objeto de QoE quando a taxa de bits mudar. A infraestrutura usa valores de taxa de bits para calcular a taxa de bits média, a dimensão por bloco de taxa de bits e a métrica alterações na taxa de bits.

Propriedade
Valor
Variável de dados de contexto
a.media.qoe.bitrateAverageBucket
Campo da coleção XDM
xdm.mediaCollection.qoeDataDetails.bitrate
Característica do Audience Manager
c_contextdata.a.media.qoe.bitrateAverageBucket
Obrigatório
Não
Enviado com
Eventos de qualidade (alteração na taxa de bits, início do buffer, erro), fechamento da sessão

Tipos de implementação recomendados

Web SDK

Defina bitrate dentro de xdm.mediaCollection.qoeDataDetails em media.bitrateChange (ou qualquer evento relacionado à qualidade) ao chamar 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

Transmita a taxa de bits como o primeiro argumento para createQoEObject. Atualize o objeto de QoE no rastreador antes de qualquer evento de qualidade ser acionado.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Transmita a taxa de bits como o primeiro argumento para createQoEObject. Atualize o objeto de QoE no rastreador antes de qualquer evento de qualidade ser acionado.

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

tracker.updateQoEObject(qoeObject)
Roku

Defina bitrate dentro de xdm.mediaCollection.qoeDataDetails ao chamar sendMediaEvent para eventos de qualidade 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 do Media Edge

Chame o ponto de extremidade bitrateChange com bitrate dentro de xdm.mediaCollection.qoeDataDetails:

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

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Passe a taxa de bits como primeiro argumento para ADB.Media.createQoEObject e atualize o 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

Transmita a taxa de bits em kbps como o primeiro argumento para ADBMobile.media.createQoSObject e atualize o rastreador:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate (kbps)
  0,     // startupTime
  24,    // fps
  0      // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
API da coleção de mídia

Inclua media.qoe.bitrate no objeto params de sua solicitação POST bitrateChange:

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

Consulte a Referência de eventos da API Media Collection para obter a estrutura de solicitação completa.

recommendation-more-help
media-analytics-help