DocumentazioneAnalyticsGuida ai servizi Streaming Media

Tempo di avvio

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile Time to start. Vedere Time to start per la dimensione e la metrica di reporting corrispondenti.

style
shade-box

La variabile “time to start” è il tempo trascorso, in millisecondi, tra l’avvio della riproduzione da parte del lettore e il rendering del primo fotogramma. Impostatelo sull’oggetto QoE prima che venga attivato l’evento di inizio sessione. Adobe memorizza e segnala il valore in secondi, passa millisecondi e Adobe converte al momento dell’acquisizione.

IMPORTANT
Una volta che il lettore inizia il rendering dei fotogrammi di contenuto, interrompi l'aggiornamento di timeToStart. Il valore può aumentare durante la fase di buffering iniziale o di caricamento, ma deve essere trattato come fisso nel momento in cui inizia la riproduzione. Continuando ad aggiornarla dopo il rendering del primo fotogramma, si produce una metrica Time to start gonfiata o errata.
Proprietà
Valore
Variabile di dati di contesto
a.media.qoe.timeToStart
Campo raccolta XDM
xdm.mediaCollection.qoeDataDetails.timeToStart
Caratteristica Audience Manager
c_contextdata.a.media.qoe.timeToStart
Obbligatorio
No
Inviato con
Inizio sessione, chiusura sessione

Tipi di implementazione consigliati

Web SDK

Imposta timeToStart all’interno di xdm.mediaCollection.qoeDataDetails su media.sessionStart quando chiama 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

Passa l’ora di avvio come secondo argomento (startupTime) a createQoEObject.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Passa l’ora di avvio come secondo argomento (startupTime) a createQoEObject.

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

tracker.updateQoEObject(qoeObject)
Roku

Imposta timeToStart all’interno di xdm.mediaCollection.qoeDataDetails su media.sessionStart durante la chiamata 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 Media Edge

Chiama l’endpoint sessionStart con timeToStart in 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
      }
    }
  }]
}

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passare il tempo per iniziare come secondo argomento a ADB.Media.createQoEObject:

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

Passare il tempo di avvio in millisecondi come secondo argomento (startupTime) a ADBMobile.media.createQoSObject e aggiornare il tracker:

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

Includi media.qoe.timeToStart nell’oggetto params in sessionStart:

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

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

recommendation-more-help
media-analytics-help