DocumentationAnalyticsGuide des services des médias en streaming

Nom du lecteur de contenu

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page couvre la collecte de données pour la variable Content Player name. Voir Nom du lecteur de contenu pour la dimension de compte rendu des performances correspondante.

style
shade-box

La variable de nom du lecteur de contenu identifie le lecteur qui a rendu le contenu (par exemple, HTML5 Player, Brightcove ou Roku Player). Elle est requise pour toutes les implémentations de streaming multimédia et doit être définie au début de la session. La valeur est utilisée dans la dimension Nom du lecteur de contenu pour comparer l’engagement et la qualité entre les lecteurs dans la même propriété.

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

Types d’implémentation recommandés

SDK Web

playerName à 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

Définissez le nom du lecteur via la configuration du dispositif de suivi lors de la création du dispositif de suivi, à l’aide de MediaConstants.TrackerConfig.PLAYER_NAME. Le nom du lecteur ne fait pas partie de l’objet média.

code language-swift 
var config: [String: Any] = [:]
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"

Media.createTrackerWith(config: config) { tracker in
    self.tracker = tracker
}
Android

Définissez le nom du lecteur via la configuration du dispositif de suivi lors de la création du dispositif de suivi, à l’aide de MediaConstants.TrackerConfig.PLAYER_NAME. Le nom du lecteur ne fait pas partie de l’objet média.

code language-kotlin 
val config = HashMap<String, Any>()
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"

val tracker = Media.createTracker(config)
Roku

playerName à 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",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "playhead": 0
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionStart avec playerName à 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

Définissez le nom du lecteur sur ADB.MediaConfig avant de créer le dispositif de suivi :

code language-javascript 
var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "your.tracking.server";
mediaConfig.playerName = "HTML5 Player";
mediaConfig.channel = "Sports";

var tracker = ADB.Media.getInstance(mediaConfig);
Chromecast

Transmettez le nom du lecteur en tant que clé de métadonnées standard lors de l’appel de trackSessionStart :

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var metadata = { "a.media.playerName": "Chromecast Player" };
ADBMobile.media.trackSessionStart(mediaInfo, metadata);
API Media Collection

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

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.playerName": "HTML5 Player"
  }
}

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