DocumentationAnalyticsGuide des services des médias en streaming

Saison

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Season. Voir Saison pour la dimension de reporting correspondante.

style
shade-box

La variable season est le numéro de saison de l’émission (généralement un entier de chaîne comme "2"). Définissez-le pour le contenu faisant partie d’une série afin que l’engagement puisse être divisé par saison. Associez avec Show et Episode pour obtenir un contexte épisodique complet.

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

Types d’implémentation recommandés

SDK Web

season à l’intérieur des xdm.mediaCollection.sessionDetails lors de l’appel de sendEvent :

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        season: "2"
      },
      playhead: 0
    }
  }
});
iOS

Transmettez la saison en tant que clé de métadonnées dans l’argument HashMap à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.SEASON.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.SEASON] = "2"

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

Transmettez la saison en tant que clé de métadonnées dans l’argument HashMap à trackSessionStart. Utilisez MediaConstants.VideoMetadataKeys.SEASON.

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.SEASON] = "2"

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Utilisez createMediaSession pour définir des season dans sessionDetails :

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "season": "2"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionStart avec season à 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",
          "season": "2"
        },
        "playhead": 0
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez la saison dans l’objet contextData à l’aide de ADB.Media.VideoMetadataKeys.Season :

code language-javascript 
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.Season] = "2";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Utilisez ADBMobile.media.VideoMetadataKeys.SEASON pour définir le numéro de saison dans la propriété StandardMediaMetadata de l’objet 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);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.SEASON] = "2";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

Incluez media.season dans l’objet params :

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

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