DocumentazioneAnalyticsGuida ai servizi Streaming Media

Fotogrammi al secondo

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

La variabile frame al secondo corrisponde al frame rate corrente del flusso. Impostatelo sull’oggetto QoE insieme al bitrate e ai fotogrammi saltati in modo che il backend abbia un contesto di qualità completa per ogni sessione di riproduzione. Adobe Analytics non crea automaticamente una variabile di reporting per il frame rate; crea una regola di elaborazione personalizzata se desideri che venga visualizzata come un rapporto.

Proprietà
Valore
Variabile di dati di contesto
Nessuno (Adobe Analytics non assegna una chiave di dati contestuali riservata per il frame rate)
Campo raccolta XDM
xdm.mediaCollection.qoeDataDetails.framesPerSecond
Caratteristica Audience Manager
N/D
Obbligatorio
No
Inviato con
Eventi di qualità (modifica bitrate, avvio buffer, errore), chiusura sessione

Tipi di implementazione consigliati

Web SDK

Imposta framesPerSecond all’interno di xdm.mediaCollection.qoeDataDetails quando chiama sendEvent:

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

Passa la frequenza fotogrammi come terzo argomento (fps) a createQoEObject.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Passa la frequenza fotogrammi come terzo argomento (fps) a createQoEObject.

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

tracker.updateQoEObject(qoeObject)
Roku

Imposta framesPerSecond in xdm.mediaCollection.qoeDataDetails quando chiama sendMediaEvent:

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

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

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

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passa la frequenza fotogrammi come terzo argomento a ADB.Media.createQoEObject:

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

Passa la frequenza fotogrammi come terzo argomento (fps) a ADBMobile.media.createQoSObject e aggiorna il tracciatore:

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

Includi media.qoe.framesPerSecond nell’oggetto params:

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

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

recommendation-more-help
media-analytics-help