DocumentationAnalyticsGuide des services des médias en streaming

Classement du contenu

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Évaluation du contenu. Voir Évaluation du contenu pour la dimension de compte rendu des performances correspondante.

style
shade-box

La variable d’évaluation du contenu est l’évaluation de l’audience telle que définie par les directives parentales de TV ("TVY", "TVG", "TVPG", "TVMA") ou tout système d’évaluation régional que vous utilisez. Utilisez-le pour comparer l’engagement et la charge publicitaire entre les niveaux d’évaluation.

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

Types d’implémentation recommandés

SDK Web

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

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

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

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.RATING] = "TVPG"

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

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

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

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Utilisez createMediaSession pour définir des rating dans sessionDetails :

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

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

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

Media SDK JS 3.x

Transmettez l’évaluation dans l’objet contextData à l’aide de ADB.Media.VideoMetadataKeys.Rating :

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

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Utilisez ADBMobile.media.VideoMetadataKeys.RATING pour définir l’évaluation du contenu 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.RATING] = "TVPG";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

Incluez media.rating dans l’objet params :

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

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