DocumentationAnalyticsGuide des services des médias en streaming

Durée du contenu

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Longueur du contenu. Voir Longueur du contenu pour la dimension de reporting correspondante.

style
shade-box

La variable de longueur du contenu correspond à la durée totale du contenu, en secondes. Elle est requise pour toutes les implémentations de streaming multimédia et doit être définie au début de la session. La longueur du contenu génère plusieurs mesures calculées en arrière-plan, y compris les marqueurs de progression (10/25/50/75/95 %) et l’audience moyenne par minute. Si la longueur du contenu n’est pas définie ou est inférieure à zéro, ces mesures ne sont pas générées. Pour les flux en direct d’une durée inconnue, utilisez 86400 (24 heures).

Propriété
Valeur
Variable de données contextuelles
a.media.length
champ de collection XDM
xdm.mediaCollection.sessionDetails.length
Caractéristique
c_contextdata.a.media.length
Obligatoire
Oui
Envoyé avec
Début de session, fermeture de session

Types d’implémentation recommandés

SDK Web

length à l’intérieur des xdm.mediaCollection.sessionDetails 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"
      },
      playhead: 0
    }
  }
});
iOS

Transmettez la longueur du contenu en secondes comme argument de length à createMediaObject.

code language-swift 
let mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)

tracker.trackSessionStart(info: mediaObject, metadata: nil)
Android

Transmettez la longueur du contenu en secondes comme argument de length à createMediaObject.

code language-kotlin 
var mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)

tracker.trackSessionStart(mediaInfo, null)
Roku

length à l’intérieur des xdm.mediaCollection.sessionDetails lors de l’appel de createMediaSession :

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "friendlyName": "My Video",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionStart avec length à l’intérieur du xdm.mediaCollection.sessionDetails :

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports"
        },
        "playhead": 0
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez la longueur du contenu en secondes comme troisième argument à ADB.Media.createMediaObject :

code language-javascript 
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",
  "video-123",
  128,                      // length in seconds
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Transmettez la longueur du contenu en secondes comme troisième argument à ADBMobile.media.createMediaObject :

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADBMobile.media.StreamType.VOD,
  ADBMobile.media.MediaType.Video
);
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

Incluez media.length dans l’objet params de votre sessionStart requête POST :

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.length": 128
  }
}

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