DocumentazioneAnalyticsGuida ai servizi Streaming Media

Bitrate

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile Bitrate. Vedere Average bitrate (dimensione) e Average bitrate (metrica) per le variabili di reporting corrispondenti.

style
shade-box

La variabile bitrate è il bitrate di riproduzione corrente, espresso in kilobit al secondo. Impostatelo sull’oggetto QoE ogni volta che il lettore negozia un bitrate, e aggiornate l’oggetto QoE quando il bitrate cambia. Il back-end utilizza i valori del bitrate per calcolare Average bitrate, la dimensione del bucket per bitrate e la metrica Bitrate changes.

Proprietà
Valore
Variabile di dati di contesto
a.media.qoe.bitrateAverageBucket
Campo raccolta XDM
xdm.mediaCollection.qoeDataDetails.bitrate
Caratteristica Audience Manager
c_contextdata.a.media.qoe.bitrateAverageBucket
Obbligatorio
No
Inviato con
Eventi di qualità (modifica bitrate, avvio buffer, errore), chiusura sessione

Tipi di implementazione consigliati

Web SDK

Imposta bitrate all’interno di xdm.mediaCollection.qoeDataDetails il media.bitrateChange (o qualsiasi evento relativo alla qualità) durante la chiamata 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

Passa il bitrate come primo argomento a createQoEObject. Aggiorna l’oggetto QoE sul tracciatore prima che venga attivato qualsiasi evento di qualità.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Passa il bitrate come primo argomento a createQoEObject. Aggiorna l’oggetto QoE sul tracciatore prima che venga attivato qualsiasi evento di qualità.

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

tracker.updateQoEObject(qoeObject)
Roku

Impostare bitrate all’interno di xdm.mediaCollection.qoeDataDetails quando si chiama sendMediaEvent per eventi di qualità come 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 Media Edge

Chiama l’endpoint bitrateChange con bitrate all’interno di xdm.mediaCollection.qoeDataDetails:

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

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passa il bitrate come primo argomento a ADB.Media.createQoEObject e aggiorna il tracker:

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

tracker.updateQoEObject(qoeObject);
Chromecast

Passa il bitrate in kbps come primo argomento a ADBMobile.media.createQoSObject e aggiorna il tracciatore:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate (kbps)
  0,     // startupTime
  24,    // fps
  0      // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
API Media Collection

Includi media.qoe.bitrate nell’oggetto params della richiesta POST bitrateChange:

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

Per la struttura completa delle richieste, consulta il Riferimento eventi API di Media Collection.

recommendation-more-help
media-analytics-help