DocumentationAnalyticsGuide des services des médias en streaming

Reprises du contenu

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Content resumes. Voir Reprises du contenu pour la mesure de création de rapports correspondante.

style
shade-box

La variable de reprise du contenu marque une session qui reprend une lecture précédemment interrompue. Définissez-le sur media.sessionStart afin que le serveur principal compte un événement Content resumes pour la session et l’exclut des nouveaux comptes de flux. Pour les implémentations directes d’API et d’API Edge, le client est chargé de détecter les sessions reprises (par exemple, après une mise en mémoire tampon, une pause ou un blocage dépassant 30 minutes) et de définir cet indicateur en conséquence.

Propriété
Valeur
Variable de données contextuelles
a.media.resume
champ de collection XDM
xdm.mediaCollection.sessionDetails.hasResume
Caractéristique
S.O.
Obligatoire
Non
Envoyé avec
Début de la session

Types d’implémentation recommandés

SDK Web

Définissez hasResume sur true dans xdm.mediaCollection.sessionDetails lors de l’appel de sendEvent pour la reprise de session :

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",
        hasResume: true
      },
      playhead: 60
    }
  }
});
iOS

Transmettez l’indicateur de reprise dans le cadre du lot de configuration facultatif de l’objet média sur trackSessionStart. Utilisez la clé MediaConstants.MediaObjectKey.RESUMED .

code language-swift 
var mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)
mediaObject?[MediaConstants.MediaObjectKey.RESUMED] = true

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

Transmettez l’indicateur de reprise dans le cadre du lot de configuration facultatif de l’objet média sur trackSessionStart. Utilisez la clé MediaConstants.MediaObjectKey.RESUMED .

code language-kotlin 
val mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)
mediaInfo[MediaConstants.MediaObjectKey.RESUMED] = true

tracker.trackSessionStart(mediaInfo, null)
Roku

Définissez hasResume sur true dans xdm.mediaCollection.sessionDetails lors de l’appel de createMediaSession pour la reprise de session :

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",
                "hasResume": true
            },
            "playhead": 60
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionStart avec hasResume défini sur true dans 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",
          "hasResume": true
        },
        "playhead": 60
      }
    }
  }]
}

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

Media SDK JS 3.x

Définissez la clé RESUMED sur l’objet d’informations sur le média avant d’appeler trackSessionStart :

code language-javascript 
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);
mediaInfo[ADB.Media.MediaObjectKey.Resumed] = true;

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Définissez MediaResumed sur l’objet d’informations sur le média avant d’appeler trackSessionStart :

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

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

code language-json 
{
  "playerTime": { "playhead": 60, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.resume": true
  }
}

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