DocumentationAnalyticsGuide des services des médias en streaming

Heure de début

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Time to start. Voir Heure de début pour la dimension et la mesure de reporting correspondantes.

style
shade-box

La variable time to start correspond au temps écoulé, en millisecondes, entre le lancement de la lecture par le lecteur et le premier rendu d’image. Définissez-le sur l’objet QoE avant que l’événement de début de session ne se déclenche. Adobe stocke et signale la valeur en secondes ; transmettez les millisecondes et Adobe convertit au moment de l’ingestion.

IMPORTANT
Une fois que le lecteur commence à effectuer le rendu des images de contenu, arrêtez la mise à jour timeToStart. Cette valeur peut augmenter au cours de la phase de mise en mémoire tampon ou de chargement initiale, mais doit être considérée comme fixe dès le début de la lecture. Si vous continuez à la mettre à jour après le rendu de la première image, une mesure Heure de début exagérée ou incorrecte est générée.
Propriété
Valeur
Variable de données contextuelles
a.media.qoe.timeToStart
champ de collection XDM
xdm.mediaCollection.qoeDataDetails.timeToStart
Caractéristique
c_contextdata.a.media.qoe.timeToStart
Obligatoire
Non
Envoyé avec
Début de session, fermeture de session

Types d’implémentation recommandés

SDK Web

Définissez timeToStart à l’intérieur du xdm.mediaCollection.qoeDataDetails sur media.sessionStart lors de l’appel de 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

Transmettez l’heure de démarrage comme deuxième argument (startupTime) à createQoEObject.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Transmettez l’heure de démarrage comme deuxième argument (startupTime) à createQoEObject.

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

tracker.updateQoEObject(qoeObject)
Roku

Définissez timeToStart à l’intérieur du xdm.mediaCollection.qoeDataDetails sur media.sessionStart lors de l’appel de 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

Appelez le point d’entrée sessionStart avec timeToStart à l’intérieur du 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
      }
    }
  }]
}

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Transmettez l’heure de début comme deuxième argument à ADB.Media.createQoEObject :

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

Transmettez l’heure de démarrage en millisecondes comme deuxième argument (startupTime) pour ADBMobile.media.createQoSObject et mettre à jour le dispositif de suivi :

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

Incluez media.qoe.timeToStart dans l’objet params sur sessionStart :

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

Consultez la référence des sessions de l’API Media Collection pour obtenir la structure complète des requêtes.

recommendation-more-help
media-analytics-help