Canal de contenu

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

La variable de canal de contenu identifie la station de distribution, le réseau ou la propriété où le contenu est lu. Elle est requise pour toutes les implémentations de streaming multimédia. Toute chaîne est acceptée. Les valeurs standard incluent un nom de réseau, une partie d’un chemin d’accès au site ou un identifiant de propriété interne.

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

Types d’implémentation recommandés

SDK Web

channel à 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 canal via la configuration du dispositif de suivi lors de la création du dispositif de suivi, à l’aide de MediaConstants.TrackerConfig.CHANNEL. Le canal 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 canal via la configuration du dispositif de suivi lors de la création du dispositif de suivi, à l’aide de MediaConstants.TrackerConfig.CHANNEL. Le canal 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

channel à 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 channel à 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 canal 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 channel comme 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.channel": "Sports" };
ADBMobile.media.trackSessionStart(mediaInfo, metadata);
API Media Collection

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

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

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